News API - Global Events, Breaking News, Entities (NewsAPI.ai)

Search global news articles and the events they describe through the Event Registry API (NewsAPI.ai), and get the results as a dataset, a spreadsheet or a warehouse feed. Uses your own NewsAPI.ai API key, reads only, and charges only for rows that carry data.

What it collects

• Article search: news articles, press releases and blog posts from sources worldwide, in many languages, with title, body (full or trimmed), URL, source, authors, language, publish time, sentiment, the event the article belongs to, and the concepts (people, organisations, places, topics) and categories found in it.
• Event search: events, which are clusters of articles from many sources about one real-world happening, with title and summary, event date, total and per-language article counts, sentiment, location, concepts and categories.
• Breaking events: the events whose coverage is spiking right now, with their breaking score.
• Event details and articles about an event: read an event by URI, or every article reported about it, filtered by language.
• Article details: read up to 100 articles a request by URI.
• Newest articles and newest events streams: everything added or updated in the last minutes (up to 4 hours), with the same filters, for near real time monitoring.
• Lookup: turn names into the concept, category, source, author and location URIs the searches take.
• Filters: keywords (phrase, Boolean or relevance search, in title or body), concepts, categories, sources, source locations, source groups, authors, event locations, languages, dates, sentiment range, source rank percentile, duplicates, content type and event size.
• Read only, pay per result, bring your own key.

How to use it

1. Get a NewsAPI.ai API key from your NewsAPI.ai dashboard, on a plan that covers what you need. The free tier is for evaluation only and covers the last 30 days; commercial use and the archive need a paid plan.
2. Paste the key into the API key field (stored as a secret), or set the DATA_API_KEY environment secret on the actor.
3. Pick What to read, set your conditions, and start the run. To filter by an entity, run the Lookup mode first (for example Tesla, concepts) and copy the URI it returns into Concept URIs.

A run without a key ends cleanly with a message asking for one, before any request is sent.

Input

Field	What it does
What to read	Article search (default), event search, breaking events, event details, articles about an event, article details, newest articles stream, newest events stream, or lookup.
Keywords, Keyword match, Keyword location, Keyword search mode	Words or phrases, all or any, in body or title, as phrases, Boolean queries or a relevance search.
Concept URIs, Concept match	Entities and topics as Wikipedia URIs, all or any.
Category URIs, Category match	Categories such as news/Business.
Sources, Source locations, Source groups, Author URIs, Locations	Who published, where they are based, who wrote it, where it happened.
Languages	ISO 639-3 codes such as eng or deu, up to 5.
Keywords to exclude, Sources to exclude	Negative conditions for article and event search.
Start date, End date, Recent data window	Date range, or limit the search to the last 7 or 31 days to save tokens.
Article sort order, Event sort order, Sort ascending	Date, relevance, source importance or rank; event date, relevance or size.
Content types, Duplicates, Articles with or without an event, Source rank percentiles	Article filters.
Minimum and maximum sentiment	From -1 to 1 (English only).
Minimum and maximum articles per event	Event size filters.
Minimum breaking score	Breaking events threshold.
Minutes back	Stream window, up to 240 minutes.
Event URIs, Include duplicate articles, Article URIs	Reads by URI.
Lookup type, Lookup terms	What to look up and the names to look up.
Article body length, Include concepts, categories, location, social score, Event image count	How much detail each row carries.
Maximum results	Row cap for the whole run.
Requests per minute	Pacing.
API key	Your NewsAPI.ai API key, as a secret.

Access and limits on the provider side

• Each search request uses tokens from your NewsAPI.ai plan, whatever the number of results; searches over older data use more. The actor reports the tokens the provider says it used at the end of the run. Use the recent data window to keep searches cheap.
• Searches return up to 100 articles or 50 events a page and the actor follows the pages until your maximum; the streams return up to 2000 items in one request.
• A refused key, a spent token balance or a disabled account ends the run cleanly with a message saying which it was.
• A request that matches nothing returns one free row with found set to false and a note, so you can tell an empty result from a failed one.
• Terms: the NewsAPI.ai terms of service govern the data. Free access is for testing only, with no commercial use. A paid plan grants a non-transferable licence for your own use; the terms forbid sharing, selling, sublicensing or redistributing the data, republishing article content without the rights from the original publisher, and building a competing news aggregation or event detection service. Article text belongs to the publishers, so keep the full body for your own analysis or set a short body length. This actor does not change those terms.

FAQ

What is the Event Registry API?

Event Registry, sold as NewsAPI.ai, is a news intelligence service based in Ljubljana, Slovenia. It collects articles from news sources worldwide, groups them into events, and tags them with concepts, categories, sentiment and locations. Its API at eventregistry.org serves article and event search, event and article details, breaking events and minute streams, documented at newsapi.ai/documentation. This actor wraps those read routes. The docs, the official Python SDK and the live host were checked on 2026-10-07.

What is the difference between an article and an event?

An article is one story from one source. An event is a cluster of articles, often in several languages and from hundreds of sources, about the same real-world happening, with its own title, summary, date and article count. Event search is the quickest way to see what happened; article search gives you the individual stories.

How do I track news about a company or person?

Run the lookup mode with the name and lookup type concepts, copy the URI (for example http://en.wikipedia.org/wiki/Tesla,_Inc.), then run article search or event search with that URI in Concept URIs. Concept search matches the entity itself, not just the word, so it skips unrelated mentions.

How do I monitor news in near real time?

Schedule the newest articles stream or newest events stream every few minutes with the same filters and set minutes back to cover the gap between runs. Each run returns what was added in that window.

Do I need a NewsAPI.ai account?

Yes. This actor is bring-your-own-key and never ships one. Use the API key from your NewsAPI.ai dashboard. A missing or refused key ends the run cleanly with a message saying which it was.

Is my key safe?

The key is sent in the body of each request as the apiKey field the provider documents, never in a URL, is never logged, and is stripped from any error text.

How is it priced?

Pay per result: a low price per lookup candidate, more per article, and the most per event, since one event row summarises many articles. Requests that find nothing are free. Your NewsAPI.ai plan and its tokens apply separately.

Example output

{
  "mode": "events",
  "modeLabel": "Event search",
  "recordType": "event",
  "identifier": null,
  "found": true,
  "uri": "eng-2940883",
  "title": "White House says Obama will make 5th visit to Germany, take in trade show",
  "date": "2016-04-24",
  "source": null,
  "lang": "deu",
  "sentiment": -0.2,
  "articleCount": 100,
  "url": null,
  "titles": {
    "deu": "Obama kommt zur Eroeffnung der Hannover Messe",
    "eng": "White House says Obama will make 5th visit to Germany, take in trade show"
  },
  "summary": "The White House says President Barack Obama will travel to Germany in late April to attend the world's largest trade show for industrial technology.",
  "eventDate": "2016-04-24",
  "totalArticleCount": 100,
  "articleCounts": { "deu": 82, "eng": 18 },
  "socialScore": 91.4,
  "conceptLabels": ["Barack Obama", "Germany", "Hanover Fair"],
  "categoryLabels": ["news/Politics"],
  "locationLabel": "Hanover",
  "retrievedAt": "2026-10-07T09:14:52.118Z",
  "note": null
}

Values are illustrative and follow the provider's documented event data model. Article rows carry uri, title, body, url, source, authorNames, lang, dateTimePub, sentiment, eventUri, conceptLabels and categoryLabels; lookup rows carry uri, title and lookupType.

Keyword map

news API, global news API, news events API, breaking news API, real time news feed, news monitoring, media monitoring data, entity news search, company news tracking, news sentiment API, event detection data, multilingual news search, press release search, blog search, news clustering, Event Registry API, NewsAPI.ai export.