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/requestsGET /api/v1/topicsPOST /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
| Plan | Credits | Rate Limit |
|---|---|---|
| Free | 100 / monthly | 10 req/min |
| Pro | 2,000 / monthly | 60 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
/usageendpoint