Rate Limiting

Rate limits are defined on a per-minute, per-key, per-endpoint basis. We use a fixed-window rate limiting strategy, so if your API key's rate limit is 5000 requests per minute, those 5000 api calls can be made at any interval within the 60 second window.

Rate limits for all of our API endpoints are separate, to figure out your rate limits you can access the API dashboard or use the headers in your API response (as explained below.

import requests

headers = {
    'X-api-key': #YOUR_API_KEY,
}
response = requests.head('https://api.peopledatalabs.com/v5/person/enrich', headers=headers).headers

curl -i -X GET \
  'https://api.peopledatalabs.com/v5/person/enrich' \
  -H 'X-Api-Key: xxxx'

HTTP/2 404 
date: Tue, 16 Jan 2018 17:38:18 GMT
content-type: application/json
content-length: 4731
server: nginx/1.11.13
x-totallimit-limit: 10000000
x-totallimit-remaining: 9723340
x-ratelimit-limit: 10000
x-ratelimit-remaining: 9999
x-ratelimit-reset: 1516124358
retry-after: 59

Header Name	Associated APIs	Description
`Retry-After`	`All`	The number of seconds left until the current rate limit window resets.
`X-RateLimit-Limit`	`All`	The maximum number of requests you're permitted to make per minute.
`X-RateLimit-Remaining`	`All`	DEPRECATED. Do not use. The number of requests remaining in the current rate limit window.
`X-RateLimit-Reset`	`All`	The time at which the current rate limit window resets in UTC epoch seconds.
`X-TotalLimit-Limit`	Person Enrichment API Bulk Person Enrichment API	The maximum number of API requests which return a 200 you're able to make.
`X-TotalLimit-Remaining`	Person Enrichment API Bulk Person Enrichment API	The number of API requests which return a 200 you have remaining.
`X-SearchLimit-Remaining`	Person Search API	The number of retrievable records from the Search API you have remaining.
`X-EnrichCompanyLimit-Remaining`	Company Enrichment API	The number of API requests which return a 200 you have remaining.

If your account has a limit on the number of 200 API calls you're able to make, once x-totallimit-remaining reaches 0, all succeeding api requests will return 403 errors, and once x-ratelimit-remaining reaches 0, all succeeding requests made will return 429 errors, until the current rate limit window resets. If you'd like to increase your account's x-totallimit-limit or x-ratelimit-limit, please contact your account manager or reach out to us at [email protected]

The API Dashboard

All accounts are given access to a dashboard which will allows you to manage your API keys, see usage, and test new endpoints (when available).