429
Too Many Requests

You've Hit the Rate Limit

Your account has exceeded the maximum number of allowed requests within the current time window. Please wait before making additional requests.

2:34
Remaining
← Back to Aevum News View Rate Limit Docs →
🔥
Exceeded

Requests / Minute

Short-term burst limit for individual endpoints

85 / 60 +42% over limit
⏱️
Warning

Requests / Hour

Medium-term rate window for sustained usage

3,120 / 4,000 78% used
📊
Healthy

Requests / Day

Daily quota for your current subscription tier

17,240 / 50,000 34% used
Upgrade Plan

Available Rate Limit Tiers

Starter
Free — $0/mo
  • ✓ Requests / Minute 30
  • ✓ Requests / Hour 2,000
  • ✓ Requests / Day 20,000
  • ✓ Concurrent Connections 2
  • ✓ Data Retention 24h
Recommended
Professional
$49/mo
  • ✓ Requests / Minute 200
  • ✓ Requests / Hour 15,000
  • ✓ Requests / Day 200,000
  • ✓ Concurrent Connections 10
  • ✓ Data Retention 30 days
Enterprise
Custom pricing
  • ✓ Requests / Minute Unlimited
  • ✓ Requests / Hour Unlimited
  • ✓ Requests / Day Unlimited
  • ✓ Concurrent Connections Unlimited
  • ✓ Data Retention Unlimited
Response Payload Expand JSON ▶
GET /api/v2/articles?category=world&limit=100 429 Too Many Requests 
{
  "error": {
    "code": 429,
    "type": "rate_limit_exceeded",
    "message": "Too many requests. Please retry after 154 seconds.",
    "details": {
      "limit": 60,
      "remaining": 0,
      "reset": 1705939800,
      "retry_after": 154,
      "window": "per_minute",
      "current_usage": 85
    },
    "request_id": "req_aev_8f3d2e1a9b7c",
    "docs_url": "https://aevumnews.dev/docs/rate-limits"
  }
}

Response Headers

Header Value Description
X-RateLimit-Limit 60 Maximum requests allowed per window
X-RateLimit-Remaining 0 Remaining requests in current window
X-RateLimit-Reset 1705939800 Unix timestamp when the window resets
Retry-After 154 Seconds to wait before retrying
X-Request-ID req_aev_8f3d2e1a9b7c Unique identifier for this request
X-Aevum-Plan starter Current subscription tier

🛠️ Resolve This Error

  • Implement exponential backoff in your retry logic
  • Cache API responses to reduce request frequency
  • Use webhooks instead of polling for real-time updates
  • Check your code for accidental request loops or duplicate calls
  • Batch multiple queries into a single request where possible

📚 Best Practices

  • Always respect the Retry-After header
  • Monitor rate limit headers in every response
  • Use the batch endpoint for bulk operations
  • Implement request queuing with prioritization
  • Contact us if you need a temporary limit increase