Rate Limits
Understand API usage limits and how to stay within them.
Tiers
| Tier | Requests / Sec | Monthly Credits | Data Freshness | WebSocket | Price |
|---|---|---|---|---|---|
| Free | 2 | 1,000 | Real-time | No | Free |
| Starter | 5 | 30,000 | Real-time | 1 conn | $29/mo |
| Pro | 10 | 150,000 | Real-time | 10 conn | $99/mo |
| Business | 30 | 600,000 | Real-time | 50 conn | $299/mo |
Free Free
2 RPS · 1,000 credits/mo · Real-time · WS: No
Starter $29/mo
5 RPS · 30,000 credits/mo · Real-time · WS: 1 conn
Pro $99/mo
10 RPS · 150,000 credits/mo · Real-time · WS: 10 conn
Business $299/mo
30 RPS · 600,000 credits/mo · Real-time · WS: 50 conn
Data Freshness
All tiers receive real-time data. Articles and stories are available as soon as they are ingested — no delays on any plan.
Credit Costs
Each API call costs a certain number of credits depending on the endpoint. Lightweight calls like listing categories cost 1 credit. Full article content costs 5 credits.
| Credits | Endpoint Category | Description |
|---|---|---|
| 1 | Status, categories, sources | Lightweight metadata lookups |
| 2 | Article lists, story lists, search, entities | Paginated list queries |
| 5 | Article detail, story detail | Full content with AI summaries |
| 10 | Content extraction | On-demand fetching and parsing |
| 15 | Embeddings | Vector data, compute-heavy |
1 credit
Status, categories, sources — lightweight metadata
2 credits
Article lists, story lists, search, entities — paginated lists
5 credits
Article detail, story detail — full content + AI summaries
10 credits
Content extraction — on-demand fetching
15 credits
Embeddings — vector data, compute-heavy
Example: 100 article list calls (200 credits) + 50 article detail calls (250 credits) = 450 credits total.
Grace Period
Monthly credit quotas include a 10% grace factor. You can exceed your monthly limit by up to 10% before requests are blocked. This gives you a buffer to adjust your usage before a hard cutoff.
Rate Limit Headers
Every API response includes headers to help you track your usage.
HTTP/1.1 200 OK
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1708300860| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests allowed per second for your tier. |
X-RateLimit-Remaining | Number of requests remaining in the current window. |
X-RateLimit-Reset | Unix timestamp (seconds) when the rate limit window resets. |
X-RateLimit-Limit Maximum requests allowed per second for your tier.
X-RateLimit-Remaining Number of requests remaining in the current window.
X-RateLimit-Reset Unix timestamp (seconds) when the rate limit window resets.
429 Response
When you exceed the rate limit, you'll receive a 429 status with details about when to retry.
{
"error": "Rate limit exceeded. Try again in 42 seconds.",
"status": 429
}WebSocket Limits
WebSocket events count toward your monthly credit quota. Each event delivered costs 1 credit.
| Tier | Connections | Note |
|---|---|---|
| Free | 0 | Not available |
| Starter | 1 | Single connection |
| Pro | 10 | Multi-client |
| Business | 50 | Enterprise scale |
Free
0 connections · Not available
Starter
1 connection · Single connection
Pro
10 connections · Multi-client
Business
50 connections · Enterprise scale
For full WebSocket documentation, see the WebSocket guide.