---
title: "Usage limits"
slug: "usage-limits"
updated: 2026-05-19T06:31:49Z
published: 2026-05-19T06:31:49Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage limits

There are some limitations in using the Supermetrics API, both technical and specifically based on your license.

- [API rate limiting](/apidocs/usage-limits#api-rate-limiting)
- [Query concurrency limits](/apidocs/usage-limits#query-concurrency-limits)
- [Data source limits](/apidocs/usage-limits#data-source-limits)
- [License limits](/apidocs/usage-limits#license-limits)
- [Best practices](/apidocs/usage-limits#best-practices)

## API rate limiting

Supermetrics API enforces per-second rate limits depending on a variety of factors, including license and IP address. In general, our rate limits should be permissive enough to accomplish most tasks. We suggest that you limit your requests to *20 requests per second*.

These limits include all requests to Supermetrics API. When you are making too many requests, and the rate limit has been exceeded, response code **429** will be returned.

`429 Too Many Requests`

Please be aware: Supermetrics reserves the right to change rate limits in the future without prior notice to ensure the health and stability of the Supermetrics API.

## Query concurrency limits

Supermetrics API executes all data source queries with restricted, license-specific concurrency. This means your queries will be placed in a queue instead of being resolved immediately. The queue will be emptied a few queries at a time in the order they were received, with a limited concurrency defined by your license.

In addition, if you perform duplicate identical queries at the same time, only the first request will perform the query. Other requests will wait for the first request to finish. The maximum number of duplicate waiting requests is currently **10**.

Please [contact us](/v1-api/apidocs/support) for any changes to these limits for your license.

## Data source limits

Data source API providers also have limits on how much and how fast data can be retrieved.

We do our best to accommodate your queries, but some limitations are beyond our control. Please see our support documentation for known [daily delivery quotas](/v1/docs/about-daily-request-quotas-and-limits) and verify that your data needs are within these restrictions.

We would be happy to [help](/v1-api/apidocs/support) you with related questions.

## Subscription limits

The default limits applied to the Supermetrics API subscription packages can be found on our [pricing page](https://supermetrics.com/pricing). All limits are subject to change in accordance with our [Terms of Service](https://supermetrics.com/terms-of-service).

Please refer to our [Fair Usage Policy](https://supermetrics.com/fair-usage-policy) for more details on usage limits.

[Contact us](/v1-api/apidocs/support) for any questions or changes to the limits.

## Best practices

- Avoid sending requests to the Supermetrics API in short bursts to avoid rate limit issues. Make sure there is sufficient time between requests.
- Use [asynchronous queries](/v1-api/apidocs/async-queries) to schedule more than one query first, and then poll for the results.

## Resources

- [Daily delivery quotas](/v1/docs/about-daily-request-quotas-and-limits)
- [Support options](/v1-api/apidocs/support)
- [Terms of Service](https://supermetrics.com/terms-of-service)