Response Headers:
Rate Limiting
According to your plan, you are limited to a certain amount of requests per hour and day to any of the API endpoints. You can check the returned HTTP headers to see get your current rate limit status.
When surpassing your rate-limiting you will get a response with a 429 error code.
Getting the remaining rate-limits in the header is currently available only for Enterprise accounts:
| Headers | Description |
|---|---|
X-RateLimit-Limit-secondX-RateLimit-Limit-dayX-RateLimit-Limit-hour | The maximum number of requests that the API key is permitted to make per second/day/hour. |
X-RateLimit-Remaining-secondX-RateLimit-Remaining-dayX-RateLimit-Remaining-hour | The number of requests remaining in the current rate limit window. |
*If you need a higher rate limit, please reach out to [email protected].
Tokens
For Customers that are using the API through the token system, they will see the following headers in the response where {product} is the relevant product that they request deducted tokens from.
| Header | Description |
|---|---|
| X-Tokens-Cost-{product} | The number of tokens the following {product} (i.e historical) request cost. |
| X-Tokens-Remaining-{product} | The number of tokens remaining for the specific {product} |
{product} that are supported:
- historical
- eventsTimeline