Limits

API rate limits and constraints

Current Limits

Limit TypeValueDescription
Rate Limit7 requests per secondMaximum API calls allowed per second
Size Limit1 megabyte per requestMaximum payload size for each request
Content Limit1000 keys per requestMaximum 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.