Get item

One item with all its fields, tags, collections and child notes.

GET https://cotlet.dev/api/v1/zotero/item

read

Returns the full metadata of one item as Zotero stores it, the keys of the collections it is in, its tags, and the child notes with their text. PDF attachments are listed by name, not downloaded.

Parameters

Parameters: get_item
NameTypeDescription
library string string 'me' for My Library (default) or a group library ID from list_libraries.
item_key string required string Item key from search_items, 8 characters.

Request

cURL
curl "https://cotlet.dev/api/v1/zotero/item?item_key=item+key" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("zotero", "get_item", {"item_key":"item key"})
Node.js
const result = await cotlet.call('zotero', 'get_item', {"item_key":"item key"});
CLI
cotlet call zotero get_item --data '{"item_key":"item key"}'

Example response

JSON

{
  "item_key": "H6R2VB5D",
  "item_type": "journalArticle",
  "title": "Sparse attention for long documents",
  "creators": [
    "Lee, M.",
    "Okafor, T."
  ],
  "date": "2025",
  "doi": "10.1234/example.2026.001",
  "tags": [
    "transformers"
  ],
  "collections": [
    "C4T8WZ2N"
  ],
  "notes": [
    {
      "note_key": "T3P6YK8R",
      "text": "Read in October, check the evaluation setup."
    }
  ],
  "attachments": [
    "Lee and Okafor - 2025 - Sparse attention for long documents.pdf"
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.