The Media Analytics API imposes a rate-limiting constraint of 20 requests per minute. Exceeding that limit results in a 429-error response. Consider this especially when calling successive operations as part of a loop. The following response headers provide rate limit information:

  • X-RateLimit-Limit: 20 requests per minute.

  • X-RateLimit-Remaining: Number of remaining requests allowed during the current rate limit period.

  • X-RateLimit-Next: Indicates when the client may issue another request after having exhausted the number of allowed requests for the current rate limit time period. Date and time is represented in the ISO 8601 standard format. For example: 2018-05-11T07:04:40.004Z.

Once X-RateLimit-Remaining becomes 0, you get a 429 error the next time you make an API call.

If you do not make any more API calls after you receive a 429 error, X-RateLimit-Remaining gradually increases and becomes equal to X-RateLimit-Limit.