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.
AskNews API usage is measured by credits and chat token units. For example, /news for the last 48 hours costs 1 credit, while /graph costs 15 credits. Rate and concurrency limits are enforced based on the subscription plan associated with each API key.
Pre-paid credits are prepaid credits for API usage. Pay as you go and Pro users can use the API by adding pre-paid credits. For paid API plans, included tiers are consumed first; pre-paid credits are used after the included tier is consumed.
The following table lists the costs associated with each endpoint:
| Endpoint | Credit cost | Plans |
|---|---|---|
| /news (last 48 hours) | 1 credit | Pay as you go, Pro, Spelunker, Analyst, Enterprise |
| /news (archive) | 5 credits | Pay as you go, Pro, Spelunker, Analyst, Enterprise |
| /wiki | 1 credit | Pay as you go, Pro, Spelunker, Analyst, Enterprise |
| /autofilter | 3 credits | Pay as you go, Pro, Spelunker, Analyst, Enterprise |
| /stories | 10 credits | Spelunker, Analyst, Enterprise |
| /graph | 15 credits | Spelunker, Analyst, Enterprise |
| /websearch | 5 credits | Spelunker, Analyst, Enterprise |
| 1 credit | Enterprise, approved trials | |
| /deepnews (Lite) | Token-based | Pay as you go, Pro, Spelunker, Analyst, Enterprise |
| /deepnews (Standard) | Token-based | Pay as you go, Pro, Spelunker, Analyst, Enterprise |
| /deepnews (Advanced) | Token-based | Pay as you go, Pro, Spelunker, Analyst, Enterprise |
Plan details:
| Plan | Premium Paywalled Sources | Credits Included | Monthly cost | Credit Cost After Tier | Lite Tokens | Standard Tokens | Advanced Tokens | License |
|---|---|---|---|---|---|---|---|---|
| Pay as you go | No | - | $0 | $0.025 | $5/M | $12/M | $15/M | Non-commercial |
| Pro | No | 500 | $7.99 | $0.02 | 1M included, then $4/M | 1M included, then $10/M | $12/M | Non-commercial |
| Spelunker | No | 20,000 | $250 | $0.015 | 5M included, then $3/M | 5M included, then $7/M | $10/M | Non-commercial |
| Analyst | Yes | 110,000 | $1000 | $0.01 | 20M included, then $2/M | 20M included, then $6/M | 5M included, then $8/M | Non-commercial |
| Enterprise | Yes | Custom | Custom | Custom | Custom | Custom | Custom | Commercial |
Many endpoints are reserved for specific tiers. Please see the plans page for specific information about what is available to each tier.
Pre-paid credits let customers prepay for API usage. Pay as you go users can access the API by adding pre-paid credits. Pro and higher plans use their included tier first; after that tier is consumed, pre-paid credits can cover additional usage at the plan's published rate.
For the most up-to-date information on pricing and plans, please visit the plans page.
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 HTTP requests permitted within the current rate limit window.X-RateLimit-Remaining: The number of HTTP 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 HTTP requests permitted to run concurrently.X-Concurrency-Remaining: The number of HTTP requests remaining before the concurrency limit resets.