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.
Included usage is used first. When it runs out, API use pauses unless your wallet has credits; paid usage is deducted at the listed rates.
For Pay as you go, M means one million tokens:
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 token amounts are bonus tokens, not credits or usage limits. After the bonus tokens are used, pre-paid credits cover additional tokens at the listed per-million rate. Bonus tokens are separate from the HTTP request-rate, burst, and concurrency limits documented under Rate Limits.
| Plan | Premium Paywalled Sources | Credits Included | Monthly cost | Credit Cost After Tier | Lite bonus tokens | Standard bonus tokens | Advanced bonus tokens | License |
|---|---|---|---|---|---|---|---|---|
| Pay as you go | No | 25 | $0 | $0.025 | 150,000 included; additional $5/M | 150,000 included; additional $12/M | None included; starts at $15/M | Non-commercial |
| Pro | No | 500 | $7.99 | $0.02 | 1M included; additional $4/M | 1M included; additional $10/M | None included; starts at $12/M | Non-commercial |
| Spelunker | No | 20,000 | $250 | $0.015 | 5M included; additional $3/M | 5M included; additional $7/M | None included; starts at $10/M | Non-commercial |
| Analyst | Yes | 110,000 | $1000 | $0.01 | 20M included; additional $2/M | 20M included; additional $6/M | 5M included; additional $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.
Pay as you go users can start without an initial top-up after creating a wallet and adding a usable card. Adding a card does not fund the wallet. Included usage is used first; after it is exhausted, API use pauses until wallet credits are added. Funded wallets, including admin-funded wallets, remain usable without a card.
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.