NewsAPI.org

Implementation notes

When to use NewsAPI.org

NewsAPI.org is the widest-known free news aggregation API among developers — it powers a large slice of the 'news feed' prototypes on GitHub, indie hacker MVPs, and hackathon projects. It suits keyword searches across 80,000+ English-language sources with simple category and country filters. Choose it for tutorials, learning projects, portfolio pieces, and local prototypes. Do NOT choose it for anything production-facing without upgrading — the free tier explicitly forbids commercial use, and enforcement is aggressive (see pitfalls). For production news aggregation, GNews or NewsData.io have more honest free tiers.

Common pitfalls

• Free plan is restricted to localhost/development only — the API returns 426 'You have made too many requests recently' when called from any production domain, even at low volume. This isn't a rate limit; it's a policy check on the request Origin header. Going commercial requires the $449/month Business plan, which is the steepest upgrade jump of any free news API.
• Articles older than 30 days are unavailable on the free plan; historical archive access also requires Business tier.
• The `everything` endpoint can return up to 100 articles per page but caps total results at 100 for the free plan regardless of how many match. Pagination beyond page 1 returns empty results unless you upgrade.
• The `top-headlines` endpoint returns different results depending on whether you pass `country`, `category`, or `sources` — but the combinations are restricted. `sources` cannot be used with `country` or `category`. Errors here return 400 with a generic message; check the docs for the current matrix of allowed parameter combinations.

Quick start (bash)

curl "https://newsapi.org/v2/everything?q=Apple&apiKey=YOUR_KEY&pageSize=10"

From our monitoring

In our monitoring, NewsAPI's uptime is excellent (~99.9%) but response times vary widely between regions (150ms from US-East, 800ms+ from EU/AP). The 426 policy check on Origin is enforced within seconds — we've seen developers deploy a Vercel prototype at midnight, ship it publicly, and find it broken by 8am when NewsAPI's throttling kicks in. If you want to test in production, wire up a request that includes the correct Origin header from your local machine first.

Production integration patterns

Server-side proxy pattern (for tutorial UIs)

The most common use of NewsAPI in real projects is behind a server-side proxy that fetches news at build time or via a scheduled job, caches it in a database, and serves it from your own API. This works around the localhost-only free tier restriction (your server calls NewsAPI from an allowed origin, then serves cached results to browsers from any origin). Update cadence: hourly is fine for most news apps. Cache TTL: 15-60 minutes depending on category (finance faster, general slower).

Bounded keyword tracker (the /r/tracker pattern)

A common learning project: monitor a fixed list of keywords and alert on new mentions. NewsAPI's `everything` endpoint with a keyword query is perfect for this at hobby scale. Fixed keyword list of 5-10 terms, hit once per hour, dedupe against previously-seen URLs, send Slack/Discord/email on new. Total daily budget: 240 calls if hit hourly, well within the 500/day soft dev cap. Good starter project for learning webhooks and scheduled jobs.

Migration path off NewsAPI

If your NewsAPI prototype grows into something real, plan the migration to GNews or NewsData.io before deploying to production. All three APIs return similar JSON shapes but field names differ (NewsAPI: `title`/`description`/`url`, GNews: `title`/`description`/`url` but pagination differs, NewsData: `title`/`description`/`link`). Write your adapter layer on day one to make swapping providers a one-file change. This is the mistake most 'move fast' teams regret when NewsAPI blocks their production launch.

Compared to the closest paid alternatives

vs GNews.io — Free: 100/day (production OK) · Basic: $9/month for 1k/day

GNews's free tier explicitly allows production use up to 100 requests/day. That's tight for anything serious but at least it's honest — you can ship a personal project without waiting for a $449 invoice. Coverage is smaller than NewsAPI (60k sources vs 80k) but the source quality is comparable for major topics. Best default replacement when NewsAPI's localhost restriction bites you.

vs NewsData.io — Free: 200/day (production OK) · Pro: $19/month for 10k/day

NewsData's free tier is 200 requests/day with production use explicitly allowed. Their source database is larger than GNews at 84,000+ sources across 156 countries. The trade-off: their search relevance is less refined for general queries, and their historical archive is smaller (30 days on free tier). For personal projects and country-specific news, they beat GNews on quota.

vs The Guardian Open Platform — Free: 5,000/day for developer key · Commercial: contact

Guardian's API is the strongest choice for editorial-quality UK/global news — one publisher's full archive back to 1999, unlimited free tier for personal use, and a genuinely permissive commercial license. Downside: it's ONE source, so you can't build cross-source aggregation. If your app needs Guardian content specifically (or you're happy with a single high-quality source), skip the aggregators and use this directly.

Embed this badge

Add a live status badge to your README, docs, or website.

Markdown

[![NewsAPI.org Status](https://freeapi-builder.a10ayassine.workers.dev/badge/newsapi-org.svg)](https://freeapi.watch/newsapi-org)

HTML

<a href="https://freeapi.watch/newsapi-org"><img src="https://freeapi-builder.a10ayassine.workers.dev/badge/newsapi-org.svg" alt="NewsAPI.org Status"/></a>