Rate limits

Some endpoints are rate-limited to ensure fair usage and maintain optimal performance for all users.

Rate-limited endpoints

The following endpoints have rate limits that vary by subscription plan and endpoint. The table below shows the number of requests allowed per rate limit window, which is one day (24 hours):

📘

Note

  • The Text-to-video search and Any-to-video search endpoints share a rate limit counter, which increments on each request to either endpoint.

Exceeding rate limits

If you exceed the rate limit for a specific endpoint, the API returns an HTTP 429 - Too many requests error response.

Upgrade your plan

After signing up, you are automatically assigned the Free plan. If your needs exceed the Free plan, consider upgrading to the Developer plan.

Headers

The headers in each response provide information about your rate limits:

  • X-Ratelimit-Limit: The maximum number of requests you can make per rate limit window for the specific endpoint. This value depends on your plan and the endpoint, as shown in the table above.
  • X-Ratelimit-Remaining: The number of requests remaining in the current rate limit window for the specific endpoint. This value decreases with each request you make to that endpoint and resets at the start of the next rate limit window.
  • X-Ratelimit-Used: The number of requests you have made in the current rate limit window for the specific endpoint. This value increases with each request you make to that endpoint and resets to zero at the start of the next rate limit window.
  • X-Ratelimit-Reset: The time at which the current rate limit window resets, expressed in UTC epoch seconds. After this time, the values of the X-Ratelimit-Remaining and X-Ratelimit-Used parameters will be reset to their initial values for the next rate limit window.