Skip to main content

API Rate Limits

This document outlines the rate limits for different AddSearch APIs.

Search and Suggestions APIs​

  • Limit: 5 requests per second per single IP address.
  • No overall request or volume limit across multiple IP addresses.

Recommendation: When implementing a search-as-you-type feature, add at least a 200ms delay between requests to avoid hitting rate limits.

Indexing API​

  • Limit: 5 requests per second per single IP address.
  • Request payload size must not exceed 1 MB.

Crawl API​

  • Rate limits are tracked over rolling 15-minute windows.

Rate Limit Headers​

API responses subject to rate limits include the following HTTP headers to inform you about your current usage:

HeaderDescription
X-Rate-Limit-LimitMaximum requests allowed in the current window
X-Rate-Limit-RemainingRemaining requests available in the current window
X-Rate-Limit-ResetTimestamp when the usage count resets (Unix epoch seconds)

Example:

X-Rate-Limit-Limit: 100
X-Rate-Limit-Remaining: 97
X-Rate-Limit-Reset: 1422615270

For more information on Unix time used in the reset header, see Unix time.