Authentication and Rate Limits

All API calls must be authenticated with an API key. Passing an API key simply requires passing it in the URL as a parameter (ie. appending &api_key=YOUR_API_KEY). If you do not pass an API key, or an invalid key, you will receive a 401 HTTP status code.

Rate Limits

All API keys come with a rate limit. We have 2 rate limits: the maximum # of calls you can make in any 10 second timeframe, and the maximum # of calls you can make in a calendar month.

These rate limits will appear in your response headers as follows:

X-RateLimit-Reset: The Unix epoch time at which the rate limit for the 10 second time frame expires.

X-RateLimit-Limit: The maximum number of calls you can make in any 10 second time frame.

X-RateLimit-Month-Remaining: The number of remaining calls you can make in the current calendar month. This resets in the 1st of every month (midnight EST)

X-RateLimit-Remaining: The number of remaining calls you can make in the current 10 second time frame.

If you need higher rate limits, or need to make more calls, please contact your account manager and we can arrange to have you in a higher API plan.