Reference
Limits and headers
What one key can ask for, and the headers that tell you where you stand.
60
requests per minute, per key
93
days at most per report
1,000
rows at most per page
100,000
rows at most in one CSV file
3
reports built at the same time, per key
Over a limit, the API answers 429 rate_limited with a Retry-After header. Only building a report counts as one of the reports at the same time: a whole CSV, or the first page of a read. The next pages of that read don't count.
Response headers
- X-Request-Id: quote it when asking for help with a request.
- X-RateLimit-Limit and X-RateLimit-Remaining: your budget for this minute.
- X-Total-Count and X-Next-Cursor: the number of rows, and the next page when the response is paged.