Rate Limits

API requests are rate-limited to ensure fair usage. All actions consume credits from a unified monthly pool.

Credit Costs

API Requests (1 credit each)

Queries against existing data or live scraping via API.

  • GET /api/v1/requests
  • GET /api/v1/topics
  • POST /api/v1/requests/search

Web Scraping (depth x platforms credits)

Each page of results per platform costs 1 credit. A scrape with depth=3 across 2 platforms costs 6 credits.

Credits by Plan

PlanCreditsRate Limit
Free100 / monthly10 req/min
Pro2,000 / monthly60 req/min

Upgrade to Pro for higher limits.

Checking Your Usage

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

{
  "data": {
    "tier": "free",
    "credits": {
      "used": 42,
      "limit": 100,
      "remaining": 58,
      "resetsAt": "2025-02-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": "Credit limit exceeded (100/100). Resets on 2025-02-01."
  }
}

Tips to Stay Within Limits

  • Use lower scrape depth when exploring new topics
  • 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