The API is rate-limited to 150000 requests every 900 seconds. All requests count towards the total. Every request processed by the API returns rate limiting information in the HTTP headers.
Rate Limiting - Example 1
$ curl -i https://api.exoclick.com/v1/statistics/advertiser/date
{
"HTTP/1.1": "200 OK",
"Date": "Fri, 24 Oct 2014 14:57:32 GMT",
"Content-Type": "application/json",
"Transfer-Encoding": "chunked",
"X-Rate-Limit-Limit": 150000,
"X-Rate-Limit-Remaining": 149994,
"X-Rate-Limit-Reset": 27
}
When the rate limit is exceeded a 429 Too Many Requests HTTP error will be thrown by any subsequent requests until the rate limit is reset. As with a normal request the rate limiting information will be available in the HTTP headers.
Rate Limiting - Example 2 (Limit Exceeded)
$ curl -i https://api.exoclick.com/v1/statistics/advertiser/date
{
"HTTP/1.1": "429 Too Many Requests",
"Date": "Fri, 24 Oct 2014 15:04:35 GMT",
"Content-Type": "application/json",
"Transfer-Encoding": "chunked",
"X-Rate-Limit-Limit": 150000,
"X-Rate-Limit-Remaining": 0,
"X-Rate-Limit-Reset": 12
}