The limits
- 600 requests per minute per key.
- 600 requests per minute per IP, counted across every API-key request from that address.
When you exceed it
You get429 Too Many Requests with the standard error envelope:
Handling it
- Back off and retry after a short delay — exponential backoff with jitter is ideal.
- Prefer bigger pages over more requests —
page_sizeup to 100 on most list endpoints — instead of fanning out parallel calls. - Cache what doesn’t change per minute. Brand and topic lists rarely move; metric windows only shift as new runs land.
- If you legitimately need a higher limit, get in touch — don’t work around it by rotating keys or IPs.
The MCP server forwards your key upstream unchanged, so its
calls count against the same per-key budget as your own integrations.

