TheNews API
- Free allowance
- Free plan, USD 0: 100 requests daily, 3 articles per news request, top stories, all news and similar-news endpoints, real-time and historical data.
- Verdict
- caveatusable, with a named limit or an unprobed read path
- Cost
- free tier
- Identity
- emailno card, no phone
- Binding limit
- request-rate100 requests daily on the Free plan; unverified: a per-minute limit exists (HTTP 429 for too many requests in the past 60 seconds) and its size is read from the X-RateLimit-Limit header, which needs a key
- Evidence
- documented13 sources; a first-party page was read and the sentence quoted
- Freshness
- stale on 2026-12-03checked 2026-11-02 (live); stale on 2026-12-03
| Free tier | Free plan, USD 0: 100 requests daily, 3 articles per news request, top stories, all news and similar-news endpoints, real-time and historical data. unit requests; metered on request-count; Each call to access or search news data adds 1 request to the daily usage. The headlines endpoint is documented as available on the Standard plan and above. The next plan up is Basic at USD 19 a month for 2,500 requests daily and 25 articles per request. |
|---|---|
| Price | none stated |
| Limits |
|
| Binding | request-rate 100 requests a day is met first; at 3 articles a request that is at most 300 articles a day. |
| Identity | email The pages say no billing details are required on the free plan. |
| Egress | not applicable |
| Per-object cap | 3 articles per news request on the Free plan; an article carries a snippet of its first 60 characters, not the body |
| Retention | no retention or history window is stated for the Free plan; the pricing page lists historical data on every plan |
| Interface | rest REST over HTTPS at api.thenewsapi.com/v1/news (top, all, similar, uuid, sources); the key goes in the api_token parameter; answers are UTF-8 JSON with dates in UTC endpoint: https://api.thenewsapi.com/v1/news/all |
| Tooling | any HTTP client |
| Composes with | Article metadata with a title, a description, a 60-character snippet, the source URL and a uuid; the full article is fetched from the source URL by a crawler. |
| Reliability | Over the daily usage the API answers HTTP 402 usage_limit_reached, and over the per-minute limit HTTP 429 rate_limit_reached; a call with no token answered HTTP 401 invalid_api_token. |
| Notes | Storage: no caching or storage limit is stated on the documentation, pricing or FAQ pages; the uuid of each article is meant to be stored and used to fetch it again. Bulk path: none; paging stops at 20,000 articles a result set, 3 articles a request on Free. |
| Evidence note | documented Quota, article cap, snippet length, error codes and register fields are read from first-party pages; a call with no token answered HTTP 401, so the free key was not exercised. A call with a free key would move this to measured. |
| Parsed numbers |
|
Evidence 13
| date | source | what it proved |
|---|---|---|
| 2026-11-02 | www.thenewsapi.com/pricing | the Free plan allows 100 requests daily |
| 2026-11-02 | www.thenewsapi.com/pricing | the Free plan returns 3 articles per news request |
| 2026-11-02 | www.thenewsapi.com/pricing | Basic, the next plan up, is USD 19 a month |
| 2026-11-02 | www.thenewsapi.com/faq | the free plan needs no payment details |
| 2026-11-02 | www.thenewsapi.com/faq | every API call that accesses or searches news data counts as 1 request against the daily usage |
| 2026-11-02 | www.thenewsapi.com/faq | only a short snippet of each article is returned, with its link |
| 2026-11-02 | www.thenewsapi.com/documentation | the snippet is the first 60 characters of the article body |
| 2026-11-02 | www.thenewsapi.com/documentation | each article has a uuid that is meant to be stored and used to fetch the article again |
| 2026-11-02 | www.thenewsapi.com/documentation | a result set cannot exceed 20,000 articles |
| 2026-11-02 | www.thenewsapi.com/documentation | too many requests in the past 60 seconds answer HTTP 429, with the limit in a response header |
| 2026-11-02 | www.thenewsapi.com/documentation | the usage limit of the plan answers HTTP 402 |
| 2026-11-02 | www.thenewsapi.com/register | the register form asks for an email address |
| 2026-11-02 | probe: https://api.thenewsapi.com/v1/news/top | a call with no token answers HTTP 401 invalid_api_token |
Unknown values 1
- egress terms: the field does not apply to this kind of offer