RequestHuntRequestHunt

Rate Limits

API requests are rate-limited to ensure fair usage. Limits vary by plan and request type.

Request Types

Cached Requests

Queries against existing data in our database. Fast and low-cost.

  • GET /api/v1/requests (without source=realtime)
  • GET /api/v1/topics

Realtime Requests

Triggers live scraping from X, Reddit, and GitHub. More expensive due to external API calls.

  • GET /api/v1/requests?source=realtime
  • POST /api/v1/requests/search

Limits by Plan

PlanCachedRealtime
Free1,000 / daily500 / monthly
Pro10,000 / daily5,000 / monthly

Upgrade to Pro for higher limits.

Checking Your Usage

Use the GET /api/v1/usage endpoint to check your current usage:

{
  "data": {
    "tier": "free",
    "cached": {
      "used": 150,
      "limit": 1000,
      "remaining": 850,
      "resetsAt": "2024-12-18T00:00:00.000Z"
    },
    "realtime": {
      "used": 25,
      "limit": 500,
      "remaining": 475,
      "resetsAt": "2025-01-01T00:00:00.000Z"
    }
  }
}

This endpoint is free and does not count against your quota.

Rate Limit Response

When you exceed your limit, you'll receive a 429 response:

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Realtime rate limit exceeded (500/month). Resets on 2025-01-01."
  }
}

Tips to Stay Within Limits

  • Use cached requests when possible (faster and cheaper)
  • Cache responses on your end to reduce API calls
  • Use pagination efficiently - don't fetch more than you need
  • Monitor usage with the /usage endpoint