{ "openapi": "3.0.0", "info": { "contact": { "email": "mail@worldnewsapi.com", "name": "David Urbansky" }, "description": "The world's news wrapped into a single API.", "termsOfService": "https://worldnewsapi.com/terms", "title": "World News API", "version": "2.2.0" }, "servers": [ { "url": "https://api.worldnewsapi.com" } ], "security": [ { "apiKey": [] }, { "headerApiKey": [] } ], "paths": { "/search-news": { "get": { "deprecated": false, "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.", "externalDocs": { "description": "Read entire docs", "url": "https://worldnewsapi.com/docs/search-news/" }, "operationId": "searchNews", "parameters": [ { "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\".", "explode": false, "in": "query", "name": "text", "required": false, "schema": { "example": "tesla", "maxLength": 100, "pattern": ".", "type": "string" }, "style": "form" }, { "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.", "explode": false, "in": "query", "name": "text-match-indexes", "required": false, "schema": { "example": "title,content", "maxLength": 100, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "The ISO 3166 country code from which the news should originate.", "explode": false, "in": "query", "name": "source-country", "required": false, "schema": { "example": "us", "maxLength": 2, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "The ISO 6391 language code of the news.", "explode": false, "in": "query", "name": "language", "required": false, "schema": { "example": "en", "maxLength": 2, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "The minimal sentiment of the news in range [-1,1].", "explode": false, "in": "query", "name": "min-sentiment", "required": false, "schema": { "example": -0.8, "format": "double", "maximum": 1, "minimum": -1, "type": "number" }, "style": "form" }, { "description": "The maximal sentiment of the news in range [-1,1].", "explode": false, "in": "query", "name": "max-sentiment", "required": false, "schema": { "example": 0.8, "format": "double", "maximum": 1, "minimum": -1, "type": "number" }, "style": "form" }, { "description": "The news must have been published after this date.", "explode": false, "in": "query", "name": "earliest-publish-date", "required": false, "schema": { "example": "2022-04-22T16:12:35.000Z", "maxLength": 19, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "The news must have been published before this date.", "explode": false, "in": "query", "name": "latest-publish-date", "required": false, "schema": { "example": "2022-04-22T16:12:35.000Z", "maxLength": 19, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "A comma-separated list of news sources from which the news should originate.", "explode": false, "in": "query", "name": "news-sources", "required": false, "schema": { "example": "https://www.bbc.co.uk", "maxLength": 10000, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "A comma-separated list of author names. Only news from any of the given authors will be returned.", "explode": false, "in": "query", "name": "authors", "required": false, "schema": { "example": "John Doe", "maxLength": 300, "pattern": ".", "type": "string" }, "style": "form" }, { "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.", "explode": false, "in": "query", "name": "categories", "required": false, "schema": { "example": "politics,sports", "maxLength": 300, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "Filter news by entities (see semantic types).", "explode": false, "in": "query", "name": "entities", "required": false, "schema": { "example": "ORG:Tesla,PER:Elon Musk", "maxLength": 10000, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "Filter news by radius around a certain location. Format is \"latitude,longitude,radius in kilometers\". Radius must be between 1 and 100 kilometers.", "explode": false, "in": "query", "name": "location-filter", "required": false, "schema": { "example": "51.050407, 13.737262, 20", "maxLength": 100, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "The sorting criteria (publish-time).", "explode": false, "in": "query", "name": "sort", "required": false, "schema": { "example": "publish-time", "maxLength": 100, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "Whether to sort ascending or descending (ASC or DESC).", "explode": false, "in": "query", "name": "sort-direction", "required": false, "schema": { "example": "ASC", "maxLength": 4, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "The number of news to skip in range [0,100000]", "explode": false, "in": "query", "name": "offset", "required": false, "schema": { "example": 0, "format": "int32", "maximum": 10000, "minimum": 0, "type": "integer" }, "style": "form" }, { "description": "The number of news to return in range [1,100]", "explode": false, "in": "query", "name": "number", "required": false, "schema": { "example": 10, "format": "int32", "maximum": 100, "minimum": 1, "type": "integer" }, "style": "form" } ], "responses": { "200": { "content": { "application/json": { "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-06T22:44:18.000Z", "authors": [ "Deirdre Bardolf" ] } ] } } }, "schema": { "$ref": "#/components/schemas/searchNews_200_response" } } }, "description": "Success" }, "401": { "description": "Unauthorized" }, "402": { "description": "Payment Required" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "406": { "description": "Not Acceptable" }, "429": { "description": "Too Many Requests" } }, "summary": "Search News", "tags": [ "News" ] } }, "/top-news": { "get": { "deprecated": false, "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.", "externalDocs": { "description": "Read entire docs", "url": "https://worldnewsapi.com/docs/top-news/" }, "operationId": "topNews", "parameters": [ { "description": "The ISO 3166 country code of the country for which top news should be retrieved.", "explode": false, "in": "query", "name": "source-country", "required": true, "schema": { "example": "us", "maxLength": 2, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "The ISO 6391 language code of the top news. The language must be one spoken in the source-country.", "explode": false, "in": "query", "name": "language", "required": true, "schema": { "example": "en", "maxLength": 2, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "The date for which the top news should be retrieved. If no date is given, the current day is assumed.", "explode": false, "in": "query", "name": "date", "required": false, "schema": { "example": "2024-05-30T00:00:00.000Z", "maxLength": 10, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "Whether to only return basic information such as id, title, and url of the news.", "explode": false, "in": "query", "name": "headlines-only", "required": false, "schema": { "example": false, "type": "boolean" }, "style": "form" } ], "responses": { "200": { "content": { "application/json": { "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-29T00:10:48.000Z", "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-29T04:30:08.000Z", "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-29T08:47:26.000Z", "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-29T10:00:18.000Z", "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-29T10:12:08.000Z", "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-29T10:22:36.000Z", "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-29T15:24:34.000Z", "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-29T17:05:55.000Z", "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-29T17:05:55.000Z", "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-29T17:10:09.000Z", "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-29T12:37:10.000Z", "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-29T12:51:08.000Z", "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-29T12:52:08.000Z", "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" } } }, "schema": { "$ref": "#/components/schemas/topNews_200_response" } } }, "description": "Success" }, "401": { "description": "Unauthorized" }, "402": { "description": "Payment Required" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "406": { "description": "Not Acceptable" }, "429": { "description": "Too Many Requests" } }, "summary": "Top News", "tags": [ "News" ] } }, "/retrieve-front-page": { "get": { "deprecated": false, "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:", "externalDocs": { "description": "Read entire docs", "url": "https://worldnewsapi.com/docs/newspaper-front-pages/" }, "operationId": "retrieveNewspaperFrontPage", "parameters": [ { "description": "The ISO 3166 country code of the newspaper publication.", "explode": false, "in": "query", "name": "source-country", "required": false, "schema": { "example": "au", "maxLength": 2, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "The identifier of the publication see attached list.", "explode": false, "in": "query", "name": "source-name", "required": false, "schema": { "example": "herald-sun", "maxLength": 100, "pattern": ".", "type": "string" }, "style": "form" }, { "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.", "explode": false, "in": "query", "name": "date", "required": false, "schema": { "example": "2024-07-09T00:00:00.000Z", "maxLength": 10, "pattern": ".", "type": "string" }, "style": "form" } ], "responses": { "200": { "content": { "application/json": { "examples": { "Response": { "value": { "front_page": { "name": "Herald Sun", "date": "2024-07-09T00:00:00.000Z", "country": "au", "image": "https://img.worldnewsapi.com/front-pages/herald-sun-2024-07-09-ota3mg51.jpg", "language": "en" } } } }, "schema": { "$ref": "#/components/schemas/retrieveNewspaperFrontPage_200_response" } } }, "description": "Success" }, "401": { "description": "Unauthorized" }, "402": { "description": "Payment Required" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "406": { "description": "Not Acceptable" }, "429": { "description": "Too Many Requests" } }, "summary": "Retrieve Newspaper Front Page", "tags": [ "News" ] } }, "/retrieve-news": { "get": { "deprecated": false, "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.", "externalDocs": { "description": "Read entire docs", "url": "https://worldnewsapi.com/docs/retrieve-news/" }, "operationId": "retrieveNewsArticlesByIds", "parameters": [ { "description": "A comma separated list of news ids.", "explode": false, "in": "query", "name": "ids", "required": true, "schema": { "example": "2352,2354", "maxLength": 10000, "pattern": ".", "type": "string" }, "style": "form" } ], "responses": { "200": { "content": { "application/json": { "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-11T18:05:26.000Z", "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-20T11:14:17.000Z", "authors": [ "Amnesty International" ] } ] } } }, "schema": { "$ref": "#/components/schemas/retrieveNewsArticlesByIds_200_response" } } }, "description": "Success" }, "401": { "description": "Unauthorized" }, "402": { "description": "Payment Required" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "406": { "description": "Not Acceptable" }, "429": { "description": "Too Many Requests" } }, "summary": "Retrieve News Articles by Ids", "tags": [ "News" ] } }, "/extract-news": { "get": { "deprecated": false, "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.", "externalDocs": { "description": "Read entire docs", "url": "https://worldnewsapi.com/docs/extract-news/" }, "operationId": "extractNews", "parameters": [ { "description": "The url of the news.", "explode": false, "in": "query", "name": "url", "required": true, "schema": { "example": "https://www.bbc.com/news/world-us-canada-59340789", "maxLength": 1000, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "Whether to analyze the extracted news (extract entities, detect sentiment etc.)", "explode": false, "in": "query", "name": "analyze", "required": false, "schema": { "example": true, "type": "boolean" }, "style": "form" } ], "responses": { "200": { "content": { "application/json": { "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-02T17:13:12.000Z", "author": "Jennie Taer", "authors": [ "Jennie Taer" ], "language": "en" } } }, "schema": { "$ref": "#/components/schemas/extractNews_200_response" } } }, "description": "Success" }, "401": { "description": "Unauthorized" }, "402": { "description": "Payment Required" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "406": { "description": "Not Acceptable" }, "429": { "description": "Too Many Requests" } }, "summary": "Extract News", "tags": [ "News" ] } }, "/extract-news-links": { "get": { "deprecated": false, "description": "Extract news links from a news website.", "externalDocs": { "description": "Read entire docs", "url": "https://worldnewsapi.com/docs/extract-news-links/" }, "operationId": "extractNewsLinks", "parameters": [ { "description": "The url of the news.", "explode": false, "in": "query", "name": "url", "required": true, "schema": { "example": "https://www.bbc.com/news/world-us-canada-59340789", "maxLength": 1000, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "Whether to analyze the extracted news (extract entities, detect sentiment etc.)", "explode": false, "in": "query", "name": "analyze", "required": false, "schema": { "example": true, "type": "boolean" }, "style": "form" } ], "responses": { "200": { "content": { "application/json": { "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" ] } } }, "schema": { "$ref": "#/components/schemas/extractNewsLinks_200_response" } } }, "description": "Success" }, "401": { "description": "Unauthorized" }, "402": { "description": "Payment Required" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "406": { "description": "Not Acceptable" }, "429": { "description": "Too Many Requests" } }, "summary": "Extract News Links", "tags": [ "News" ] } }, "/search-news-sources": { "get": { "deprecated": false, "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.", "externalDocs": { "description": "Read entire docs", "url": "https://worldnewsapi.com/docs/search-news-sources/" }, "operationId": "searchNewsSources", "parameters": [ { "description": "The (partial) name of the source.", "explode": false, "in": "query", "name": "name", "required": true, "schema": { "example": "bbc", "maxLength": 1000, "pattern": ".", "type": "string" }, "style": "form" } ], "responses": { "200": { "content": { "application/json": { "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" } ] } } }, "schema": { "$ref": "#/components/schemas/searchNewsSources_200_response" } } }, "description": "Success" }, "401": { "description": "Unauthorized" }, "402": { "description": "Payment Required" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "406": { "description": "Not Acceptable" }, "429": { "description": "Too Many Requests" } }, "summary": "Search News Sources", "tags": [ "News" ] } }, "/feed.rss": { "get": { "deprecated": false, "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.", "externalDocs": { "description": "Read entire docs", "url": "https://worldnewsapi.com/docs/website-to-rss-feed/" }, "operationId": "newsWebsiteToRSSFeed", "parameters": [ { "description": "The url of the site for which an RSS feed should be created.", "explode": false, "in": "query", "name": "url", "required": true, "schema": { "example": "https://www.bbc.com/", "maxLength": 1000, "pattern": ".", "type": "string" }, "style": "form" }, { "description": "Whether to extract the news for each link instead of just returning the link.", "explode": false, "in": "query", "name": "extract-news", "required": false, "schema": { "example": true, "type": "boolean" }, "style": "form" } ], "responses": { "200": { "content": { "application/xml": { "schema": { "type": "object" } } }, "description": "Success" }, "401": { "description": "Unauthorized" }, "402": { "description": "Payment Required" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "406": { "description": "Not Acceptable" }, "429": { "description": "Too Many Requests" } }, "summary": "News Website to RSS Feed", "tags": [ "News" ] } }, "/geo-coordinates": { "get": { "deprecated": false, "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.", "externalDocs": { "description": "Read entire docs", "url": "https://worldnewsapi.com/docs/get-geo-coordinates/" }, "operationId": "getGeoCoordinates", "parameters": [ { "description": "The address or name of the location.", "explode": false, "in": "query", "name": "location", "required": true, "schema": { "example": "Tokyo, Japan", "maxLength": 1000, "pattern": ".", "type": "string" }, "style": "form" } ], "responses": { "200": { "content": { "application/json": { "examples": { "Response": { "value": { "latitude": 35.652832, "longitude": 139.839478, "city": "Tokyo" } } }, "schema": { "$ref": "#/components/schemas/getGeoCoordinates_200_response" } } }, "description": "Success" }, "401": { "description": "Unauthorized" }, "402": { "description": "Payment Required" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "406": { "description": "Not Acceptable" }, "429": { "description": "Too Many Requests" } }, "summary": "Get Geo Coordinates", "tags": [ "News" ] } } }, "components": { "schemas": { "searchNews_200_response_news_inner": { "example": { "summary": "summary", "image": "image", "sentiment": 5.962133916683182, "language": "language", "video": "video", "title": "title", "url": "url", "source_country": "source_country", "id": 5, "text": "text", "category": "category", "publish_date": "publish_date", "authors": [ "authors", "authors" ] }, "properties": { "summary": { "nullable": true, "type": "string" }, "image": { "nullable": true, "type": "string" }, "sentiment": { "type": "number" }, "language": { "nullable": true, "type": "string" }, "video": { "nullable": true, "type": "string" }, "title": { "nullable": true, "type": "string" }, "url": { "nullable": true, "type": "string" }, "source_country": { "nullable": true, "type": "string" }, "id": { "type": "integer" }, "text": { "nullable": true, "type": "string" }, "category": { "nullable": true, "type": "string" }, "publish_date": { "nullable": true, "type": "string" }, "authors": { "items": { "nullable": true, "type": "string" }, "type": "array" } }, "type": "object" }, "searchNews_200_response": { "example": { "news": [ { "summary": "summary", "image": "image", "sentiment": 5.962133916683182, "language": "language", "video": "video", "title": "title", "url": "url", "source_country": "source_country", "id": 5, "text": "text", "category": "category", "publish_date": "publish_date", "authors": [ "authors", "authors" ] }, { "summary": "summary", "image": "image", "sentiment": 5.962133916683182, "language": "language", "video": "video", "title": "title", "url": "url", "source_country": "source_country", "id": 5, "text": "text", "category": "category", "publish_date": "publish_date", "authors": [ "authors", "authors" ] } ], "number": 6, "offset": 0, "available": 1 }, "properties": { "offset": { "type": "integer" }, "number": { "type": "integer" }, "available": { "type": "integer" }, "news": { "items": { "$ref": "#/components/schemas/searchNews_200_response_news_inner" }, "type": "array" } }, "type": "object" }, "topNews_200_response_top_news_inner_news_inner": { "example": { "summary": "summary", "image": "image", "author": "author", "id": 0, "text": "text", "title": "title", "publish_date": "publish_date", "url": "url", "authors": [ "authors", "authors" ] }, "properties": { "summary": { "nullable": true, "type": "string" }, "image": { "nullable": true, "type": "string" }, "author": { "nullable": true, "type": "string" }, "id": { "type": "integer" }, "text": { "nullable": true, "type": "string" }, "title": { "nullable": true, "type": "string" }, "publish_date": { "nullable": true, "type": "string" }, "url": { "nullable": true, "type": "string" }, "authors": { "items": { "nullable": true, "type": "string" }, "type": "array" } }, "type": "object" }, "topNews_200_response_top_news_inner": { "example": { "news": [ { "summary": "summary", "image": "image", "author": "author", "id": 0, "text": "text", "title": "title", "publish_date": "publish_date", "url": "url", "authors": [ "authors", "authors" ] }, { "summary": "summary", "image": "image", "author": "author", "id": 0, "text": "text", "title": "title", "publish_date": "publish_date", "url": "url", "authors": [ "authors", "authors" ] } ] }, "properties": { "news": { "items": { "$ref": "#/components/schemas/topNews_200_response_top_news_inner_news_inner" }, "type": "array" } }, "type": "object" }, "topNews_200_response": { "example": { "country": "country", "top_news": [ { "news": [ { "summary": "summary", "image": "image", "author": "author", "id": 0, "text": "text", "title": "title", "publish_date": "publish_date", "url": "url", "authors": [ "authors", "authors" ] }, { "summary": "summary", "image": "image", "author": "author", "id": 0, "text": "text", "title": "title", "publish_date": "publish_date", "url": "url", "authors": [ "authors", "authors" ] } ] }, { "news": [ { "summary": "summary", "image": "image", "author": "author", "id": 0, "text": "text", "title": "title", "publish_date": "publish_date", "url": "url", "authors": [ "authors", "authors" ] }, { "summary": "summary", "image": "image", "author": "author", "id": 0, "text": "text", "title": "title", "publish_date": "publish_date", "url": "url", "authors": [ "authors", "authors" ] } ] } ], "language": "language" }, "properties": { "top_news": { "items": { "$ref": "#/components/schemas/topNews_200_response_top_news_inner" }, "type": "array" }, "language": { "nullable": true, "type": "string" }, "country": { "nullable": true, "type": "string" } }, "type": "object" }, "retrieveNewspaperFrontPage_200_response_front_page": { "example": { "date": "date", "country": "country", "image": "image", "name": "name", "language": "language" }, "properties": { "name": { "nullable": true, "type": "string" }, "date": { "nullable": true, "type": "string" }, "country": { "nullable": true, "type": "string" }, "image": { "nullable": true, "type": "string" }, "language": { "nullable": true, "type": "string" } }, "type": "object" }, "retrieveNewspaperFrontPage_200_response": { "example": { "front_page": { "date": "date", "country": "country", "image": "image", "name": "name", "language": "language" } }, "properties": { "front_page": { "$ref": "#/components/schemas/retrieveNewspaperFrontPage_200_response_front_page" } }, "type": "object" }, "retrieveNewsArticlesByIds_200_response_news_inner": { "example": { "summary": "summary", "image": "image", "sentiment": 0.8008281904610115, "source_country": "source_country", "language": "language", "id": 6, "text": "text", "title": "title", "category": "category", "publish_date": "publish_date", "url": "url", "authors": [ "authors", "authors" ] }, "properties": { "summary": { "nullable": true, "type": "string" }, "image": { "nullable": true, "type": "string" }, "sentiment": { "type": "number" }, "language": { "nullable": true, "type": "string" }, "title": { "nullable": true, "type": "string" }, "url": { "nullable": true, "type": "string" }, "source_country": { "nullable": true, "type": "string" }, "id": { "type": "integer" }, "text": { "nullable": true, "type": "string" }, "category": { "nullable": true, "type": "string" }, "publish_date": { "nullable": true, "type": "string" }, "authors": { "items": { "nullable": true, "type": "string" }, "type": "array" } }, "type": "object" }, "retrieveNewsArticlesByIds_200_response": { "example": { "news": [ { "summary": "summary", "image": "image", "sentiment": 0.8008281904610115, "source_country": "source_country", "language": "language", "id": 6, "text": "text", "title": "title", "category": "category", "publish_date": "publish_date", "url": "url", "authors": [ "authors", "authors" ] }, { "summary": "summary", "image": "image", "sentiment": 0.8008281904610115, "source_country": "source_country", "language": "language", "id": 6, "text": "text", "title": "title", "category": "category", "publish_date": "publish_date", "url": "url", "authors": [ "authors", "authors" ] } ] }, "properties": { "news": { "items": { "$ref": "#/components/schemas/retrieveNewsArticlesByIds_200_response_news_inner" }, "type": "array" } }, "type": "object" }, "extractNews_200_response_images_inner": { "example": { "width": 0, "title": "title", "url": "url", "height": 6 }, "properties": { "width": { "type": "integer" }, "title": { "nullable": true, "type": "string" }, "url": { "nullable": true, "type": "string" }, "height": { "type": "integer" } }, "type": "object" }, "extractNews_200_response_videos_inner": { "example": { "summary": "summary", "duration": 1, "thumbnail": "thumbnail", "title": "title", "url": "url" }, "properties": { "summary": { "nullable": true, "type": "string" }, "duration": { "type": "integer" }, "thumbnail": { "nullable": true, "type": "string" }, "title": { "nullable": true, "type": "string" }, "url": { "nullable": true, "type": "string" } }, "type": "object" }, "extractNews_200_response": { "example": { "image": "image", "images": [ { "width": 0, "title": "title", "url": "url", "height": 6 }, { "width": 0, "title": "title", "url": "url", "height": 6 } ], "author": "author", "videos": [ { "summary": "summary", "duration": 1, "thumbnail": "thumbnail", "title": "title", "url": "url" }, { "summary": "summary", "duration": 1, "thumbnail": "thumbnail", "title": "title", "url": "url" } ], "language": "language", "text": "text", "video": "video", "title": "title", "publish_date": "publish_date", "url": "url", "authors": [ "authors", "authors" ] }, "properties": { "title": { "nullable": true, "type": "string" }, "text": { "nullable": true, "type": "string" }, "url": { "nullable": true, "type": "string" }, "image": { "nullable": true, "type": "string" }, "images": { "items": { "$ref": "#/components/schemas/extractNews_200_response_images_inner" }, "type": "array" }, "video": { "nullable": true, "type": "string" }, "videos": { "items": { "$ref": "#/components/schemas/extractNews_200_response_videos_inner" }, "type": "array" }, "publish_date": { "nullable": true, "type": "string" }, "author": { "nullable": true, "type": "string" }, "authors": { "items": { "nullable": true, "type": "string" }, "type": "array" }, "language": { "nullable": true, "type": "string" } }, "type": "object" }, "extractNewsLinks_200_response": { "example": { "news_links": [ "news_links", "news_links" ] }, "properties": { "news_links": { "items": { "nullable": true, "type": "string" }, "type": "array" } }, "type": "object" }, "searchNewsSources_200_response_sources_inner": { "example": { "name": "name", "language": "language", "url": "url" }, "properties": { "name": { "nullable": true, "type": "string" }, "url": { "nullable": true, "type": "string" }, "language": { "nullable": true, "type": "string" } }, "type": "object" }, "searchNewsSources_200_response": { "example": { "sources": [ { "name": "name", "language": "language", "url": "url" }, { "name": "name", "language": "language", "url": "url" } ], "available": 0 }, "properties": { "available": { "type": "integer" }, "sources": { "items": { "$ref": "#/components/schemas/searchNewsSources_200_response_sources_inner" }, "type": "array" } }, "type": "object" }, "getGeoCoordinates_200_response": { "example": { "city": "city", "latitude": 0.8008281904610115, "longitude": 6.027456183070403 }, "properties": { "latitude": { "type": "number" }, "longitude": { "type": "number" }, "city": { "nullable": true, "type": "string" } }, "type": "object" } }, "securitySchemes": { "apiKey": { "in": "query", "name": "api-key", "type": "apiKey" }, "headerApiKey": { "in": "header", "name": "x-api-key", "type": "apiKey" } } } }