>

World News API

World Wide Coverage

  • ⤷ thousands of news sources
  • ⤷ in 50+ languages
  • ⤷ from 150+ countries
  • ⤷ author extraction
  • ⤷ image, title, description, and date extraction

Semantic Tagging

  • ⤷ location extraction
  • ⤷ organization extraction
  • ⤷ person extraction
  • ⤷ news author extraction
  • ⤷ semantic search

Sentiment Analysis

  • ⤷ assign sentiment to each news
  • ⤷ filter news by sentiment

Search International News Sources

The News API searches through thousands of news outlets world wide allowing you to get multiple views on the same issue. News is indexed in real time so you will get breaking news in the API as well as historic data.

Search by Location everywhere on Earth

News texts often mention locations such as cities, neighborhoods, or points of interest. We tag these locations which allows you to search for news that mention any location within a certain area.

Semantic search and text filtering combined

Semantic search allows you to find entities without caring about the exact spelling or synonyms used. For example, finding news about the USA you can search for Location:USA and all news mentioning the USA will be returned, no matter if they talk about the "US", the "United States" or the "United States of America".

You can also search for pure text matches, phrases, or exclude words from your search.

Filter by Source Country and Language

We index news in over 50 languages from over 150 countries. With simple country and language filters you can limit your search to the exact country and language. For example, you could search for Spanish news that originate in the USA or French news from Canada.

Combining country filter with other parameters allows you to dig really deep into the news coverage, e.g. you could compare news about a polarizing topic from different countries.

Search news for within time frames

Relevance of news is often short lived but new coverage is always in the context of what happened before. The API allows you to filter news by publish time to analyze content over time, for example, to detect shifts in opinions or amounts of news coverage of a certain topic over time.

Search by Positive and Negative News Coverage

News items (currently limited to English and German) are analyzed with AI trained sentiment classifiers assigning each news an overall value between -1 (negative) and +1 (positive).

Example Use Cases

Get all news from Germany that mention Italy
source-countries=de entities=LOC:Italy
GET
https://api.worldnewsapi.com/search-news?source-countries=de&entities=LOC:Italy
Get news about COVID-19 in Spanish
language=es text=covid-19 OR corona
GET
https://api.worldnewsapi.com/search-news?language=es&text=covid-19+OR+corona
Get news mentioning Elon Musk but not Tesla
text="Elon Musk" -tesla
GET
https://api.worldnewsapi.com/search-news?text=%22Elon%20Musk%22%20-tesla&language=en
Get positive English news since April 1st
min-sentiment=0.5 earliest-publish-date=2022-04-01
GET
https://api.worldnewsapi.com/search-news?min-sentiment=0.5&earliest-publish-date=2022-04-01&language=en
Get negative news coverage from BBC
max-sentiment=-0.5 news-sources=https://www.bbc.co.uk
GET
https://api.worldnewsapi.com/search-news?max-sentiment=-0.4&news-sources=https%3A%2F%2Fwww.huffingtonpost.co.uk&language=en
Get news by author Phil Hutchinson
author=Phil Hutchinson
GET
https://api.worldnewsapi.com/search-news?authors=Phil+Hutchinson&language=en
Get all news 500 kilometers around London

First get the geo coordinates (latitude and longitude of London)

location=London, UK
GET
https://api.worldnewsapi.com/geo-coordinates?location=London%2C%20UK&language=en

Now get the news with the coordinates 500km around London.

location-filter=51.509865,-0.118092,500
GET
https://api.worldnewsapi.com/search-news?location-filter=51.509865,-0.118092,500&language=en

See the docs for full functionality.

Search Demos

Draw a circle on the map to search for news mentioning any location within that circle.

Search news by queries and filter them down.

News

#title#

#content#

#publishdate#

Reach out

We'd love to hear from you. to get answers to any questions you have or chat with the community in our Discord Chat.