API rate limits and constraints
Current Limits
| Limit Type | Value | Description |
|---|---|---|
| Rate Limit | 7 requests per second | Maximum API calls allowed per second |
| Size Limit | 1 megabyte per request | Maximum payload size for each request |
| Content Limit | 1000 keys per request | Maximum number of content items per request |
What Happens When Limits Are Exceeded
When you hit any limit, our API returns an error response with details about which specific limit was exceeded. This helps you adjust your implementation accordingly.
Best Practices
Rate Limiting
- Implement retry logic with exponential backoff
- Batch your requests when possible instead of making rapid sequential calls
- Monitor your request frequency to stay within the 7 requests/second limit
Size Management
- Keep requests under 1MB by splitting large content into multiple requests
- Consider file size when including rich content or long text blocks
- Use ourSizing Guide for optimal request organization
Content Organization
- Group related content up to 1000 keys per request
- Split large content sets across multiple requests
- Follow our recommendations for content grouping in the Sizing Guide
Need Higher Limits?
If these limits create problems for your implementation, please contact us at [email protected].
We can:
- Review your use case and provide optimization advice
- Discuss custom limits for enterprise implementations
- Suggest alternative approaches for handling large-scale translations
Our team is here to help you find the best solution for your translation needs.