GET is safe to retry. The facts endpoints that add, change or remove facts need the write:facts scope; send an Idempotency-Key header when you add facts so a retry is safe. See Retry writes safely.
The API calls a brand a project. A project id is the id of a brand in your workspace, and
project_id in a path means “this brand”.Base URL
application/json), and errors are JSON problem documents (application/problem+json).
The machine-readable contract is an OpenAPI 3.1 document. It’s public and needs no key:
What you can call
Each key is granted one or more scopes. An endpoint answers only when the key holds the scope it needs.
The same keys also work with the MCP server, which exposes this data as tools for AI assistants. Three scopes apply only there:
read:agents, read:tables and run:agents. See Scopes. To be told when something happens instead of polling, use webhooks.
Conventions at a glance
Next steps
Quickstart
Create a key and make your first three calls in five minutes.
Authentication
Key format, scopes, brand allowlists, expiry and revocation.
Cookbook
Runnable recipes: trend charts, cited-domain rankings, CSV exports and Slack alerts.