|----------| | references/authentication.md | Credentials, library types, local mode | | references/read-api.md | Retrieving items, collections, tags, groups | | references/search-params.md | Filtering, sorting, search parameters | | references/write-api.md | Creating, updating, deleting items | | references/collections.md | Collection CRUD operations | | references/tags.md | Tag retrieval and management | | references/files-attachments.md | File retrieval and attachment uploads | | references/exports.md | BibTeX, CSL-JSON, bibliography export | | references/pagination.md | follow(), everything(), generators | | references/full-text.md | Full-text content indexing and retrieval | | references/saved-searches.md | Saved search management | | references/cli.md | Command-line interface usage | | references/error-handling.md | Errors and exception handling |
Common Patterns
Fetch and modify an item
item = zot.item('ITEMKEY')
item['data']['title'] = 'New Title'
zot.update_item(item)
Create an item from a template
template = zot.item_template('journalArticle')
template['title'] = 'My Paper'
template['creators'][0] = {'creatorType': 'author', 'firstName': 'Jane', 'lastName': 'Doe'}
zot.create_items([template])
Export as BibTeX
zot.add_parameters(format='bibtex')
bibtex = zot.top(limit=50)
# bibtex is a bibtexparser BibDatabase object
print(bibtex.entries)
Local mode (read-only, no API key needed)
zot = Zotero(library_id='123456', library_type='user', local=True)
items = zot.items()