Sign inGet API key

LIVE NEWS INDEX FOR AGENTS AND APPS

The world's news, one API call away

Full-text search over 54,446,310 articles from 25,000+ publishers in 100 languages. Article bodies included. Connect over REST, RSS or MCP.

GET/v1/search?q=climate&size=320038 ms
curl -H "Authorization: Bearer $FNA_KEY" \
  "https://freenewsapi.ai/v1/search?q=climate"

{
  "took_ms": 38,
  "results": [{
    "title": "Will scallopers return to the Northern Edge?",
    "host": "newbedfordlight.org",
    "country": "US",
    "lang": "en",
    "published_at": "2026-11-16T19:49:20Z"
  }]
}

Built so you can trust the answer

Full article text

Ground a model in the reporting itself, not a headline. Bodies are available with full_text=true.

Labelled guesses

Every article carries country_source and date_source, so you know what is known and what is inferred.

Public pipeline

Each ingest batch is published with its file, article count and duration. Check freshness yourself.

Ready for agents

An MCP server, tool definitions and RAG recipes, with published token costs for each response mode.

Three calls, that is the API

Scan cheaply, select carefully, then fetch only the bodies you need.

  1. /v1/stats

    Counts instead of articles: how much coverage, and where.

  2. /v1/search

    Full-text search by country, language, zone, publisher and date.

  3. /v1/article

    One article by URL, with the full body text.

Browse by country and language

Start with a free key

Create an account and your key is ready in under a minute.

Frequently asked questions

Short answers about access, data, freshness and agent integration. The full FAQ goes deeper.

What is a free news API?

A way to search current news articles programmatically without paying for access. A free key gives 3,000 requests a month: you call /v1/search and get JSON with headlines, metadata and, on request, full article text. It is built for AI agents and developers.

Is freenewsapi.ai really free?

The Free plan is: 3,000 requests a month with a free API key and no card. Commercial use is allowed, and full_text=true is included rather than sold as a premium add-on.

Do I need an API key?

Yes, from 1 November 2026. It is free, takes under a minute, and one key works from a backend, a browser or an autonomous agent. Get a key.

Does the API return full article text?

Yes. Add full_text=true to /v1/search, or call /v1/article with the article URL. You get the extracted body, not just a headline — retrieval-augmented generation needs the actual article.

How fresh is the news, and can I verify it?

Articles are indexed continuously throughout the day. Every ingest batch is listed on snapshots with its timestamp, and /health and /v1/stats let you measure freshness yourself.

Why only a 90-day window?

The public corpus keeps a rolling 90 days; that tradeoff is what pays for the free tier. If you need years of archive, that is a different, paid kind of service.

Can I use freenewsapi.ai commercially?

Yes, with no upgrade or permission request. When you show an article to a person, link back to the original url — the text belongs to the publisher, and every response includes that URL.

How many publishers and languages are covered?

25,000+ publishers across dozens of languages and most countries, with several thousand active on a typical day. Check a hostname in the publisher directory before building around it.

Is there an MCP server for AI agents?

Yes, at /mcp, over Streamable HTTP with your API key. An agent can search news, read trends and look up publishers through tools like search_news and get_trends; /mcp.json lists them.

How do I filter by country, language and date?

Pass query parameters on /v1/search: country, lang, zone, from/to and publisher. Add strict_country=true for country-level accuracy. See the docs.

Can I sort by relevance instead of date?

Yes: sort=relevance. The default is date because most callers want the newest. Use sort=crawled when polling, since crawl time never moves backwards even when publishers backdate articles.

What are the rate limits?

The Free plan allows 2 requests per second and 3,000 a month. Over the limit the API answers 429; paid plans raise both the monthly quota and the per-second rate. See pricing.

Is there an SDK, or an RSS feed?

No SDK is needed — it is a handful of GET endpoints returning JSON, so any HTTP client is the SDK. For feeds, /v1/rss and /v1/atom return standard XML any reader can take.

How is this different from NewsAPI.org or GNews?

Those usually forbid commercial use, or hide article bodies and volume behind paid tiers. freenewsapi.ai allows commercial use on the free plan, includes bodies and exposes an MCP server; the tradeoff is a 90-day window and no SLA. Full comparison.

Do you track me, and how do I remove my publication?

We keep only what runs the service — your account, per-key usage and server logs — with no ad networks or data brokers. Publishers can have their site excluded on request; see here.

Read all frequently asked questions →