Authentication, Rate Limits and Checking Current Usage

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.

A free API key with limited credits to test out our API can be requested by filling out this form

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 your trial or current billing period.

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-Credits-Month-Remaining: The number of remaining credits you can make during your trial or current billing period. If you're a paid customer, this resets at the start of your next billing period.

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

x-num-company-enrichment-results-month: The number of company enrichment results you retrieved so far in your trial or current billing period.

x-num-signals-results-month: The number of tech stack changes you retrieved so far in your trial or current billing period.

x-num-technographics-results-month: The number of tech stack customers you retrieved so far in your trial or current billing period.

x-num-job-postings-results-month: The number of job postings you retrieved so far in your trial or current billing period.

If you need higher rate limits, or need to make more calls during your trial, please contact us at [email protected] and we can arrange to have a larger-scale trial for you.