Skip to main content
The Promptwatch API enforces rate limits to ensure fair usage and platform stability.

​
Current Limits

All API requests are rate-limited to 1,000 requests per minute per IP address. This limit applies uniformly across all subscription tiers.

​
Rate Limit Headers

Every API response includes rate limit information in the headers:
HeaderDescription
X-RateLimit-LimitMaximum requests allowed in the current window
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetUnix timestamp when the rate limit resets

​
429 Response

When you exceed the rate limit, you’ll receive a 429 Too Many Requests response: 
{
  "code": "RATE_LIMITED",
  "message": "Too many requests, please slow down",
  "statusCode": 429
}

​
Best Practices

​
Cache Responses

Cache static or rarely-changing data:
  • Models: Cache for 24 hours
  • Monitors: Cache for 1 hour
  • Analytics: Cache based on date range

​
Fair Use Policy

Please use the API responsibly:
  • Don’t make unnecessary requests
  • Implement caching where appropriate
  • Use batch operations when available
  • Respect rate limit headers
Abuse of the API may result in temporary or permanent suspension of access.

​
Increasing Limits

Need higher limits for your use case?

Contact Us

Contact our team to discuss custom rate limits for enterprise needs

​
Need Help?