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

  • X-RateLimit-Limit. The total number of tokens allowed.

  • X-RateLimit-Remaining. The number of tokens remaining.

  • X-RateLimit-Next. The time when you can make one more request. 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.