We use cookies to ensure you get the best experience on our website. Some of these cookies are provided by third parties. You are free to decide which categories you would like to permit and can withdraw this consent at any time (via cookie preferences link on the footer).
By accepting the necessary cookies, you agree to our privacy policy and terms of service, both located in the footer of the website.
Learn more on our terms of service and privacy policy.
This API charges varied requests for each endpoint. For example, the /news (last 48 hours) endpoint is a single request, while the /graph endpoint is 15 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.
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 |
| /wiki | 1 request | Spelunker, Analyst, Enterprise |
| /autofilter | 3 requests | Spelunker, Analyst, Enterprise |
| /stories | 10 requests | Analyst, Enterprise |
| /graph | 15 requests | Spelunker, Analyst, Enterprise |
| /websearch | 5 requests | Analyst, Enterprise |
| 1 deep request | Enterprise | |
| /forecast | 1 deep request | Analyst, Enterprise |
| /chat (fast) | $2/million tokens | Spelunker, Analyst, Enterprise |
| /chat (rich) | $7/million tokens | Spelunker, Analyst, Enterprise |
Plan details:
| Plan | Premium Paywalled Sources | Monthly requests | Monthly cost | Extra request cost | Max allowed requests per month | Included Tokens per month | Extra Token Cost | Max Allowed Tokens per month | License |
|---|---|---|---|---|---|---|---|---|---|
| Spelunker | No | 1,500 | $250 | $0.03 | 25k | 10M | $2/M fast, $7M rich | 50M | Non-commercial |
| Analyst | Yes | 50,000 | $1000 | $0.01 | 500k | 40M | $2/M fast, $7M rich | Unlimited | Non-commercial |
| Enterprise | Yes | Custom | Custom | Custom | Unlimited | Unlimited | - | Unlimited | Commercial |
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.
For the most up-to-date information on pricing and plans, please visit the plans page here.
The following subscription plans and their corresponding limits are enforced:
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.
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.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.