World News API News API
The News API from World News API — 9 operation(s) for news.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/worldnewsapi-news-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.2.0
info:
title: World News API
description: The world's news wrapped into a single API.
termsOfService: https://worldnewsapi.com/terms
version: 2.2.0
contact:
name: David Urbansky
email: mail@worldnewsapi.com
servers:
- url: https://api.worldnewsapi.com
security:
- apiKey: []
- headerApiKey: []
tags:
- name: News
paths:
/search-news:
get:
responses:
'200':
description: Success
headers: {}
content:
application/json:
schema:
type: object
properties:
offset:
type: integer
number:
type: integer
available:
type: integer
news:
type: array
items:
type: object
properties:
summary:
type:
- string
- 'null'
image:
type:
- string
- 'null'
sentiment:
type: number
language:
type:
- string
- 'null'
video:
type:
- string
- 'null'
title:
type:
- string
- 'null'
url:
type:
- string
- 'null'
source_country:
type:
- string
- 'null'
id:
type: integer
text:
type:
- string
- 'null'
category:
type:
- string
- 'null'
publish_date:
type:
- string
- 'null'
authors:
type: array
items:
type:
- string
- 'null'
examples:
Response:
value:
offset: 0
number: 10
available: 83
news:
- summary: Twenty nine areas around Whitehouse Station, NJ, which was the epicenter of the quake, have since reported rumbles.
image: https://nypost.com/wp-content/uploads/sites/2/2024/04/79582612.jpg?quality=75&strip=all&w=1200
sentiment: -0.545
language: en
video: https://cdn.jwplayer.com/videos/70lDQJpg-RyIcpnTz.mp4
title: Nearly 30 aftershocks recorded around NJ quake epicenter since Friday
url: https://nypost.com/2024/04/06/us-news/nearly-30-aftershocks-recorded-around-nj-quake-epicenter/
source_country: us
id: 206030983
text: New Jersey continues to shake after Friday’s 4.8-magnitude earthquake and likely will continue to do so for some time. Dozens of aftershocks were recorded in the Garden State since the rare quake hit, including one tremor of 3.8 after the initial event. But residents of NYC shouldn’t expect anything beyond possibly a light shake in the coming days. Rumbles were measured in 29 nine areas around Whitehouse Station, NJ, which was the epicenter of the quake, including near Tewksbury and Bedminster, according to the United States Geological Survey. The smaller temblors hit as far as 13 miles away from the epicenter. One clocked in at 1.9 just after 1 a.m. Saturday morning just north of Whitehouse Station — about 45 miles west of NYC — and another at 2.5 just before 7 a.m. near Gladstone, northeast of the epicenter. Over the next week, there is a 74% chance of additional 3-plus magnitude aftershocks, but the USGS does not foresee more than five occurring. There is just a 14% chance of a quake clocking in at a magnitude of 4 or higher, and likely only one will come this week. Over the course of the next month, however, the chance of a 3-plus magnitude quake rises to 84%, while a the chance of a 4 or greater is 18%. It’s almost certain — 98% — that more 3-plus magnitude shakers will come in the next year, the USGS said. The nearly 30 rumbles that followed the first quake aren’t a shock to geologists, though. “We do expect aftershocks like this to occur in the days, weeks and months after the main shock, so this is fully within the realm of what is expected,” USGS research geologist Alex Hatem told The Post. The chance of NYC feeling another rattle, however, is low. A light shake could be possible in the coming days, Hatem said, but nothing like the quake that rocked the Statue of Liberty and City Hall Friday or the aftershock that rippled through later that evening. The quake grounded flights and halted traffic around the Big Apple. “Should this sequence continue as it is, which we expect it to, there won’t be anything greater than what already happened,” Hatem said. Though researchers expect earthquakes to happen “anytime, anywhere,” it is a rare occurrence for New Jersey, which doesn’t lie on an active plate boundary, Hatem said. The incident did occur, however, near the Ramapo Fault, which is an ancient crack in the Earth’s crust. Faults lie on the edges of plates and can sometimes be the site of quakes. New Jersey Gov. Phil Murphy posted on X Saturday that the state’s emergency operations center was deactivated that morning. “We have had no reports of major damage to structures, roadways, or infrastructure as a result of yesterday’s earthquake,” Murphy said. Residents in several homes in Newark were able to return to their homes Friday night after being evacuated over concerns about possible structural damage. Gov. Hochul and Mayor Adams said there were no initial reports of injuries or damage in New York, though it later emerged that the walls of a school gym in Brooklyn suffered several cracks. Engineers with the city Department of Buildings ordered the gymnasium at J.H.S. 218 in East New York shut down until repairs are made. The earthquake was the biggest for the tri-state area since 1884. The USGS recently released a study that showed that about 75% of the US that could experience a damaging earthquake in the next 100 years. Friday’s rattle should be a “gentle reminder” to those on the East Coast, however, to be prepared and familiar with “drop, cover and hold on” actions to stay safe in the event of another quake. New York City officials were blasted for emergency alerts that didn’t go out until 25 minutes after the earthquake struck. Some NYC public school alerts didn’t go out until an hour and a half after the shock — and were resent Saturday morning, telling parents that dismissal would proceed as usual.
category: environment
publish_date: '2024-04-06 22:44:18'
authors:
- Deirdre Bardolf
'401':
description: Unauthorized
'402':
description: Payment Required
'403':
description: Forbidden
'404':
description: Not Found
'406':
description: Not Acceptable
'429':
description: Too Many Requests
parameters:
- name: text
description: The text to match in the news content (at least 3 characters, maximum 100 characters). By default all query terms are expected, you can use an uppercase OR to search for any terms, e.g. tesla OR ford. You can also exclude terms by putting a minus sign (-) in front of the term, e.g. tesla -ford. For exact matches just put your term in quotes, e.g. "elon musk".
schema:
pattern: .
maxLength: 100
type: string
example: tesla
required: false
style: form
explode: false
in: query
- name: text-match-indexes
description: If a "text" is given to search for, you can specify where this text is searched for. Possible values are title, content, or both separated by a comma. By default, both title and content are searched.
schema:
pattern: .
maxLength: 100
type: string
example: title,content
required: false
style: form
explode: false
in: query
- name: source-country
description: The ISO 3166 country code from which the news should originate.
schema:
pattern: .
maxLength: 2
type: string
example: us
required: false
style: form
explode: false
in: query
- name: language
description: The ISO 6391 language code of the news.
schema:
pattern: .
maxLength: 2
type: string
example: en
required: false
style: form
explode: false
in: query
- name: min-sentiment
description: The minimal sentiment of the news in range [-1,1].
schema:
format: double
minimum: -1
maximum: 1
type: number
example: -0.8
required: false
style: form
explode: false
in: query
- name: max-sentiment
description: The maximal sentiment of the news in range [-1,1].
schema:
format: double
minimum: -1
maximum: 1
type: number
example: 0.8
required: false
style: form
explode: false
in: query
- name: earliest-publish-date
description: The news must have been published after this date.
schema:
pattern: .
maxLength: 19
type: string
example: '2022-04-22 16:12:35'
required: false
style: form
explode: false
in: query
- name: latest-publish-date
description: The news must have been published before this date.
schema:
pattern: .
maxLength: 19
type: string
example: '2022-04-22 16:12:35'
required: false
style: form
explode: false
in: query
- name: news-sources
description: A comma-separated list of news sources from which the news should originate.
schema:
pattern: .
maxLength: 10000
type: string
example: https://www.bbc.co.uk
required: false
style: form
explode: false
in: query
- name: authors
description: A comma-separated list of author names. Only news from any of the given authors will be returned.
schema:
pattern: .
maxLength: 300
type: string
example: John Doe
required: false
style: form
explode: false
in: query
- name: categories
description: A comma-separated list of categories. Only news from any of the given categories will be returned. Possible categories are politics, sports, business, technology, entertainment, health, science, lifestyle, travel, culture, education, environment, other. Please note that the filter might leave out news, especially in non-English languages. If too few results are returned, use the text parameter instead.
schema:
pattern: .
maxLength: 300
type: string
example: politics,sports
required: false
style: form
explode: false
in: query
- name: entities
description: Filter news by entities (see semantic types).
schema:
pattern: .
maxLength: 10000
type: string
example: ORG:Tesla,PER:Elon Musk
required: false
style: form
explode: false
in: query
- name: location-filter
description: Filter news by radius around a certain location. Format is "latitude,longitude,radius in kilometers". Radius must be between 1 and 100 kilometers.
schema:
pattern: .
maxLength: 100
type: string
example: 51.050407, 13.737262, 20
required: false
style: form
explode: false
in: query
- name: sort
description: The sorting criteria (publish-time).
schema:
pattern: .
maxLength: 100
type: string
example: publish-time
required: false
style: form
explode: false
in: query
- name: sort-direction
description: Whether to sort ascending or descending (ASC or DESC).
schema:
pattern: .
maxLength: 4
type: string
example: ASC
required: false
style: form
explode: false
in: query
- name: offset
description: The number of news to skip in range [0,100000]
schema:
format: int32
minimum: 0
maximum: 10000
type: integer
example: 0
required: false
style: form
explode: false
in: query
- name: number
description: The number of news to return in range [1,100]
schema:
format: int32
minimum: 1
maximum: 100
type: integer
example: 10
required: false
style: form
explode: false
in: query
externalDocs:
description: Read entire docs
url: https://worldnewsapi.com/docs/search-news/
summary: Search News
tags:
- News
description: Search and filter news by text, date, location, category, language, and more. The API returns a list of news articles matching the given criteria. Each returned article includes the title, the full text of the article, a summary, image URL, video URL, the publish date, the authors, the category, the language, the source country, and the sentiment of the article. You can set as many filtering parameters as you like, but you have to set at least one, e.g. text or language.
operationId: searchNews
deprecated: false
/top-news:
get:
responses:
'200':
description: Success
headers: {}
content:
application/json:
schema:
type: object
properties:
top_news:
type: array
items:
type: object
properties:
news:
type: array
items:
type: object
properties:
summary:
type:
- string
- 'null'
image:
type:
- string
- 'null'
author:
type:
- string
- 'null'
id:
type: integer
text:
type:
- string
- 'null'
title:
type:
- string
- 'null'
publish_date:
type:
- string
- 'null'
url:
type:
- string
- 'null'
authors:
type: array
items:
type:
- string
- 'null'
language:
type:
- string
- 'null'
country:
type:
- string
- 'null'
examples:
Response:
value:
top_news:
- news:
- summary: '...'
image: https://politicalwire.com/wp-content/uploads/2018/02/PW-podcast-logo.jpg
author: Taegan Goddard
id: 224767206
text: '...'
title: Jury to Begin Deliberations In Trump Trial
publish_date: '2024-05-29 00:10:48'
url: https://politicalwire.com/2024/05/28/jury-to-begin-deliberations-in-trump-trial/
authors:
- Taegan Goddard
- summary: '...'
image: https://dims.apnews.com/dims4/default/3446536/2147483647/strip/true/crop/6195x3485+0+323/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fec%2Fd5%2Ff56fdc38f86e38b6217b50083d19%2Fd5ef4afe1cb64825be1349de8fd40df0
id: 224839780
text: '...'
title: Jury in Donald Trump's hush money case to begin deliberations
publish_date: '2024-05-29 04:30:08'
url: https://apnews.com/article/trump-trial-deliberations-jury-judge-verdict-390f045e9e8a37f069e82576edd7a842
authors: []
- summary: '...'
image: https://whdh.com/wp-content/uploads/sites/3/2024/05/WHDH_2024-05-27_15h27-33-cover.jpg?quality=60&strip=color
id: 224936214
text: '...'
title: Jury in Trump's hush money case to begin deliberations after hearing instructions from judge
publish_date: '2024-05-29 08:47:26'
url: https://whdh.com/news/jury-in-trumps-hush-money-case-to-begin-deliberations-after-hearing-instructions-from-judge/
authors: []
- summary: '...'
image: https://assets3.cbsnewsstatic.com/hub/i/r/2024/05/29/66524a85-576c-4c40-94ba-cfb04cbb7950/thumbnail/1200x630g3/d2d9c8ea35b659db292c371bdc0a47e8/gettyimages-2154550679.jpg?v=c5044be0004eac09882c007ac02fef6d
id: 224956968
text: '...'
video: https://prod.vodvideo.cbsnews.com/cbsnews/vr/hls/2942696_hls/master.m3u8
title: Trump trial jury set to begin deliberating verdict today after judge issues instructions
publish_date: '2024-05-29 10:00:18'
url: https://www.cbsnews.com/live-updates/trump-trial-verdict-jury-deliberations-judge-instructions/
authors: []
- summary: '...'
image: https://static01.nyt.com/images/2024/05/29/multimedia/29trump-trial-pinned-qzmh/29trump-trial-pinned-qzmh-facebookJumbo-v2.jpg
id: 224957034
text: '...'
title: Jury in Trump’s Hush-Money Trial to Begin Deliberations on Wednesday
publish_date: '2024-05-29 10:12:08'
url: https://www.nytimes.com/2024/05/29/nyregion/trump-trial-jury-charges.html
authors: []
- summary: '...'
image: https://a57.foxnews.com/static.foxnews.com/foxnews.com/content/uploads/2024/05/931/524/judge-trump.png?ve=1&tl=1
id: 224961802
text: '...'
title: Jury to begin deliberations in Trump trial and more top headlines
publish_date: '2024-05-29 10:22:36'
url: https://www.foxnews.com/us/judge-outline-framework-jury-trial-decide-trumps-fate-more-top-headlines
authors: []
- news:
- image: https://cdn.vox-cdn.com/thumbor/WBEMdSSOD_jHJGnNV7hLX88zANk=/0x444:5601x3376/fit-in/1200x630/cdn.vox-cdn.com/uploads/chorus_asset/file/25469085/2152809074.jpg
author: Brendan Porath
id: 225109966
text: '...'
title: Scottie Scheffler PGA Championship charges set to get dropped
publish_date: '2024-05-29 15:24:34'
url: https://www.sbnation.com/golf/2024/5/29/24167024/scottie-scheffler-pga-championship-louisville-police-drop-charges
authors:
- Brendan Porath
- summary: '...'
image: https://www.pilotonline.com/wp-content/uploads/2024/05/Scheffler_Arrest_Golf_86723_6d56d8.jpg?w=1024
id: 225118216
text: '...'
title: Charges against world’s top golfer Scottie Scheffler dropped after arrest outside PGA Championship
publish_date: '2024-05-29 17:05:55'
url: https://www.pilotonline.com/2024/05/29/charges-against-worlds-top-golfer-scottie-scheffler-dropped-after-arrest-outside-pga-championship/
authors: []
- summary: '...'
image: https://www.twincities.com/wp-content/uploads/2024/05/Scheffler_Arrest_Golf_86723_6d56d8.jpg?w=1024
id: 225118304
text: '...'
title: Charges against world’s top golfer Scottie Scheffler dropped after arrest outside PGA Championship
publish_date: '2024-05-29 17:05:55'
url: https://www.twincities.com/2024/05/29/charges-against-worlds-top-golfer-scottie-scheffler-dropped-after-arrest-outside-pga-championship/
authors: []
- summary: '...'
image: https://wsvn.com/wp-content/uploads/sites/2/2024/04/240414_Scottie_Scheffler.jpg?quality=60&strip=color
id: 225119550
text: '...'
title: Charges against world's top golfer Scottie Scheffler dropped after arrest outside PGA Championship
publish_date: '2024-05-29 17:10:09'
url: https://wsvn.com/sports/charges-against-worlds-top-golfer-scottie-scheffler-dropped-after-arrest-outside-pga-championship/
authors: []
- news:
- summary: '...'
image: https://media.nbcwashington.com/2019/09/AP163564666366.jpg?quality=85&strip=all&fit=722%2C406
id: 225012756
text: '...'
title: Pandas to return to DC's National Zoo
publish_date: '2024-05-29 12:37:10'
url: https://www.nbcwashington.com/news/local/national-zoo-expected-to-make-announcement-about-panda-program/3627045/
authors: []
- summary: '...'
image: https://dims.apnews.com/dims4/default/1f5b9aa/2147483647/strip/true/crop/3382x1902+0+176/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fc4%2F1e%2F69094cc265243956d243348db814%2F71b160bbb0204eb594474a4934fb0df6
id: 225017360
text: '...'
title: Giant pandas are returning to D.C.'s National Zoo
publish_date: '2024-05-29 12:51:08'
url: https://apnews.com/article/giant-pandas-washington-zoo-china-764f8016d98c01ab579bdbb6dcc3dd6b
authors: []
- summary: '...'
image: https://www.baltimoresun.com/wp-content/uploads/2024/05/Giant_Pandas_89303.jpg?w=1024
id: 225017634
text: '...'
title: 2 new giant pandas are returning to Washington’s National Zoo from China by the end of the year
publish_date: '2024-05-29 12:52:08'
url: https://www.baltimoresun.com/2024/05/29/2-new-giant-pandas-are-returning-to-washingtons-national-zoo-from-china-by-the-end-of-the-year/
authors: []
language: en
country: us
'401':
description: Unauthorized
'402':
description: Payment Required
'403':
description: Forbidden
'404':
description: Not Found
'406':
description: Not Acceptable
'429':
description: Too Many Requests
parameters:
- name: source-country
description: The ISO 3166 country code of the country for which top news should be retrieved.
schema:
pattern: .
maxLength: 2
type: string
example: us
required: true
style: form
explode: false
in: query
- name: language
description: The ISO 6391 language code of the top news. The language must be one spoken in the source-country.
schema:
pattern: .
maxLength: 2
type: string
example: en
required: true
style: form
explode: false
in: query
- name: date
description: The date for which the top news should be retrieved. If no date is given, the current day is assumed.
schema:
pattern: .
maxLength: 10
type: string
example: '2024-05-30'
required: false
style: form
explode: false
in: query
- name: headlines-only
description: Whether to only return basic information such as id, title, and url of the news.
schema:
type: boolean
example: false
required: false
style: form
explode: false
in: query
externalDocs:
description: Read entire docs
url: https://worldnewsapi.com/docs/top-news/
summary: Top News
tags:
- News
description: Get the top news from a country in a language for a specific date. The top news are clustered from multiple sources in the given country. The more news in a cluster the higher the cluster is ranked.
operationId: topNews
deprecated: false
/retrieve-front-page:
get:
responses:
'200':
description: Success
headers: {}
content:
application/json:
schema:
type: object
properties:
front_page:
type: object
properties:
name:
type:
- string
- 'null'
date:
type:
- string
- 'null'
country:
type:
- string
- 'null'
image:
type:
- string
- 'null'
language:
type:
- string
- 'null'
examples:
Response:
value:
front_page:
name: Herald Sun
date: '2024-07-09'
country: au
image: https://img.worldnewsapi.com/front-pages/herald-sun-2024-07-09-ota3mg51.jpg
language: en
'401':
description: Unauthorized
'402':
description: Payment Required
'403':
description: Forbidden
'404':
description: Not Found
'406':
description: Not Acceptable
'429':
description: Too Many Requests
parameters:
- name: source-country
description: The ISO 3166 country code of the newspaper publication.
schema:
pattern: .
maxLength: 2
type: string
example: au
required: false
style: form
explode: false
in: query
- name: source-name
description: The identifier of the publication see attached list.
schema:
pattern: .
maxLength: 100
type: string
example: herald-sun
required: false
style: form
explode: false
in: query
- name: date
description: The date for which the front page should be retrieved. You can also go into the past, the earliest date is 2024-07-09.
schema:
pattern: .
maxLength: 10
type: string
example: '2024-07-09'
required: false
style: form
explode: false
in: query
externalDocs:
description: Read entire docs
url: https://worldnewsapi.com/docs/newspaper-front-pages/
summary: Retrieve Newspaper Front Page
tags:
- News
description: 'Get the front pages of newspapers from around the world. The API provides images of the front pages of newspapers from different countries. Here''s an example of some of today''s newspapers:'
operationId: retrieveNewspaperFrontPage
deprecated: false
/retrieve-news:
get:
responses:
'200':
description: Success
headers: {}
content:
application/json:
schema:
type: object
properties:
news:
type: array
items:
type: object
properties:
summary:
type:
- string
- 'null'
image:
type:
- string
- 'null'
sentiment:
type: number
language:
type:
- string
- 'null'
title:
type:
- string
- 'null'
url:
type:
- string
- 'null'
source_country:
type:
- string
- 'null'
id:
type: integer
text:
type:
- string
- 'null'
category:
type:
- string
- 'null'
publish_date:
type:
- string
- 'null'
authors:
type: array
items:
type:
- string
- 'null'
examples:
Response:
# --- truncated at 32 KB (52 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/worldnewsapi/refs/heads/main/openapi/worldnewsapi-news-api-openapi.yml