Documentation
Sign up for free!
Get instant access to the API with your free API token. No billing details required!
Getting Started
Introduction
Our API was developed to provide global news from thousands of sources with exceptional response times. On average we add over 1 million articles weekly, so you will never be short of content. Even better, it is completely free!
To get started simply sign up and use your API token in any of the available API endpoints documented below for instant access.
If you have any questions or concerns, feel free to contact us.
Authentication
As mentioned above, when you sign up for free you will find your API token on your dashboard. Simply add this to any of our API endpoints as a GET parameter to gain access. Examples of how this is done can be found below.
API Endpoints
Headlines Available on: Standard plan and above
Endpoint
GET https://api.thenewsapi.com/v1/news/headlines HTTP/1.1
Use this endpoint to find get the latest headlines by category along with similar articles, allowing you to create the perfect news aggregation page similar to Google News .
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
locale |
false | Comma separated list of country codes to include in the result set. Default is all countries.
Click here for a list of supported countries.
Example: us,ca (US + Canada).
|
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_on |
false | Find headlines for articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-03-20
|
headlines_per_category |
false | Specify the number of articles you want to return per category. The maximum is 10 and the default is 6. |
include_similar |
false | Specify if you wish to include similar articles with each base article. Default is true. |
Response Objects
| name | description |
|---|---|
data > uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
data > title |
The article title. |
data > description |
The article meta description. |
data > keywords |
The article meta keywords. |
data > snippet |
The first 60 characters of the article body. |
data > url |
The URL to the article. |
data > image_url |
The URL to the article image. |
data > language |
The language of the source. |
data > published_at |
The datetime the article was published. |
data > source |
The domain of the source. |
data > categories |
Array of strings which the source is categorized as. |
data > locale |
Locale of the source. |
data > similar |
An array of similar articles to the base article. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/headlines?locale=us&language=en&api_token=YOUR_API_TOKEN
Example Response
{
"data": {
"general": [
{
"uuid": "3bd64ef4-b60f-4926-86ab-0ae55e09bbb9",
"title": "Legal showdown as Justice Department resists judge’s demand for more details on deportation flights",
"description": "The Justice Department is resisting a federal judge’s demand for more information about flights that took deportees to to El Salvador.",
"keywords": "Donald Trump, Barack Obama, Karoline Leavitt, El Salvador, U.S. Department of Justice, Executive orders, General news, Latin America, Immigration, Jeb Boasberg, Washington news, Impeachment, Nayib Bukele, Politics, Courts",
"snippet": "WASHINGTON (AP) — The Justice Department is resisting a federal judge’s demand for more information about flights that took deportees to to El Salvador, arg...",
"url": "https://apnews.com/article/trump-deportations-el-salvador-venezuela-gang-boasberg-e0ac99970c7429c82d54b681c96e4d2e",
"image_url": "https://dims.apnews.com/dims4/default/810f802/2147483647/strip/true/crop/4720x2655+0+211/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F0c%2Ff7%2Faaf593403e3a6dde287d66050268%2Fd26cd5b687f943bd90f2dce610e3c702",
"language": "en",
"published_at": "2025-03-19T15:23:01.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"locale": "us",
"similar": [
{
"uuid": "a6cde770-6856-454d-93ef-6561b16079f9",
"title": "Trump Slashes Federal Funding at Another Ivy League University",
"description": "Donald Trump is continuing his war on education and his war on trans athletes.",
"keywords": "",
"snippet": "Columbia University graduate student Mahmoud Khalil will have his day in court.\n\nU.S. District Judge Jesse Furman on Wednesday tossed the Trump administration?...",
"url": "https://newrepublic.com/post/192927/trump-cuts-federal-funding-university-pennsylvania",
"image_url": "https://images.newrepublic.com/c87b84c68a504ba596d44ab7e7a23032900cc536.jpeg?w=1200&h=630&crop=faces&fit=crop&fm=jpg",
"language": "en",
"published_at": "2025-03-19T16:10:28.000000Z",
"source": "newrepublic.com",
"categories": [
"general",
"politics",
"entertainment"
],
"locale": "us"
},
{
"uuid": "ab6342f9-281b-4190-afb1-bacea3b1e14c",
"title": "Trump wants US to own Ukraine’s energy facilities – White House",
"description": "US President Donald Trump has floated the idea of Washington taking over Ukraine’s energy facilities to give them more “security”",
"keywords": "",
"snippet": "The president has told Vladimir Zelensky it would be the best way to protect the country’s power plants\n\nUS President Donald Trump has proposed taking over Uk...",
"url": "https://www.rt.com/news/614513-us-ukrainian-energy-takeover/",
"image_url": "https://mf.b37mrtl.ru/files/2025.03/article/67db201020302727424d1cd1.jpg",
"language": "en",
"published_at": "2025-03-19T19:51:14.000000Z",
"source": "rt.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "44cab0ae-31a4-41cf-bef3-bfdb27055d8a",
"title": "DOGE doxx site maps 'Musk World' as Trump AG threatens Tesla vandals with federal charges",
"description": "Tesla CEO Elon Musk spent hundreds of millions to help President Donald Trump win a second term. His electric vehicle maker is paying a price for that.",
"keywords": "Laws, Crime, Business, Donald Trump, Government and politics, Donald J. Trump, Pam Bondi, United States, Tesla Inc, Politics, Breaking News: Politics, business news",
"snippet": "In this article TSLA Follow your favorite stocks CREATE FREE ACCOUNT\n\nDOGEQUEST\n\nA new online map is highlighting locations across the United States of Tesla de...",
"url": "https://www.cnbc.com/2025/03/19/doge-map-of-musk-world-as-trump-ag-warns-tesla-vandals.html",
"image_url": "https://image.cnbcfm.com/api/v1/image/108114305-17417212502025-03-11t192114z_254284279_rc26bdah68f8_rtrmadp_0_usa-trump.jpeg?v=1741986754&w=1920&h=1080",
"language": "en",
"published_at": "2025-03-19T21:24:25.000000Z",
"source": "cnbc.com",
"categories": [
"general",
"business"
],
"locale": "us"
},
{
"uuid": "86f07604-212e-4068-898c-3789e0fa3ffe",
"title": "Judge denies embattled government-funded agency's restraining order request against DOGE",
"description": "A federal judge ruled in favor of the Trump administration and DOGE on Wednesday after denying the U.S. Institute for Peace's temporary restraining order request.",
"keywords": "",
"snippet": "A federal judge ruled in favor of the Trump administration on Wednesday, after a government-funded nonprofit organization filed a lawsuit protecting itself from...",
"url": "https://www.foxnews.com/politics/judge-denies-embattled-government-funded-agencys-restraining-order-request-against-doge",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/03/trump-us-institute-peace-1.jpg",
"language": "en",
"published_at": "2025-03-19T23:13:56.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "7852edf6-44cc-468e-b997-c0549a84c967",
"title": "Trump expected to sign order gutting Department of Education, sources say",
"description": "President Donald Trump is expected to sign an executive order to diminish the Department of Education at the White House on Thursday, multiple sources told ABC News.",
"keywords": "Article, 119967268",
"snippet": "The DOE took steps to downsize when it laid off half its employees last week.\n\nCivil servants and supporters of the Department of Education rally outside the de...",
"url": "https://abcnews.go.com/Politics/trump-expected-sign-order-gutting-department-education-sources/story?id=119967268",
"image_url": "https://i.abcnewsfe.com/a/63d5aa42-9003-48c5-b937-5f4e3fa8c88f/dept-education-1-epa-gmh-250311_1741707004175_hpMain_16x9.jpg?w=1600",
"language": "en",
"published_at": "2025-03-19T22:42:43.000000Z",
"source": "abcnews.go.com",
"categories": [
"general"
],
"locale": "us"
}
]
},
{
"uuid": "735cc10e-13ac-460d-bfc9-b96b571cd24f",
"title": "Donald Trump Has ‘Very Good Telephone Call’ with Zelensky After Putin Talk",
"description": "President Donald Trump said on Wednesday he had a “very good telephone call” with Ukrainian President Voloydymr Zelensky.",
"keywords": "",
"snippet": "President Donald Trump said on Wednesday he had a “very good telephone call” with Ukrainian President Voloydymr Zelensky, following up on his conversation w...",
"url": "https://www.breitbart.com/national-security/2025/03/19/donald-trump-has-very-good-telephone-call-with-zelensky-after-putin-talk/",
"image_url": "https://media.breitbart.com/media/2025/03/GettyImages-2202519876-640x335.jpg",
"language": "en",
"published_at": "2025-03-19T18:09:04.000000Z",
"source": "breitbart.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "68d55571-00a1-4dae-a883-88eb2795e505",
"title": "Did Vladmir Putin just play Donald Trump?",
"description": "The Russian president rejected a full ceasefire after long conversation with his US counterpart.",
"keywords": "",
"snippet": "Just hours after the White House announced that Vladimir Putin had agreed to a temporary ceasefire on Ukraine's energy infrastructure, Russia launched air strik...",
"url": "https://theweek.com/politics/did-vladmir-putin-just-play-donald-trump",
"image_url": "https://cdn.mos.cms.futurecdn.net/oUBWXYaBfiNpyeUkPWFSy4-1200-80.jpg",
"language": "en",
"published_at": "2025-03-19T14:30:10.000000Z",
"source": "theweek.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "eb5ae49f-7c69-4b95-b6fe-c969f240bbe8",
"title": "Russia Ukraine Trump: Zelensky has a real chance to end the war, if he can accept these harsh realities.",
"description": "Trump was right about one thing in that White House blowup with Zelensky.",
"keywords": "",
"snippet": "This article was originally featured in Foreign Policy, the magazine of global politics and ideas.\n\nAs Ukrainian President Volodymyr Zelensky awaits ceasefire t...",
"url": "https://slate.com/news-and-politics/2025/03/russia-ukraine-trump-zelensky-war-peace-ceasefire.html?via=rss",
"image_url": "https://compote.slate.com/images/9ac5beb5-473e-4496-94cf-b01de74d1519.jpeg?crop=6036%2C4024%2Cx6%2Cy0&width=1560",
"language": "en",
"published_at": "2025-03-19T16:16:32.000000Z",
"source": "slate.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "b11ba9d1-5dbd-4c27-b614-6747d83b816f",
"title": "Trump posts statement after 'very good' call with Zelenskyy",
"description": "President Trump posted on social media that he had a \"very good\" call with Ukrainian President Zelenskyy about the war with Russia and his previous call with Russian President Putin.",
"keywords": "",
"snippet": "President Trump posted on social media that he had a \"very good\" call with Ukrainian President Zelenskyy about the war with Russia and his previous call with Ru...",
"url": "https://www.nbcnews.com/now/video/trump-posts-statement-after-very-good-call-with-zelenskyy-234826309745",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/mpx/2704722219/2025_03/1742400598631_now_daily_a_gutierrez_trump_zelenskyy_call_250319_1920x1080-umk8fb.jpg",
"language": "en",
"published_at": "2025-03-19T16:10:05.000000Z",
"source": "nbcnews.com",
"categories": [
"politics",
"general"
],
"locale": "us"
},
{
"uuid": "bccacda8-64f0-4dda-8e91-a5a6787778ce",
"title": "Trump holds ‘very good’ call with Zelensky",
"description": "US President Donald Trump and Ukrainian leader Vladimir Zelensky held an hour-long phone conversation",
"keywords": "",
"snippet": "The US president has revealed that conversation revolved around his talks with Russian counterpart, Vladimir Putin\n\nUS President Donald Trump on Wednesday held ...",
"url": "https://www.rt.com/news/614509-trump-zelensky-phone-call/",
"image_url": "https://mf.b37mrtl.ru/files/2025.03/article/67daf28120302726c907fb28.jpg",
"language": "en",
"published_at": "2025-03-19T16:40:18.000000Z",
"source": "rt.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
}
],
"business": ...,
"sports": ...,
"tech": ...,
"science": ...,
"health": ...
}
}
Top Stories Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/top HTTP/1.1
Use this endpoint to find live and historical top stories around the world or filter to get only top stories for specific countries. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
locale |
false | Comma separated list of country codes to include in the result set. Default is all countries.
Click here for a list of supported countries.
Example: us,ca (US + Canada).
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2025-03-20T02:19:24 |
2025-03-20T02:19 |
2025-03-20T02 |
2025-03-20 |
2025-03 |
2025
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2025-03-20T02:19:24 |
2025-03-20T02:19 |
2025-03-20T02 |
2025-03-20 |
2025-03 |
2025
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-03-20
|
sort |
false | Sort by published_on or relevance_score (only available when used in conjunction with search).
Default is published_at unless search is used and sorting by published_at is not included,
in which case relevance_score is used. |
limit |
false | Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan. |
page |
false | Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of articles found for the request. |
meta > returned |
The number of articles returned on the page.
This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page. |
meta > limit |
The limit based on the limit parameter. |
meta > page |
The page number based on the page parameter. |
data > uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
data > title |
The article title. |
data > description |
The article meta description. |
data > keywords |
The article meta keywords. |
data > snippet |
The first 60 characters of the article body. |
data > url |
The URL to the article. |
data > image_url |
The URL to the article image. |
data > language |
The language of the source. |
data > published_at |
The datetime the article was published. |
data > source |
The domain of the source. |
data > categories |
Array of strings which the source is categorized as. |
data > relevance_score |
Relevance score based on the search parameter. If the search parameter is not used, this will be null. |
data > locale |
Locale of the source. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/top?api_token=YOUR_API_TOKEN&locale=us&limit=3
Example Response
{
"meta": {
"found": 1264027,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "7487c99e-e464-47c8-8852-2395bf482254",
"title": "Transfer rumors, news: Man United ready to splurge on Simons?",
"description": "Man United are interested in a creative attacker, and RB Leipzig's Xavi Simons fits the bill. Transfer Talk has the latest news, gossip and rumors.",
"keywords": "",
"snippet": "Open Extended Reactions\n\nManchester United remain in the race to sign RB Leipzig attacker Xavi Simons, while Liverpool have identified Feyenoord right back Giva...",
"url": "https://www.espn.com/soccer/story/_/id/44321517/transfer-rumors-news-manchester-united-ready-splurge-rb-leipzig-xavi-simons",
"image_url": "https://a4.espncdn.com/combiner/i?img=%2Fphoto%2F2024%2F0913%2Fr1385777_1296x729_16%2D9.jpg",
"language": "en",
"published_at": "2025-03-20T02:16:34.000000Z",
"source": "espn.com",
"categories": [
"sports",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "3a1fb3f0-a583-4b20-af45-694a05be90d2",
"title": "Netanyahu gifts Fetterman a silver-plated beeper after he praised Israel's Lebanon pager operation",
"description": "Sen. John Fetterman was gifted a silver-plated beeper during a visit with Israeli Prime Minister Benjamin Netanyahu this week.",
"keywords": "",
"snippet": "Sen. John Fetterman, D-Penn., was gifted a silver-plated beeper during a visit with Israeli Prime Minister Benjamin Netanyahu after the lawmaker praised Israel'...",
"url": "https://www.foxnews.com/politics/netanyahu-gifts-fetterman-silver-plated-beeper-after-he-praised-israels-lebanon-pager-operation",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/03/video-9.jpg",
"language": "en",
"published_at": "2025-03-20T02:03:21.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "208107e8-74b4-4727-895f-8c9b6fadb9ae",
"title": "Paige DeSorbo 'Tolerated Too Much' With Craig Conover Before Split",
"description": "Paige DeSorbo got candid about the struggles she faced with Craig Conover before they broke up in December 2024",
"keywords": "",
"snippet": "Paige DeSorbo is looking back on how she let a lot of ex Craig Conover’s eyebrow-raising comments slide during their relationship.\n\n“I think obviously when ...",
"url": "https://www.usmagazine.com/entertainment/news/paige-desorbo-tolerated-too-much-with-craig-conover-before-split/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2025/02/Breaking-Down-Paige-DeSorbo-and-Craig-Conovers-Split.jpg?crop=0px%2C10px%2C1480px%2C777px&resize=1200%2C630&quality=70&strip=all",
"language": "en",
"published_at": "2025-03-20T02:01:48.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "5a403076-3b82-4aef-ae59-555f9e786bf0",
"title": "Traveling amid measles, plus pet food recalls and cancer risk factors",
"description": "The Fox News Health Newsletter brings you trending and important stories about healthcare, drug developments, mental health issues, real people's triumphs over ...",
"keywords": "",
"snippet": "Fox News' Health newsletter brings you stories on the latest developments in healthcare, wellness, diseases, mental health and more.\n\nTOP 3:\n\n- Fly safely amid ...",
"url": "https://www.foxnews.com/health/traveling-amid-measles-outbreak-bird-flu-product-recalls-plus-cancer-linked-high-stress",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/03/travelers-masks-airport.jpg",
"language": "en",
"published_at": "2025-03-20T01:55:37.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "31648d7f-bb68-4518-98b9-ce797a5c567e",
"title": "Opry 100: Carrie Underwood and Mike Fisher Red Carpet Fashion",
"description": "Carrie Underwood and her husband Mike Fisher stepped out together for Opry 100: A Live Celebration in Nashville March 19, their first joint red carpet appearanc...",
"keywords": "",
"snippet": "Watch : Carrie Underwood Reveals Most Exciting Part About Return to ‘American Idol’ (Exclusive)\n\nCarrie Underwood and Mike Fisher’s latest date night will...",
"url": "https://www.eonline.com/news/1415007/opry-100-carrie-underwood-and-mike-fisher-red-carpet-fashion?cmpid=rss-syndicate-genericrss-us-top_stories",
"image_url": "https://akns-images.eonline.com/eol_images/Entire_Site/20250319/ca65fc7b-9d45-4e4a-9660-cfe41747c7b1_1742428547.jpg?fit=around%7C1080:1080&output-quality=90&crop=1080:1080;center,top",
"language": "en",
"published_at": "2025-03-20T01:49:00.000000Z",
"source": "eonline.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "1bb8dd00-b6c9-432a-9486-dae73d514358",
"title": "Former NASCAR driver Danica Patrick announces pivot to tennis",
"description": "Former auto racing star Danica Patrick is shifting gears, revealing her recent quest to learn how to play tennis.",
"keywords": "",
"snippet": "Danica Patrick reached great heights during her standout NASCAR and IndyCar career. Now, the retired driver is taking her talents to a new sport.\n\nThe 42-year-o...",
"url": "https://www.foxnews.com/sports/former-nascar-driver-danica-patrick-announces-pivot-tennis",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/03/danica-patrick.jpg",
"language": "en",
"published_at": "2025-03-20T01:46:40.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "6f65423d-2901-4ac9-99bb-e410bfbe27ff",
"title": "Trump vows to refund, deport any 'unsavory' immigrants who try for citizenship under potential 'gold card'",
"description": "President Donald Trump tells \"The Ingraham Angle\" why he wants to replace the EB-5 immigrant investor visa program and what he would do should problems arise wi...",
"keywords": "",
"snippet": "President Donald Trump said his administration would properly vet anyone who buys one of his proposed $5 million \"gold card\" visas as he looks to replace the EB...",
"url": "https://www.foxnews.com/media/trump-vows-refund-deport-any-unsavory-immigrants-try-citizenship-under-potential-gold-card",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/02/be084c16-donald-trump.jpg",
"language": "en",
"published_at": "2025-03-20T01:45:45.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "730462a6-ddda-4384-a197-c2520b934b84",
"title": "Dolly Parton is 'doing better than I thought,' two weeks after her husband's death",
"description": "Dolly Parton spoke about how she is dealing with her husband's death while speaking with Knox News at the Dollywood 40th season celebration.",
"keywords": "",
"snippet": "Dolly Parton is opening up about the loss of her husband.\n\nThe 79-year-old country music legend sat down with Knox News at Dollywood while celebrating the openi...",
"url": "https://www.foxnews.com/entertainment/dolly-parton-doing-better-than-i-thought-two-weeks-after-her-husbands-death",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/03/dolly-parton-carl-dean.jpg",
"language": "en",
"published_at": "2025-03-20T01:32:10.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "99ee6c7b-7da2-4f6d-a150-ba8377dd5804",
"title": "Dennis Quaid Praises Son Jack’s No. 1 Film ‘Novocaine’, Says Fans “Haven’t Seen Nothing Yet”",
"description": "As Jack Quaid dominates the box office with his new action comedy, his father Dennis Quaid is singing his praises.",
"keywords": "",
"snippet": "As Jack Quaid dominates the box office with his new action comedy, his father Dennis Quaid is singing his praises.\n\nWith Novocaine‘s $8.7 million opening lead...",
"url": "https://deadline.com/2025/03/dennis-quaid-praises-jack-no-1-novocaine-1236331479/",
"image_url": "https://deadline.com/wp-content/uploads/2025/03/Jack-Dennis-Quaid-Novocaine.jpg?w=1024",
"language": "en",
"published_at": "2025-03-20T01:23:17.000000Z",
"source": "deadline.com",
"categories": [
"entertainment"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "0e2111f1-f881-465d-8650-ea6b89837d81",
"title": "Cathie Wood Offloads Meta Stock While Mark Zuckerberg Celebrates Llama AI Success - Meta Platforms (NASDAQ:META), ARK Innovation ETF (ARCA:ARKK)",
"description": "Cathie Wood's Ark Invest sold $4.3 million worth of Meta shares on Wednesday, March 19, 2025, despite the company's Llama AI reaching 1 billion downloads.",
"keywords": "",
"snippet": "On Wednesday, Cathie Wood-led Ark Invest made notable trades, including the sale of shares in Meta Platforms Inc. META. This move comes as Meta’s AI model, Ll...",
"url": "https://www.benzinga.com/25/03/44409161/cathie-wood-offloads-meta-stock-while-mark-zuckerberg-celebrates-llama-ai-success",
"image_url": "https://cdn.benzinga.com/files/images/story/2025/03/19/Cathie-Woods-Wednesday-Moves-Ark-Pours-1_0.jpeg?width=1200&height=800&fit=crop",
"language": "en",
"published_at": "2025-03-20T01:22:18.000000Z",
"source": "benzinga.com",
"categories": [
"business"
],
"relevance_score": null,
"locale": "us"
}
]
}
All News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/all HTTP/1.1
Use this endpoint to find all live and historical articles we collect. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2025-03-20T02:19:24 |
2025-03-20T02:19 |
2025-03-20T02 |
2025-03-20 |
2025-03 |
2025
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2025-03-20T02:19:24 |
2025-03-20T02:19 |
2025-03-20T02 |
2025-03-20 |
2025-03 |
2025
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-03-20
|
sort |
false | Sort by published_on or relevance_score (only available when used in conjunction with search).
Default is published_at unless search is used and sorting by published_at is not included,
in which case relevance_score is used. |
limit |
false | Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan. |
page |
false | Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of articles found for the request. |
meta > returned |
The number of articles returned on the page.
This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page. |
meta > limit |
The limit based on the limit parameter. |
meta > page |
The page number based on the page parameter. |
data > uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
data > title |
The article title. |
data > description |
The article meta description. |
data > keywords |
The article meta keywords. |
data > snippet |
The first 60 characters of the article body. |
data > url |
The URL to the article. |
data > image_url |
The URL to the article image. |
data > language |
The language of the source. |
data > published_at |
The datetime the article was published. |
data > source |
The domain of the source. |
data > categories |
Array of strings which the source is categorized as. |
data > relevance_score |
Relevance score based on the search parameter. If the search parameter is not used, this will be null. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&language=en&limit=3
Example Response
{
"meta": {
"found": 51219803,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "ff6c1ff4-722c-49ea-800d-31eff932658e",
"title": "Lorentz gifted shorthanded goal after clearing attempt hits diving ref",
"description": "",
"keywords": "",
"snippet": "Sign in to Sportsnet\n\nSign In Sign Up\n\nFirst Name {* traditionalRegistration_firstName *} {* traditionalRegistration_firstName *} Last Name {* traditionalRegist...",
"url": "https://www.sportsnet.ca/nhl/video/lorentz-gifted-shorthanded-goal-after-clearing-attempt-hits-diving-ref/",
"image_url": "https://www.sportsnet.ca/sn_favicon.ico",
"language": "en",
"published_at": "2025-03-20T02:18:21.000000Z",
"source": "sportsnet.ca",
"categories": [
"sports"
],
"relevance_score": null
},
{
"uuid": "79f65694-737c-406b-b4a7-754a15dd1846",
"title": "Novo Nissan Kicks leva pontuação máxima em crash test; veja o resultado",
"description": "Produzido no México, o novo Nissan Kicks teve um resultado máximo de cinco estrelas em um teste de impacto feito pelo Latin NCAP.",
"keywords": "",
"snippet": "O veículo foi avaliado em impacto frontal, impacto lateral, impacto lateral de poste, chicotada cervical (whiplash), proteção de pedestres, ESC, Frenagem Aut...",
"url": "https://www.uol.com.br/carros/noticias/redacao/2025/03/19/novo-nissan-kicks-fica-com-pontuacao-maxima-em-teste-de-seguranca.htm",
"image_url": "https://conteudo.imguol.com.br/c/entretenimento/01/2025/03/19/novo-nissan-kicks-em-crash-test-do-latin-ncap-1742409542017_v2_615x300.jpg",
"language": "pt",
"published_at": "2025-03-20T02:18:04.000000Z",
"source": "uol.com.br",
"categories": [
"tech",
"science"
],
"relevance_score": null
},
{
"uuid": "7487c99e-e464-47c8-8852-2395bf482254",
"title": "Transfer rumors, news: Man United ready to splurge on Simons?",
"description": "Man United are interested in a creative attacker, and RB Leipzig's Xavi Simons fits the bill. Transfer Talk has the latest news, gossip and rumors.",
"keywords": "",
"snippet": "Open Extended Reactions\n\nManchester United remain in the race to sign RB Leipzig attacker Xavi Simons, while Liverpool have identified Feyenoord right back Giva...",
"url": "https://www.espn.com/soccer/story/_/id/44321517/transfer-rumors-news-manchester-united-ready-splurge-rb-leipzig-xavi-simons",
"image_url": "https://a4.espncdn.com/combiner/i?img=%2Fphoto%2F2024%2F0913%2Fr1385777_1296x729_16%2D9.jpg",
"language": "en",
"published_at": "2025-03-20T02:16:34.000000Z",
"source": "espn.com",
"categories": [
"sports",
"general"
],
"relevance_score": null
},
{
"uuid": "51d92baa-1b6a-41fe-a185-b9b411a159f2",
"title": "Mount St. Mary's beats American in First Four to earn date with No. 1 Duke",
"description": "Dola Adebayo and Jedy Cordilla each scored 22 points as Mount St. Mary's defeated American 83-72 in an NCAA Tournament matchup of No. 16 seeds at the First Four...",
"keywords": "",
"snippet": "DAYTON, Ohio — Dola Adebayo and Jedy Cordilla each scored 22 points as Mount St. Mary's defeated American 83-72 in an NCAA Tournament matchup of No. 16 seeds ...",
"url": "https://www.sportsnet.ca/ncaa-mens-basketball/article/mount-st-marys-beats-american-in-first-four-to-earn-date-with-no-1-duke/",
"image_url": "https://www.sportsnet.ca/wp-content/uploads/2025/03/f8e58f8ae999db1f1c8d5193f06b6867c3e018328bb0d4a59d77b20c0bfbf01c.jpg",
"language": "en",
"published_at": "2025-03-20T02:16:01.000000Z",
"source": "sportsnet.ca",
"categories": [
"sports"
],
"relevance_score": null
},
{
"uuid": "1fc86a37-9e22-4e25-9297-7682b4227b0a",
"title": "【イベント】『ワクワク体験スタンプラリー in 宍道公民館』2025年3月22日開催予定",
"description": "今年初開催！たくさんの体験ブースで様々な体験をしてスタンプを集める『ワクワク体験スタンプラリー in 宍道公民館...",
"keywords": "オープン, 松江, 跡地, 飲食店, 出雲, 米子, ラーメン, カフェ, テナント, ガソリンスタンド, 価格, リニューアル, 雲南石油, うんせき",
"snippet": "宍道公民館にて2025/3/22に開催される、\n\nワクワク体験スタンプラリーin宍道公民館\n\n初開催！たくさんの体験ブースで様?...",
"url": "https://unseki.co.jp/blog/shimane/event/19350",
"image_url": "https://i0.wp.com/unseki.co.jp/blog/wp-content/uploads/sites/2/2025/03/8ef594739b035c7d8f0e2b324eac82a1_8ffcf82c4067d256e8dec9d819af5ddb.jpg?fit=1600%2C1083&ssl=1",
"language": "ja",
"published_at": "2025-03-20T02:12:17.000000Z",
"source": "unseki.co.jp",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "0af183cc-03f4-4d08-a0f7-fa0f407fec52",
"title": "Abbott Elementary S04E18 720p HEVC x265-MeGusta EZTV Download Torrent",
"description": "Abbott Elementary S04E18 720p HEVC x265-MeGusta EZTV torrent download - download for free Abbott Elementary S04E18 720p HEVC x265-MeGusta on EZTV.",
"keywords": "",
"snippet": "Episode Breakdown\n\nAbbott Elementary TV Show S04E18\n\nSeason: 4\n\nEpisode: 18\n\nAir Date: 19 March, 2025 Download Links\n\nAdded 3 min. 49s ago by eztv (verified). T...",
"url": "https://eztvx.to/ep/2578683/abbott-elementary-s04e18-720p-hevc-x265-megusta/",
"image_url": "https://eztvx.to/favicon.ico",
"language": "en",
"published_at": "2025-03-20T02:12:13.000000Z",
"source": "eztv.re",
"categories": [],
"relevance_score": null
},
{
"uuid": "db4da20e-b3f9-4d6f-b127-ef04bf87c5a1",
"title": "Life Below Zero S23E11 Its Never Easy 720p HEVC x265-MeGusta EZTV Download Torrent",
"description": "Life Below Zero S23E11 Its Never Easy 720p HEVC x265-MeGusta EZTV torrent download - download for free Life Below Zero S23E11 Its Never Easy 720p HEVC x265-MeGu...",
"keywords": "",
"snippet": "\n\nLife Below Zero S23E11 - It's Never Easy Summary: As winter turns to spring, Alaskans must seize the warming days.\n\n\n\n",
"url": "https://eztvx.to/ep/2578684/life-below-zero-s23e11-its-never-easy-720p-hevc-x265-megusta/",
"image_url": "https://eztvx.to/favicon.ico",
"language": "en",
"published_at": "2025-03-20T02:12:13.000000Z",
"source": "eztv.re",
"categories": [],
"relevance_score": null
},
{
"uuid": "e4c9cdfb-5d69-4b7d-be57-427125992287",
"title": "Best Real cash Casinos on the internet Best Gambling enterprise Web sites to own 2025",
"description": "",
"keywords": "",
"snippet": "If your’re a fan of pokies, blackjack, roulette, and other common gambling games, Australian casinos on the internet offer a diverse set of playing feel. In t...",
"url": "https://rbbv.com.br/2025/03/19/best-real-cash-casinos-on-the-internet-best-gambling-enterprise-web-sites-to-own-2025/",
"image_url": "https://www.askgamblers.com/uploads/original/other/19/a0/13/5a7d2df3d1f07341e39b3bbcbaf2fd5bb2/lucky-hill-casino-2.png",
"language": "pt",
"published_at": "2025-03-20T02:12:08.000000Z",
"source": "rbbv.com.br",
"categories": [],
"relevance_score": null
},
{
"uuid": "8ca60e2f-ebb5-4bfa-b2ff-95721b4e4299",
"title": "The fantastic queen of queens $1 deposit Four: Basic Steps Certified Style Artwork Brings Right back The new Curtain For the Tomorrowland-Driven Ny",
"description": "",
"keywords": "",
"snippet": "Big Monsters you may enhance a good rebooted Big Creatures flick having an excellent radically the newest name you to definitely emphasizes the focus on Dumbled...",
"url": "https://rbbv.com.br/2025/03/19/the-fantastic-queen-of-queens-1-deposit-four-basic-steps-certified-style-artwork-brings-right-back-the-new-curtain-for-the-tomorrowland-driven-ny/",
"image_url": "https://d205654a3b2af1b75209-275b861a8577e42fdaf34f4c14f5e708.ssl.cf3.rackcdn.com/rNReNVEA0/YW81jSX7yVXyxb.jpg",
"language": "pt",
"published_at": "2025-03-20T02:11:52.000000Z",
"source": "rbbv.com.br",
"categories": [],
"relevance_score": null
},
{
"uuid": "88b9fd50-ef10-4d0f-8671-c9823067ec55",
"title": "Fairy Land juego de tragamonedas gratuito",
"description": "",
"keywords": "",
"snippet": "También, dichos operadores mí¡s desmesurados deben bonos distintos de este modo como giros regalado la cual obligarán referente a beneficiarse alrededor d...",
"url": "https://rbbv.com.br/2025/03/19/fairy-land-juego-de-tragamonedas-gratuito/",
"image_url": "https://www.ruleta-casino.com/wp-content/uploads/2018/10/simulador-ruleta.jpg",
"language": "pt",
"published_at": "2025-03-20T02:11:25.000000Z",
"source": "rbbv.com.br",
"categories": [],
"relevance_score": null
}
]
}
Similar News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/similar/uuid HTTP/1.1
Use this endpoint to find similar stories to a specific article based on its UUID.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2025-03-20T02:19:24 |
2025-03-20T02:19 |
2025-03-20T02 |
2025-03-20 |
2025-03 |
2025
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2025-03-20T02:19:24 |
2025-03-20T02:19 |
2025-03-20T02 |
2025-03-20 |
2025-03 |
2025
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-03-20
|
limit |
false | Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan. |
page |
false | Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of articles found for the request. |
meta > returned |
The number of articles returned on the page.
This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page. |
meta > limit |
The limit based on the limit parameter. |
meta > page |
The page number based on the page parameter. |
data > uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
data > title |
The article title. |
data > description |
The article meta description. |
data > keywords |
The article meta keywords. |
data > snippet |
The first 60 characters of the article body. |
data > url |
The URL to the article. |
data > image_url |
The URL to the article image. |
data > language |
The language of the source. |
data > published_at |
The datetime the article was published. |
data > source |
The domain of the source. |
data > categories |
Array of strings which the source is categorized as. |
data > relevance_score |
Relevance score based on the article provided. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/similar/cc11e3ab-ced0-4a42-9146-e426505e2e67?api_token=YOUR_API_TOKEN&language=en&published_on=2020-12-01
Example Response
{
"meta": {
"found": 3571,
"returned": 3,
"limit": 3,
"page": 1
},
"data": [
{
"uuid": "df4ad427-a672-4c67-b6c6-6f81aa00e164",
"title": "Tesla stock jumps after announcement it will join S&P 500 in one go",
"description": "Tesla's stock price surged early Tuesday after the company b...",
"keywords": "Business, s&p 500, stocks, tesla",
"snippet": "Tesla’s stock price surged early Tuesday after the company...",
"url": "https://nypost.com/2020/12/01/tesla-stock-jumps-on-news-it-will-join-sp-500-in-one-shot/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2020/12/tesla-52.jpg?quality=90&strip=all&w=1200",
"language": "en",
"published_at": "2020-12-01T14:35:46.000000Z",
"source": "nypost.com",
"categories": [
"business"
],
"relevance_score": 153.61266
},
{
"uuid": "c9a23881-12dd-4005-8982-7b6552a2eb50",
"title": "Tesla To Join S&P 500 With Full Market Cap On December 21",
"description": "Tesla will be added to the S&P 500 index all at once at its ...",
"keywords": "Tesla, S&P500, EV, Automotive, Stocks, Investing",
"snippet": "Tesla (NASDAQ: TSLA) will be added to the S&P 500 index all ...",
"url": "https://oilprice.com/Latest-Energy-News/World-News/Tesla-To-Join-SP-500-With-Full-Market-Cap-On-December-21.html",
"image_url": "https://d32r1sh890xpii.cloudfront.net/news/718x300/2020-12-01_xwjdajwctl.jpg",
"language": "en",
"published_at": "2020-12-01T16:30:00.000000Z",
"source": "oilprice.com",
"categories": [
"general",
"business"
],
"relevance_score": 146.92773
},
{
"uuid": "18afdb1c-7742-4016-bf8c-a2f114e11199",
"title": "Tesla to Enter S&P 500 at Full Weight in December",
"description": "The electric-vehicle maker will be added to the broad stock-...",
"keywords": "Motor Vehicles, Alternative Fuel Vehicles, Trusts Funds Financial Vehicles, Diversified Holding Companies, Automotive",
"snippet": "S&P Dow Jones Indices said it will add Tesla Inc.’s full w...",
"url": "https://www.wsj.com/articles/tesla-to-enter-s-p-500-at-full-weight-in-december-11606780897?mod=pls_whats_news_us_business_f",
"image_url": "https://images.wsj.net/im-265933/social",
"language": "en",
"published_at": "2020-12-01T00:01:00.000000Z",
"source": "online.wsj.com",
"categories": [
"business"
],
"relevance_score": 128.22346
}
]
}
News by UUID Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/uuid/uuid HTTP/1.1
Use this endpoint to find specific articles by the UUID which is returned on our search endpoints. This is useful if you wish to store the UUID to return the article later.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
Response Objects
| name | description |
|---|---|
uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
title |
The article title. |
description |
The article meta description. |
keywords |
The article meta keywords. |
snippet |
The first 60 characters of the article body. |
url |
The URL to the article. |
image_url |
The URL to the article image. |
language |
The language of the source. |
published_at |
The datetime the article was published. |
source |
The domain of the source. |
categories |
Array of strings which the source is categorized as. |
If no results are found, a resource_not_found error will be returned.
Example Request
GET https://api.thenewsapi.com/v1/news/uuid/147013d8-6c2c-4d50-8bad-eb3c8b7f5740?api_token=YOUR_API_TOKEN
Example Response
{
"uuid": "147013d8-6c2c-4d50-8bad-eb3c8b7f5740",
"title": "These Are The Four American Companies Worth Over $1 Trillion Each – 24",
"description": "America’s major market indexes set records in the early pa...",
"keywords": "",
"snippet": "These Are The Four American Companies Worth Over $1 Trillion...",
"url": "https://247wallst.com/investing/2020/10/17/these-are-the-four-american-companies-worth-over-1-trillion-each/",
"image_url": "https://247wallst.com/wp-content/uploads/2020/08/imageForEntry2-Qrj.jpg",
"language": "en",
"published_at": "2020-10-17T11:16:20.000000Z",
"source": "247wallst.com",
"categories": [
"business"
]
}
Sources Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/sources HTTP/1.1
Use this endpoint to sources to use in your news API requests. Note that the limit is 50 for all requests.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
HTTP GET Parameters
| name | required | description |
|---|---|---|
categories |
false | Comma separated list of categories to include
Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
page |
false | Use this to paginate through the result set. Default is 1.
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of sources found for the request. |
meta > returned |
The number of sources returned on the page. |
meta > limit |
The limit is 50. This currently can not be changed. |
meta > page |
The page number based on the page parameter. |
data > source_id |
The unique ID of the source feed. Use this for the source_ids or exclude_source_ids parameters in the news endpoints.
There may be many source_ids for each domain, therefore we would generally suggest using the domains filter instead the source_ids filter. |
data > domain |
The domain of the source. You can use this for the domains or exclude_domains parameters in the news endpoints. |
data > language |
The source language. |
data > locale |
The source locale. Note that only select sources have locales. |
data > categories |
Array of strings which the source is categorized as. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/sources?api_token=YOUR_API_TOKEN&language=en
Example Response
{
"meta": {
"found": 15453,
"returned": 50,
"limit": 50,
"page": 1
},
"data": [
{
"source_id": "arstechnica.com-1",
"domain": "arstechnica.com",
"language": "en",
"locale": null,
"categories": [
"tech"
]
},
{
"source_id": "adweek.com-1",
"domain": "adweek.com",
"language": "en",
"locale": null,
"categories": [
"business"
]
},
...
Errors
Errors
If your request was unsuccessful, you will receive a JSON formatted error. Below you will find the potential errors you may encounter when using the API.
Errors
| error code | HTTP status | description |
|---|---|---|
malformed_parameters |
400 |
Validation of parameters failed. The failed parameters are usually shown in the error message. |
invalid_api_token |
401 |
Invalid API token. |
usage_limit_reached |
402 |
Usage limit of your plan has been reached. Usage limit and remaining requests can be found on the X-UsageLimit-Limit header. |
endpoint_access_restricted |
403 |
Access to the endpoint is not available on your current subscription plan. |
resource_not_found |
404 |
Resource could not be found. |
invalid_api_endpoint |
404 |
API route does not exist. |
rate_limit_reached |
429 |
Too many requests in the past 60 seconds. Rate limit and remaining requests can be found on the X-RateLimit-Limit header. |
server_error |
500 |
A server error occured. |
maintenance_mode |
503 |
The service is currently under maintenance. |
Example Error Response
{
"error": {
"code": "malformed_parameters",
"message": "The published_before parameter(s) are incorrectly formatted."
}
}
Examples
API Examples
Our endpoints are very useful for filtering to find only specific resources you need. Follow each example request below to see how you can build dynamic queries.
Example Request 1
This is a basic request which will return all articles which match the search term "usd" within the title or body of the article:
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd
Example Request 2
This will return all articles which match the search term "usd" OR "gbp":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%7C%20gbp
Example Request 3
This will return all articles which match the search term "usd" AND "gbp":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%2B%20gbp
Example Request 4
This will return all articles which match the search term "usd" AND "gbp" but removes any articles which mentions "cad":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%2B%20gbp%20-cad
Example Request 5
This will return all articles which match the search term "forex" AND "usd" OR "gbp" but removes any articles which mentions "cad":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=forex%20%2B%20%28usd%20%7C%20gbp%29%20-cad
Example Request 6
This is the same as Example Request 5 but will also ensure the articles returned are in English and categorized by business or tech but not travel, and are published within the last week:
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=forex%20%2B%20%28usd%20%7C%20gbp%29%20-cad&language=en&categories=business%2Ctech&exclude_categories=travel&published_after=2025-03-13
Code Examples
See our prepared examples below to quickly get started implementing our API into your next project.
PHP
$queryString = http_build_query([
'api_token' => 'YOUR_API_TOKEN',
'categories' => 'business,tech',
'search' => 'apple',
'limit' => 50,
]);
$ch = curl_init(sprintf('%s?%s', 'https://api.thenewsapi.com/v1/news/all', $queryString));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($ch);
curl_close($ch);
$apiResult = json_decode($json, true);
print_r($apiResult);
Python
# Python 3
import http.client, urllib.parse
conn = http.client.HTTPSConnection('api.thenewsapi.com')
params = urllib.parse.urlencode({
'api_token': 'YOUR_API_TOKEN',
'categories': 'business,tech',
'limit': 50,
})
conn.request('GET', '/v1/news/all?{}'.format(params))
res = conn.getresponse()
data = res.read()
print(data.decode('utf-8'))
Go
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://thenewsapi.com")
baseURL.Path += "v1/news/all"
params := url.Values{}
params.Add("api_token", "YOUR_API_TOKEN")
params.Add("categories", "business,tech")
params.Add("search", "apple")
params.Add("limit", "50")
baseURL.RawQuery = params.Encode()
req, _ := http.NewRequest("GET", baseURL.String(), nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(string(body))
}
JavaScript
var requestOptions = {
method: 'GET'
};
var params = {
api_token: 'YOUR_API_TOKEN',
categories: 'business,tech',
search: 'apple',
limit: '50'
};
var esc = encodeURIComponent;
var query = Object.keys(params)
.map(function(k) {return esc(k) + '=' + esc(params[k]);})
.join('&');
fetch("https://api.thenewsapi.com/v1/news/all?" + query, requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
C#
var client = new RestClient("https://api.thenewsapi.com/v1/news/all");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddQueryParameter("api_token", "YOUR_API_TOKEN");
request.AddQueryParameter("categories", "business,tech");
request.AddQueryParameter("search", "apple");
request.AddQueryParameter("limit", "50");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
Java
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
HttpUrl.Builder httpBuilder = HttpUrl.parse("https://api.thenewsapi.com/v1/news/all").newBuilder();
httpBuilder.addQueryParameter("api_token", "YOUR_API_TOKEN");
httpBuilder.addQueryParameter("categories", "business,tech");
httpBuilder.addQueryParameter("search", "apple");
httpBuilder.addQueryParameter("limit", "50");
Request request = new Request.Builder().url(httpBuilder.build()).build();
Response response = client.newCall(request).execute();