plainradar

For developers

News API.

The live search behind plainradar.com as one REST call. It isn't a lookup in a stored index: when you call it, it reads what the world's press is publishing on your topic right then, keeps the stories that are really about it, and returns each one once, as JSON. The API is available on RapidAPI.

Keys, plans and billing are on RapidAPI. You don't need a Plainradar account.

Get a key on RapidAPI →

How it differs from a keyword news API

Follow topics and events

Use it for a standing topic (an industry, a company, a technology) or for one event as it unfolds (an election, a product launch, a court ruling, a natural disaster). Call it on a schedule and you see new stories as they are published, and how coverage of each grows (sources). Within a search, cursor returns only the stories you haven't had yet, plus updates for the ones you have.

One endpoint

GET /v1/search takes your topic and returns the stories. Send it through RapidAPI with your key:

curl --get "https://plainradar.p.rapidapi.com/v1/search" \
  --data-urlencode "query=artificial intelligence" \
  -H "X-RapidAPI-Host: plainradar.p.rapidapi.com" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY"

Here's a real response for artificial intelligence, trimmed to one story:

{
  "query": "artificial intelligence",
  "pages": [{
    "from": "2026-10-11T07:55:07+00:00",
    "to":   "2026-10-12T07:55:07+00:00",
    "stories": [{
      "id": "5494c9ad12e9",
      "title": "‘More Dangerous Than Drugs’: Bill Gates Warns Of Risks Posed By Artificial Intelligence",
      "link": "https://dailycaller.com/2026/10/11/bill-gates-warns-artificial-super-intelligence-...",
      "published": "2026-10-11T19:42:26+00:00",
      "feed": "dailycaller.com",
      "summary": "Technology icon Bill Gates expressed dire warnings about the consequences of ...",
      "image": "https://images.dailycaller.com/image/...",
      "sources": 9,
      "relevant": "yes"
    }],
    "omitted": 47,
    "updates": [],
    "more": true,
    "cursor": "FETYbegTl8_UXbsu:day"
  }],
  "stats": {"stories": 77, "hidden": 0, "seconds": 5.46},
  "filters": {"language": "English", "country": null,
              "search": "artificial intelligence", "noise": []}
}

That call found 77 stories in about five seconds. Each story has its headline, link, source, publication time, summary, image and how many sources cover it.

Parameters

ParameterWhat it does
queryThe topic or question, in plain language (2–200 characters). The only required parameter.
days1 by default: the last 24 hours. 2–7 adds a second page with the best stories from the days before that.
languageSources are English by default. Use a language name such as French, or all for every language. A language or country named in its own language in the query ("España", "română") works too.
filtersUp to 5 plain-language preferences that leave out stories that don't fit, such as Skip opinion pieces and listicles or Only news from Europe. Send a JSON list, or repeat the parameter. Give them on the first call. They then apply to the whole search.
limitThe most stories a page has: 30 by default, up to 100. The most covered and most relevant stories come first, and omitted says how many more there were.
briefingtrue adds a few sentences on the first page's main news, each with the ids of the stories it comes from. It takes a few seconds more.
cursorWhen a page says more: true, call again with the same query and this cursor for further stories. You get new stories plus updates (more coverage) for ones already returned. A search can be continued for 30 minutes after its last call.

Good to know

Building an AI agent?

Agents don't need the REST API. Plainradar has an MCP server with the same search as a tool, so Claude, Cursor and other MCP clients can call it directly. See how to give your AI agent live news with MCP.

Subscribe on RapidAPI, copy your key and make your first call.

Get a key on RapidAPI →

FAQ

Do I need a Plainradar account?

No. You subscribe and get your key on RapidAPI, and RapidAPI handles plans and billing. A Plainradar account is for the website and for agents (MCP).

Can I use my Plainradar credits for the API?

No. The API on RapidAPI is separate from the website's credits. If you want to search from an AI agent with your Plainradar account, use the MCP server.

How fresh are the results?

Sources are read when you call, so new stories show up soon after they're published. The first page covers the last 24 hours.

Where do I ask questions?

Write to [email protected].