To ensure high availability and efficient performance, we apply various limits on the BatchData APIs such as the number of API requests allowed per minute and the number of request items per API request.
This guide explains API rate limits and API request item limits and how they are applied to the BatchData APIs. Understanding these limits is crucial for developers who use the BatchData APIs to create applications.
What are API Rate Limits?
API rate limits are used to restrict the number of API requests you can make within a specific timeframe. These limits are in place to prevent abuse and ensure that all of our customers have access to the BatchData APIs.
BatchData API Rate Limits:
We allow up to 3,000 API requests per minute per API access token. For more details feel free to contact us at [email protected]
Consequences of Exceeding API Rate Limits:
If you exceed the API rate limit, you will receive an error message. Depending on the severity of the violation, you may be temporarily blocked from making further requests.
How to Avoid Exceeding Rate Limits:
Monitor your API usage. The BatchData usage reports provide you with the tools to track your API usage and identify potential rate limit violations.
Implement exponential backoff. If you receive an error message indicating that you have exceeded a rate limit, wait a short period of time before retrying your request. The wait time should be doubled for each subsequent retry.
What are API Request Item Limits?
API request item limits restrict the number of items you can include in a single API request. These limits are in place to prevent overloading the API and ensure efficient performance.
BatchData Request Item Limits:
Maximum number of items per request: This limit varies depending on the specific API endpoint. Refer to the table below for API specific limits and recommended limits to adhere to.
API Endpoints | Maximum Request Items | Recommended Request Items |
Address Verification | 5,000 | 1,000 |
Phone Verification | 10,000 | 1,000 |
Phone DNC | 10,000 | 1,000 |
Phone TCPA | 250 | 250 |
Property Lookup | 1,000 | 500 |
Skip Trace (Synchronous) | 100 | 100 |
Skip Trace (Asynchronous) | 1,000 | 1,000 |
Geocode | 90 | 75 |
Property Owner Profile | 2,000 | 1,000 |
Property Search | 1,000 | 1,000 |
Consequences of Exceeding Request item Limits:
If you exceed an API request item limit, you will receive an error message.
How to Avoid Exceeding Request Item Limits:
Split your data into multiple requests. If your data is too large to fit in a single request, you can split it into multiple requests.