Skip to main content

Rate Limits

Pixel Patrol enforces rate limits to ensure fair usage and system stability.

Per Site Key Limits

Content Size Limits

Rate Limit Headers

API responses include rate limit information in headers:
  • X-RateLimit-Limit: Maximum requests allowed per window
  • X-RateLimit-Remaining: Requests remaining in current window
  • X-RateLimit-Reset: Unix timestamp when the window resets

Handling Rate Limits

When you exceed rate limits, the API returns a 429 Too Many Requests response:

Best Practices

  1. Implement exponential backoff - Wait longer between retries after each failure
  2. Monitor rate limit headers - Track remaining requests to avoid hitting limits
  3. Batch requests when possible - Submit multiple items efficiently
  4. Cache status checks - Avoid repeatedly checking the same media status

Example Retry Logic

Subscription Limits

Rate limits are separate from your subscription’s moderation limits:
  • Rate limits prevent API abuse (requests per minute)
  • Moderation limits control usage based on your plan (moderations per month)
When you exceed your monthly moderation limit, you’ll receive a 403 Forbidden response:

Increasing Limits

Contact support@pixelpatrol.net if you need higher rate limits for your use case. We can accommodate enterprise customers with custom limits.