← Tools Reference

World News API

World News API integration (Data, Social). Imported from open-connector.

API key5 toolshttps://api.worldnewsapi.com
GET
world_news_api_search_news
Search news articles with World News API using the first-pass filtering subset.

/search-news

16 parameters
ParamTypeRequiredDescription
textstringoptionalKeywords or phrases used to search matching articles.
languagestringoptionalThe language code used to filter matching articles.
sourceCountriesstringoptionalA comma-separated list of source country codes used to filter matching articles.
categoriesstringoptionalA comma-separated list of categories used to filter matching articles.
earliestPublishDatestringoptionalThe earliest publish date or timestamp accepted by World News API.
latestPublishDatestringoptionalThe latest publish date or timestamp accepted by World News API.
newsSourcesstringoptionalA comma-separated list of source URLs used to filter matching articles.
authorsstringoptionalA comma-separated list of author names used to filter matching articles.
locationFilterstringoptionalA latitude,longitude,radius filter used to constrain matching articles by locat…
entitiesstringoptionalA comma-separated list of entity filters accepted by World News API.
sortstringoptionalThe sorting mode used for the article search request.
sortDirectionstringoptionalThe sort direction used for the article search request.
minSentimentnumberoptionalThe minimum sentiment score accepted for matching articles.
maxSentimentnumberoptionalThe maximum sentiment score accepted for matching articles.
offsetintegeroptionalThe zero-based result offset for pagination.
numberintegeroptionalThe maximum number of articles to return.
GET
world_news_api_get_top_news
Retrieve top-news clusters for one source country and optional language or date filters.

/top-news

3 parameters
ParamTypeRequiredDescription
sourceCountrystringrequiredThe source country code used to retrieve top news.
languagestringoptionalThe language code used to retrieve top news.
datestringoptionalThe calendar date used to retrieve top news in YYYY-MM-DD format.
GET
world_news_api_retrieve_news
Retrieve one or more articles by identifier from World News API.

/retrieve-news

1 parameter
ParamTypeRequiredDescription
idsarrayrequiredThe article identifiers to retrieve.
GET
world_news_api_search_news_sources
Search World News API sources by name, language, or source country.

/search-news-sources

3 parameters
ParamTypeRequiredDescription
namestringoptionalThe source name used to search matching news sources.
languagestringoptionalThe language code used to filter matching news sources.
sourceCountrystringoptionalThe source country code used to filter matching news sources.
GET
world_news_api_get_geo_coordinates
Resolve a location string to latitude and longitude with World News API.

/geo-coordinates

2 parameters
ParamTypeRequiredDescription
locationstringrequiredThe location text to geocode.
languagestringoptionalThe language code used to localize the geocoding response.