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: value: news: - summary: '...' image: https://www.amnesty.org/en/wp-content/uploads/2021/06/272748-1024x433.jpg sentiment: -0.176 language: en title: While China and the US squabble, the world’s debt and climate crises worsen - Amnesty International url: https://www.amnesty.org/en/latest/news/2020/09/while-china-and-the-us-squabble-the-world-debt-and-climate-crises-worsen/ source_country: mx id: 2352 text: '...' category: politics publish_date: '2020-09-11 18:05:26' authors: - Amnesty International - William Nee - summary: '...' image: https://www.amnesty.org/en/wp-content/uploads/2021/06/264281-1024x433.jpg sentiment: -0.449 language: en title: Sexual violence against Hong Kong protesters – what’s going on? - Amnesty International url: https://www.amnesty.org/en/latest/news/2019/12/sexual-violence-against-hong-kong-protesters/ source_country: mx id: 2354 text: '...' category: politics publish_date: '2019-12-20 11:14:17' authors: - Amnesty International '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: ids description: A comma separated list of news ids. schema: pattern: . maxLength: 10000 type: string example: 2352,2354 required: true style: form explode: false in: query externalDocs: description: Read entire docs url: https://worldnewsapi.com/docs/retrieve-news/ summary: Retrieve News Articles by Ids tags: - News description: Retrieve information about one or more news articles by their ids. The ids can be retrieved from the search news or top news APIs. operationId: retrieveNewsArticlesByIds deprecated: false /extract-news: get: responses: '200': description: Success headers: {} content: application/json: schema: type: object properties: title: type: - string - 'null' text: type: - string - 'null' url: type: - string - 'null' image: type: - string - 'null' images: type: array items: type: object properties: width: type: integer title: type: - string - 'null' url: type: - string - 'null' height: type: integer video: type: - string - 'null' videos: type: array items: type: object properties: summary: type: - string - 'null' duration: type: integer thumbnail: type: - string - 'null' title: type: - string - 'null' url: type: - string - 'null' publish_date: type: - string - 'null' author: type: - string - 'null' authors: type: array items: type: - string - 'null' language: type: - string - 'null' examples: Response: value: title: Known terrorist spent year in US after being wrongly released by feds — and GOP lawmakers demand answers text: 'A Somali terrorist was allowed into the country and was able to operate freely for almost a year before authorities realized their error and rearrested him. Republican lawmakers are demanding information from Homeland Security Secretary Alejandro Mayorkas about what happened to the man — and whether US citizens funded any part of his journey to or stay in the US. The 27-year-old Somalian — who so far has not been identified by name — was on the watchlist as “a confirmed member of al Shabaab” involved in the use, manufacture or transportation of explosives or firearms, but a border bungle meant he was released after initially being arrested for crossing into the country illegally in California in March 2023. A letter from Republican lawmakers seeks to find the al-Shabaab member’s path from illegally crossing the border to Minnesota, were he was eventually rearrested in January, and whether he received any government benefits. It also seeks to find if he took a commercial flight with US citizens to reach their state and if his travel was funded with taxpayer dollars, according to the Tuesday letter, first obtained by The Post. The letter states: “Due to Minnesota’s far distance from the border, it is not an easy task for migrants to travel to the state … “Did the al-Shabbab terrorist travel to Minnesota with the assistance, either direct or indirect of an [Non-Governmental Organization]? If so, which NGO was responsible for transporting the individual to Minnesota?” The terrorist organization member had initially crossed into California and been arrested by the Border Patrol. However, the Terrorist Screening Center determined he was a “mismatch” to the terror watchlist, leading to his release. Nearly a year later, Immigration and Customs Enforcement (ICE) nabbed him after federal authorities made a “redetermination” and realized he was associated with the Somalian militant group. Al-Shabaab was formed as the militant wing of the Somali Council of Islamic Courts, which controlled the southern part of the country in late 2006. Its rule was defeated in 2007, according to the Office of the Director of National Intelligence, but it has since operated as an underground network and is involved in wars in and around Somalia. It was designated a terrorist organization in 2008 by the US government and is notorious for carrying out bombings and suicide attacks. In 2013, al-Shabaab was responsible for a massacre at the Westgate mall in Kenya, killing 67 individuals. US forces have conducted six strikes in Somalia against al-Shabaab already this year, killing two dozen militants in the latest actions, according to CNN. In a February press conference, ICE Acting Director Patrick Lechleitner said his agency arrested the individual “within 48 hours” of learning his true identity. “The Biden administration’s open-borders agenda allowed a known terrorist to roam freely throughout our state, and now they must answer for their inexcusable negligence,” House Majority Whip Tom Emmer (R-Minn.) said in a statement to The Post regarding the probe. The Border Patrol has recorded an ever-growing number of migrants listed on the terror watchlist attempting to enter the US illegally in recent years. Between October 2023 and February, agents have already recorded 70 encounters at both the southern and northern borders, according to federal data. There were 172 such encounters recorded in fiscal year 2023, which ran from October 2022 to September 2023, 98 in fiscal year 2022, 16 in fiscal year 2021 and 14 between fiscal years 2017 and 2020. In March, Border Patrol agents apprehended Lebanese national Basel Bassel Ebbadi, 22, who told personnel that he came to the US “to try to make a bomb,” according to internal federal documents first obtained by The Post. Ebbadi admitted to a border agent that he is a member of Hezbollah and was later confirmed as a “positive match” on the terror watchlist.' url: https://nypost.com/2024/04/02/us-news/lawmakers-demand-to-know-if-taxpayers-funded-al-shabaab-terrorist/ image: https://nypost.com/wp-content/uploads/sites/2/2024/04/al-shabaab-terrorist-migrant-border-crossing-california-minnesota-mayorkas-comp-02.jpg?quality=75&strip=all&w=1200 images: - width: 879 title: Masked al-Shabaab members hold up weapons url: https://nypost.com/wp-content/uploads/sites/2/2024/04/2010-somalias-hardline-islamist-rebel-39796525.jpg?w=1024 height: 590 - width: 787 title: Members of al-Shabaab url: https://nypost.com/wp-content/uploads/sites/2/2024/04/2010-al-shabaab-said-friday-39807171.jpg?w=1024 height: 590 - width: 943 title: Border Patrol agents apprehend migrants url: https://nypost.com/wp-content/uploads/sites/2/2024/04/migrants-placed-vans-u-s-78334041.jpg?w=1024 height: 590 - width: 885 title: Migrants await to be transported by Border Patrol agents url: https://nypost.com/wp-content/uploads/sites/2/2024/04/asylum-seeking-migrants-stand-line-71972565.jpg?w=1024 height: 590 - width: 885 title: Border Patrol vehicle url: https://nypost.com/wp-content/uploads/sites/2/2024/04/u-s-border-patrol-vehicle-56717052.jpg?w=1024 height: 590 - width: 1200 url: https://nypost.com/wp-content/uploads/sites/2/2024/04/al-shabaab-terrorist-migrant-border-crossing-california-minnesota-mayorkas-comp-02.jpg?quality=75&strip=all&w=1200 height: 800 video: https://cdn.jwplayer.com/videos/Den1Nq47-RyIcpnTz.mp4 videos: - summary: 'Today''s Video Headlines: 4/2/24' duration: 61 thumbnail: https://cdn.jwplayer.com/v2/media/Den1Nq47/poster.jpg?width=720 title: Today's Video Headlines url: https://cdn.jwplayer.com/videos/Den1Nq47-RyIcpnTz.mp4 publish_date: '2024-04-02 17:13:12' author: Jennie Taer authors: - Jennie Taer 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: url description: The url of the news. schema: pattern: . maxLength: 1000 type: string example: https://www.bbc.com/news/world-us-canada-59340789 required: true style: form explode: false in: query - name: analyze description: Whether to analyze the extracted news (extract entities, detect sentiment etc.) schema: type: boolean example: true required: false style: form explode: false in: query externalDocs: description: Read entire docs url: https://worldnewsapi.com/docs/extract-news/ summary: Extract News tags: - News description: Extract a news article from a website to a well structure JSON object. The API will return the title, text, URL, images, videos, publish date, authors, language, source country, and sentiment of the news article. operationId: extractNews deprecated: false /extract-news-links: get: responses: '200': description: Success headers: {} content: application/json: schema: type: object properties: news_links: type: array items: type: - string - 'null' examples: Response: value: news_links: - https://www.nytimes.com/2023/10/07/opinion/wnba-liberty-championship.html - https://www.nytimes.com/2023/10/08/business/economy/labor-strikes.html - https://www.nytimes.com/2023/10/08/dining/sunday-calls-for-old-fashioned-beef-stew.html '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: url description: The url of the news. schema: pattern: . maxLength: 1000 type: string example: https://www.bbc.com/news/world-us-canada-59340789 required: true style: form explode: false in: query - name: analyze description: Whether to analyze the extracted news (extract entities, detect sentiment etc.) schema: type: boolean example: true required: false style: form explode: false in: query externalDocs: description: Read entire docs url: https://worldnewsapi.com/docs/extract-news-links/ summary: Extract News Links tags: - News description: Extract news links from a news website. operationId: extractNewsLinks deprecated: false /search-news-sources: get: responses: '200': description: Success headers: {} content: application/json: schema: type: object properties: available: type: integer sources: type: array items: type: object properties: name: type: - string - 'null' url: type: - string - 'null' language: type: - string - 'null' examples: Response: value: available: 2 sources: - name: BBC News url: https://www.bbc.co.uk language: en - name: Home - BBC News url: https://www.bbc.com 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: name description: The (partial) name of the source. schema: pattern: . maxLength: 1000 type: string example: bbc required: true style: form explode: false in: query externalDocs: description: Read entire docs url: https://worldnewsapi.com/docs/search-news-sources/ summary: Search News Sources tags: - News description: Search whether a news source is being monitored by the World News API. This API is useful if you want to know if a specific news source is available in the API. operationId: searchNewsSources deprecated: false /feed.rss: get: responses: '200': description: Success headers: {} content: application/xml: schema: type: object '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: url description: The url of the site for which an RSS feed should be created. schema: pattern: . maxLength: 1000 type: string example: https://www.bbc.com/ required: true style: form explode: false in: query - name: extract-news description: Whether to extract the news for each link instead of just returning the link. schema: type: boolean example: true required: false style: form explode: false in: query externalDocs: description: Read entire docs url: https://worldnewsapi.com/docs/website-to-rss-feed/ summary: News Website to RSS Feed tags: - News description: Turn a news website into an RSS feed. Any page of a news website can be turned into an RSS feed. Provide the URL to the page and the API will return an RSS feed with the latest news from that page. operationId: newsWebsiteToRSSFeed deprecated: false /geo-coordinates: get: responses: '200': description: Success headers: {} content: application/json: schema: type: object properties: latitude: type: number longitude: type: number city: type: - string - 'null' examples: Response: value: latitude: 35.652832 longitude: 139.839478 city: Tokyo '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: location description: The address or name of the location. schema: pattern: . maxLength: 1000 type: string example: Tokyo, Japan required: true style: form explode: false in: query externalDocs: description: Read entire docs url: https://worldnewsapi.com/docs/get-geo-coordinates/ summary: Get Geo Coordinates tags: - News description: Retrieve the latitude and longitude of a location name. Given this information you can fill the location-filter parameter in the news search endpoint. operationId: getGeoCoordinates deprecated: false components: securitySchemes: apiKey: name: api-key type: apiKey in: query headerApiKey: name: x-api-key type: apiKey in: header