Reference
API reference
The complete API reference lives at the developers page.
Why it is there and not here
That page is generated from the live API specification, with request and response shapes, per-language code samples and an OpenAPI document you can point tooling at. It is correct by construction and always current.
Restating it here would create a second copy that goes stale, which is exactly the failure these docs are built to avoid.
What these docs cover instead
| Page | Covers |
|---|---|
| The API | What it is for and when to reach for it |
| API keys and scopes | Creating a key and what each scope allows |
| MCP | Connecting Claude or ChatGPT |
| Zapier, Pipedream, IFTTT | Automation without writing code |
Quick facts
- REST, JSON over HTTPS, authenticated with a personal API key
- Scopes for reading and writing lists and things, plus search
- 1000 requests an hour per key
- An OpenAPI document is served for tooling
- An MCP endpoint exists for AI assistants, with OAuth