Defaults & Limits

Defaults

$top

• $top is defaulted to 100 records when no $top is specified in a query

Limits

$top and $skip

• $top is limited to 10,000 records
• $skip is limited to 100,000 records

Rate Limit

AMP Syndication imposes a rate limit of 60,000 requests per minute, per vendor account.

Status Code

The HTTP 429 status code, also known as "Too Many Requests", is an HTTP status code that is used to indicate that the client has made too many requests within a specified time window. This code is accompanied by the X-Rate-Limit-Retry-After-Seconds header, which communicates the time the client needs to wait before making another request. The purpose of the HTTP 429 response code is to protect the server from being overloaded by excessive requests and to prevent abuse or misuse of the API. When a client receives a 429 response, it should take the necessary action, such as reducing the rate of requests or waiting until the time specified in the X-Rate-Limit-Retry-After-Seconds header, before making another request.

Response Headers

The X-Rate-Limit-Remaining and X-Rate-Limit-Retry-After-Seconds are HTTP response headers used by AMP Syndication to communicate rate limiting information to clients.

X-Rate-Limit-Remaining is included in most responses and indicates the number of remaining requests that can be made within the current rate limit window. This information can be used by clients to regulate the rate of requests and prevent reaching the limit and receiving error responses.

X-Rate-Limit-Retry-After-Seconds is used in cases where the rate limit has been exceeded, and it tells the client the number of seconds it needs to wait before it can make another request.