Pricing and Rate Limiting
Overview
This API charges varied requests for each endpoint. For example, the /graph endpoint is 15 requests, while the /autofilter endpoint is 5 requests. The API also employs rate and concurrency limiting to ensure fair usage and maintain service availability for all users. Rate and concurrency limits are enforced based on the subscription plan associated with each user's API key.
Costs
The following table lists the costs associated with each endpoint:
| Endpoint | Request cost | Plans |
|---|---|---|
| /news (last 48 hours) | 1 request | Spelunker, Analyst, Enterprise |
| /news (archive) | 5 requests | Spelunker, Analyst, Enterprise |
| /autofilter | 5 requests | Spelunker, Analyst, Enterprise |
| /stories | 10 requests | Analyst, Enterprise |
| /graph | 15 requests | Spelunker, Analyst, Enterprise |
| /websearch | 15 requests | Analyst, Enterprise |
| 1 deep request | Enterprise | |
| /forecast | 1 deep request | Analyst, Enterprise |
| /analytics/finance | 1 request | Analyst, Enterprise |
| /analytics/politics | 1 request | Enterprise |
| /chat (fast) | $3/million tokens | Spelunker, Analyst, Enterprise |
| /chat (rich) | $5/million tokens | Spelunker, Analyst, Enterprise |
Plan details:
| Plan | Monthly requests | Monthly cost | Extra request cost | Max allowed requests per month |
|---|---|---|---|---|
| Spelunker | 1,500 | $250 | $0.01 | 25k |
| Analyst | 50,000 | $1000 | $0.005 | Unlimited |
| Enterprise | Custom | Custom | Custom | Unlimited |
Many of these endpoints are reserved for specific tiers. For example, only Analyst and Enterprise clients have API access to the /forecast endpoint. Please see the plans page for specific information about what is available to each tier.
Plans
For the most up-to-date information on pricing and plans, please visit the plans page here.
Rate Limits
The following subscription plans and their corresponding limits are enforced:
- Free Plan:
- Rate limit: 1 request per 10 seconds
- Concurrency limit: 1 request at a time
- Pro Plan:
- Rate Limit: 1 request per second
- Burst Limit: 5 requests per second
- Concurrency Limit: 5 requests at a time
- Spelunker Plan:
- Rate Limit: 1 request per second
- Burst Limit: 5 requests per second
- Concurrency Limit: 5 requests at a time
- Analyst Plan:
- Rate Limit: 5 request per second
- Burst Limit: 10 requests per second
- Concurrency Limit: 10 requests at a time
- Enterprise Plan:
- Rate Limit: Custom
- Burst Limit: Custom
- Concurrency Limit: Custom
Handling Rate Limits
When a client exceeds their rate or concurrency limit, the API responds with an appropriate HTTP status code and includes specific headers in the response to provide details.
Status Codes and Responses
Rate Limit Exceeded
Headers:
X-RateLimit-Limit: The maximum number of requests permitted within the current rate limit window.X-RateLimit-Remaining: The number of requests remaining before the rate limit resets.Retry-After: The number of seconds until the rate limit resets.
Concurrency Limit Exceeded
Headers:
X-Concurrency-Limit: The maximum number of requests permitted to run concurrently.X-Concurrency-Remaining: The number of requests remaining before the concurrency limit resets.