https://www.zotero.org/support/ 2026-05-02T01:01:19+00:00 https://www.zotero.org/support/ https://www.zotero.org/support/lib/tpl/zotero-theme/images/favicon.ico text/html 2025-09-24T18:27:26+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.zotero.org/support/dev/web_api/v3/basics?rev=1758752846&do=diff Zotero Web API Documentation The page documents read requests available in the Zotero Web API, providing read-only access to online Zotero libraries. Base URL The base URL for all API requests is https://api.zotero.org All requests must use HTTPS. API Versioning text/html 2022-06-23T15:54:13+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.zotero.org/support/dev/web_api/v3/changes_from_v2?rev=1656014053&do=diff Changes in Zotero Web API v3 Version 3 of the Zotero Web API introduces a new all-JSON response format and various other changes. While API v3 is mostly backwards compatible, existing clients may need to make for full compatibility, depending on usage. * New default all-JSON response format, text/html 2026-03-16T22:27:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.zotero.org/support/dev/web_api/v3/file_upload?rev=1773714437&do=diff Zotero Web API File Uploads In addition to providing ways to read and write online library data, the Zotero Web API allows you to upload attachment files. The exact process depends on whether you are adding a new attachment file or modifying an existing one and whether you are performing a full upload or uploading a binary diff. text/html 2022-06-23T15:53:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.zotero.org/support/dev/web_api/v3/fulltext_content?rev=1656014032&do=diff Zotero Web API Full-Text Content Requests This page documents the methods to access full-text content of Zotero items via the Zotero Web API. See the Basics page for basic information on accessing the API, including possible HTTP status codes not listed here. Getting new full-text content text/html 2017-11-12T19:53:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.zotero.org/support/dev/web_api/v3/global_search?rev=1510534411&do=diff Zotero Web API Global Search The Zotero Web API provides an interface to search aggregated metadata from the full corpus of public items stored on zotero.org. Global search is currently in beta, with restricted public access. If you would like to test global search, you can email text/html 2017-11-27T04:04:44+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.zotero.org/support/dev/web_api/v3/oauth?rev=1511773484&do=diff OAuth Key Exchange In addition to users manually creating Zotero API keys from the zotero.org account settings, Zotero supports OAuth 1.0a for API key exchange. Registering Your Application In order to start using OAuth to create API keys on behalf of users, you must text/html 2022-06-23T22:02:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.zotero.org/support/dev/web_api/v3/start?rev=1656036155&do=diff Zotero Web API v3 This is the default version of the API, and it is recommended for new development. API Documentation * Basics * Item Types/Fields * Write Requests * File Uploads * Full-Text Content * Syncing * Streaming API * OAuth Authentication * Changes from API Version 2 Client Libraries Known client libraries for the Zotero API include: * <https://github.com/tnajdek/zotero-api-client> (JavaScript) text/html 2025-02-21T01:07:51+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.zotero.org/support/dev/web_api/v3/streaming_api?rev=1740118071&do=diff Zotero Streaming API The Zotero streaming API provides push-based notifications via WebSockets for Zotero library changes, allowing for nearly instantaneous updates when data changes in a library or when a user joins or leaves a library. Note that this text/html 2022-08-14T05:34:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.zotero.org/support/dev/web_api/v3/syncing?rev=1660469645&do=diff Zotero Web API Syncing This document outlines the recommended steps for synchronizing a Zotero Web API client with the Zotero server. Be sure you've read the write request documentation for basic information on modifying data via the API. TODO: * Incorporate WebSocket handling Sync Properties text/html 2017-11-12T19:53:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.zotero.org/support/dev/web_api/v3/translation?rev=1510534411&do=diff Zotero Web API Translator-Based Saving This is not currently the default version of the API. Include the Zotero-API-Version: 3 HTTP header or the v=3 query parameter to access this version. The Zotero Web API allows items to be created manually, but it can also automatically create items from uploaded URLs, similar to the one-click saving from web pages offered in the Zotero client. The server takes care of downloading the page, extracting metadata using Zotero translators, and creating a new … text/html 2019-12-07T18:46:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.zotero.org/support/dev/web_api/v3/types_and_fields?rev=1575762410&do=diff Zotero Web API Item Type/Field Requests For a Zotero Web API client to present an editing UI to its users, it must know what combinations of Zotero item types, fields, and creator types are valid. Clients can request this data from the Zotero API. As schema changes are currently rare, clients should cache type/field data for a period of time (e.g., one hour) without making further requests. Subsequent requests for new data should then include text/html 2024-10-10T02:10:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.zotero.org/support/dev/web_api/v3/write_requests?rev=1728540629&do=diff Zotero Web API Write Requests This page documents the write methods of the Zotero Web API. See the Basics page for basic information on accessing the API, including possible HTTP status codes not listed here. An API key with write access to a given library is necessary to use write methods.