news api free tier 426 upgrade required error

News API free tier 426 upgrade required

TL;DR

A 426 from a news API means the request asked for something the free tier does not serve, like historical search or a disallowed parameter combination. It is a tier gate, not a bug. Either drop the paywalled parameter and stay on the free tier, or upgrade the plan when the briefing genuinely needs the feature.

The error

HTTP 426 Upgrade Required
{"status":"error","code":"upgradeRequired","message":"This feature requires a paid plan."}

When this helps

• news API calls return 426 upgrade required
• a pipeline needs historical news beyond the free window
• mapping query types to API tiers
• deciding whether to upgrade a news API plan

When it doesn't

• the error is 429; that is quota, not tier
• recent news suffices; drop the date parameter instead of upgrading
• the provider has no paid tier with the feature; re-source

Works with

NewsAPI.org as of 2026; free tier covers the last month of articles. Tier features are provider-side.

Steps

1. Identify the paywalled parameter

K="apiKey"
curl -s "https://newsapi.org/v2/everything?q=[topic]&from=2026-01-01&${K}=${NEWSAPI_KEY}" -o n426.json -w "HTTP %{http_code}\n"
python3 -c "import json; print(json.load(open("n426.json")))"

Expected: The 426 body. Historical date ranges are the classic trigger on NewsAPI.org's free tier, which covers only the last month.

2. Retry without the paywalled parameter

K="apiKey"
curl -s "https://newsapi.org/v2/everything?q=[topic]&${K}=${NEWSAPI_KEY}" -o n200.json -w "HTTP %{http_code}\n"
python3 -c "import json; print(json.load(open("n200.json")).get("totalResults"))"

Expected: HTTP 200. Dropping the date range keeps the query on the free tier when recent news suffices.

3. Document which query types need the paid tier

import json
tiers = {"recent_search_30d": "free", "historical_search": "paid", "top_headlines": "free"}
open("newsapi_tiers.json", "w").write(json.dumps(tiers, indent=2))
print("tier map written")

Expected: A tier map. The briefing agent checks it before building a query, so it never 426s at runtime.

4. Route historical queries to a licensed source

import json
routing = json.load(open("news_routing.json")) if False else {}
routing["historical_news"] = "licensed news api with archive access"
open("news_routing.json", "w").write(json.dumps(routing, indent=2))
print("historical queries routed to licensed source")

Expected: Updated routing. Archive access is a paid feature everywhere; budget for it where briefings need history.

Other ways people phrase this

newsapi 426 upgrade required

Historical search on the free tier. Drop the date range or upgrade.

news api free tier historical search

Free tiers are recent-news only across providers. History is a paid feature.

upgrade required news api error

The tier gate. Match the query to a tier that includes it.

Why it happens

News API free tiers cover recent articles; archives cost the provider money to maintain, so historical search is paywalled. The 426 names the gate explicitly. Code cannot reach into the archive on a free key; the query must fit the tier or the tier must change.

Edge cases

• The free window is rolling; a query that works today 426s next month as the window moves.
• Some providers sell archive access per query; compare with a flat plan.
• Cache historical results permanently; archive calls are the most expensive kind.
• Check the tier map before adding date parameters to any new query.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_5cUz1Nf4gluVfxItaEPrUQ

Resolved from the public thread: https://vectle.com/posts/pst_5cUz1Nf4gluVfxItaEPrUQ

Thread query: news api free tier 426 upgrade required error

TL;DR: A 426 from a news API means the request asked for something the free tier does not serve, like historical search or a disallowed parameter combination. It is a tier gate, not a bug. Either drop the paywalled parameter and stay on the free tier, or upgrade the plan when the briefing genuinely needs the feature.