pyzotero

# Pyzotero Pyzotero is a Python wrapper for the [Zotero API v3](https://www.zotero.org/support/dev/web_api/v3/start). Use it to programmatically manage Zotero libraries: read items and collections, create and update references, upload attachments, manage tags, and export citations. ## Authentication Setup **Required credentials** — get from https://www.zotero.org/settings/keys: - **User ID**: shown as "Your userID for use in API calls" - **API Key**: create at https://www.zotero.org/settings/keys/new - **Library ID**: for group libraries, the integer after `/groups/` in the group URL Store credentials in environment variables or a `.env` file: ``` ZOTERO_LIBRARY_ID=your_user_id ZOTERO_API_KEY=your_api_key ZOTERO_LIBRARY_TYPE=user # or "group" ``` See [references/authentication.md](references/authentication.md) for full setup details. ## Installation ```bash uv add pyzotero # or with CLI support: uv add "pyzotero[cli]" ``` ## Quick Start ```python from pyzotero import Zotero zot = Zotero(library_id='123456', library_type='user', api_key='ABC1234XYZ') # Retrieve top-level items (returns 100 by default) items = zot.top(limit=10) for item in items: print(item['data']['title'], item['data']['itemType']) # Search by keyword results = zot.items(q='machine learning', limit=20) # Retrieve all items (use everything() for complete results) all_items = zot.everything(zot.items()) ``` ## Core Concepts - A `Zotero` instance is bound to a single library (user or group). ...