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: 2026-08-15
|
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": "5df2332e-3c48-4456-a278-8b1e69456851",
"title": "Multiple shooters and 5 people shot at Virginia State University",
"description": "A shooting involving multiple suspects and five people shot at Virginia State University prompted a campus lockdown early Saturday.",
"keywords": "Colleges and universities, Shootings, General news, Crime, Law enforcement, Gun violence, AP Top News, Virginia, U.S. news",
"snippet": "Add AP News as your preferred source to see more of our stories on Google.\n\nAdd AP News on Google Add AP News as your preferred source to see more of our storie...",
"url": "https://apnews.com/article/virginia-state-university-shooting-campus-lockdown-783d5190d7fe0818fc27a98123311dc3",
"image_url": "https://dims.apnews.com/dims4/default/295c329/2147483647/strip/true/crop/675x450+12+0/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F90%2F29%2F4e3c1cc7446089a9101a7bdff4c8%2Fdefaultshareimage-copy.png",
"language": "en",
"published_at": "2026-08-15T12:23:02.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"locale": "us",
"similar": [
{
"uuid": "064c47de-c761-4046-bd39-e1a3921e31ce",
"title": "Israeli airstrike on southern Lebanon kills 7 people, Lebanese state media say",
"description": "An Israeli airstrike on southern Lebanon has killed seven people and wounded three. The strike targeted a home near the village of Ansar early Saturday.",
"keywords": "General news, 2024-2025 Mideast Wars, Israel, War and unrest, Hezbollah, Israel government, Military and defense, MIDEAST WARS, AP Top News, Ali Taher, World news, 2024-2026 Mideast wars",
"snippet": "Add AP News as your preferred source to see more of our stories on Google.\n\nAdd AP News on Google Add AP News as your preferred source to see more of our storie...",
"url": "https://apnews.com/article/southern-lebanon-israel-strike-hezbollah-iran-ansar-1124fd2bd0b7ed76b0e97683dddbcaad",
"image_url": "https://dims.apnews.com/dims4/default/1603c35/2147483647/strip/true/crop/1189x792+6+0/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fb6%2F80%2F1f234e4c775a1021964fcca76a93%2F4722cad569ec45fdb8e221cd309b3919",
"language": "en",
"published_at": "2026-08-15T06:23:01.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "e1bcc230-6dae-43aa-9ab8-342d8614ecc9",
"title": "Multiple people shot at Virginia State University, campus on lockdown: police",
"description": "Multiple people were injured in a shooting at Virginia State University on Saturday morning. VSU's campus remains on lockdown as police investigate.",
"keywords": "virginia, college, mass shootings, education, trending news",
"snippet": "NEW You can now listen to Fox News articles!\n\nMultiple people were shot at Virginia State University on Saturday morning, and the campus remains on lockdown, ac...",
"url": "https://www.foxnews.com/us/multiple-people-shot-virginia-state-university-campus-lockdown-police",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/08/virginia_state_university.jpg",
"language": "en",
"published_at": "2026-08-15T11:41:38.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "463691e8-c393-4343-84ab-86f7546ac98e",
"title": "Mass shooting at Virginia State University leaves several wounded, puts campus on lockdown",
"description": "A mass shooting rocked Virginia State University Saturday morning that left several people wounded and the campus on lockdown.",
"keywords": "US News, Colleges and universities, mass shootings, police, virginia",
"snippet": "See more of our coverage in your search results.\n\nA mass shooting rocked Virginia State University Saturday morning that left several people wounded and the cam...",
"url": "https://nypost.com/2026/08/15/us-news/mass-shooting-at-virginia-state-university-leaves-several-wounded-puts-campus-on-lockdown/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/08/VSU-comp.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-08-15T11:59:03.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "5ffb22e6-a3c5-40dc-a6cf-adf9596a567a",
"title": "5 people injured in shooting with multiple shooters at Virginia State University",
"description": "Five people were injured in the shooting involving multiple suspects. One person is currently listed in critical condition, the university said.",
"keywords": "Virginia",
"snippet": "Multiple people were injured in a shooting involving multiple suspects at Virginia State University, prompting a temporary campus lockdown early Saturday, the u...",
"url": "https://www.cbsnews.com/news/shooting-virginia-state-university/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/06/09/e551616f-07d3-4874-a564-5f4c90eb0f5c/thumbnail/1200x630/0787ec850374917f1666fea60d8cf294/gettyimages-2268337749.jpg",
"language": "en",
"published_at": "2026-08-15T12:42:21.000000Z",
"source": "cbsnews.com",
"categories": [
"general"
],
"locale": "us"
}
]
},
{
"uuid": "c98b1a1d-246e-4d28-96c9-4f3f49a2ac48",
"title": "What to know about Luigi Mangione's guilty plea in killing of UnitedHealthcare CEO Brian Thompson",
"description": "Luigi Mangione’s guilty plea to federal stalking-to-kill charges has raised questions about how it’ll affect his state murder case and what his lawyers might do to prevent Mangione from spending the rest of his life in prison",
"keywords": "Trials, Courts, General news, Indictments, Homicide, Legal proceedings, U.S. news",
"snippet": "Luigi Mangione’s guilty plea to federal stalking-to-kill charges has raised questions about how it’ll affect his state murder case and what his lawyers migh...",
"url": "https://abcnews.com/US/wireStory/luigi-mangiones-guilty-plea-killing-unitedhealthcare-ceo-brian-135665661",
"image_url": "https://i.abcnewsfe.com/a/2309ac9b-f726-48fc-9456-8ce46a9f8d8f/wirestory_30a8a0ae9f58ddd340c010da9420e784_16x9.jpg?w=1600",
"language": "en",
"published_at": "2026-08-15T06:19:25.000000Z",
"source": "abcnews.go.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "d1e8c034-cea2-427a-ae1a-002a449e4054",
"title": "Luigi Mangione's Guilty Plea, Explained | Case by Case | \"48 Hours\" Podcast",
"description": "A major development in the Luigi Mangione case: after previously pleading not guilty to federal stalking charges, Mangione changed his plea to guilty and also admitted to shooting United Healthcare CEO Brian Thompson. CBS News legal analyst Caroline Polisi and CBS News legal reporter Katrina Kaufman examine what changed, why the plea change matters, and what comes next in the state murder case.",
"keywords": "Luigi Mangione, Crime, New York",
"snippet": "Luigi Mangione's Guilty Plea, Explained | Case by Case | \"48 Hours\" Podcast A major development in the Luigi Mangione case: after previously pleading not guilty...",
"url": "https://www.cbsnews.com/video/luigi-mangiones-guilty-plea-explained-case-by-case-48-hours-podcast/",
"image_url": "https://assets2.cbsnewsstatic.com/hub/i/r/2026/08/14/a84d6daa-d217-430c-937e-fd1622dbee34/thumbnail/1200x630/3249560adb77cfc5fd63b049e8d19dfa/mangione-ap26223510502426.jpg",
"language": "en",
"published_at": "2026-08-15T02:10:30.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "227fe852-316b-42d1-ad05-720cf1c0e49f",
"title": "What to know about Luigi Mangione’s guilty plea in killing of UnitedHealthcare CEO Brian Thompson",
"description": "Luigi Mangione’s guilty plea to federal stalking-to-kill charges has raised questions about how it’ll affect his state murder case and what his lawyers might do to prevent Mangione from spending the rest of his life in prison.",
"keywords": "Brian Thompson, General news, Luigi Mangione, Legal proceedings, Indictments, Homicide, Trials, Domestic News, New York City, New York, Karen Friedman Agnifilo, Margaret Garnett, Jamie McDonald, U.S. news, Alvin Bragg, Courts, Manhattan, Gregory Carro, U.S. News",
"snippet": "Add AP News as your preferred source to see more of our stories on Google.\n\nAdd AP News on Google Add AP News as your preferred source to see more of our storie...",
"url": "https://apnews.com/article/luigi-mangione-plea-unitedhealthcare-ceo-30a8a0ae9f58ddd340c010da9420e784",
"image_url": "https://dims.apnews.com/dims4/default/32c2089/2147483647/strip/true/crop/7776x5181+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Ff9%2F58%2F9781bbe89c4348bcd0dbf9b0ba7b%2F94347bab0f0145cd865a8a6634535096",
"language": "en",
"published_at": "2026-08-15T04:23:02.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"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: 2026-08-15T13:28:34 |
2026-08-15T13:28 |
2026-08-15T13 |
2026-08-15 |
2026-08 |
2026
|
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: 2026-08-15T13:28:34 |
2026-08-15T13:28 |
2026-08-15T13 |
2026-08-15 |
2026-08 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-08-15
|
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": 1685765,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "fc76624d-e917-4517-a3e0-85117bb11bce",
"title": "Ozempic is not just a weight-loss story anymore",
"description": "GLP-1 drugs became famous for weight loss. But new research suggests they may also help with sleep apnea, kidney disease, liver disease, heart risk, and more.",
"keywords": "",
"snippet": "is a senior editorial director at Vox, covering AI and other subjects for the Future Perfect section and audio/video, and writing the Good News newsletter. He w...",
"url": "https://www.vox.com/future-perfect/499434/ozempic-glp1-wegovy-obesity-overweight-diabetes",
"image_url": "https://platform.vox.com/wp-content/uploads/sites/2/2026/08/GettyImages-2279484882.jpg?quality=90&strip=all&crop=0%2C10.732984293194%2C100%2C78.534031413613&w=1200",
"language": "en",
"published_at": "2026-08-15T12:59:35.000000Z",
"source": "vox.com",
"categories": [
"general",
"politics",
"entertainment"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "12c86dbf-ba8d-4666-9429-1ed3d0101733",
"title": "US pulls last aircraft carrier in Asia as Trump focuses on Iran and the Western Hemisphere",
"description": "President Donald Trump’s war against Iran is stretching the limits of the nation’s aircraft carriers and leaving the western Pacific without one of the key ...",
"keywords": "Donald Trump, George Washington, Abraham Lincoln, Iran war, Pacific Ocean, China, Asia, Military and defense, U.S.-Venezuela conflict, General news, Asia Pacific, Trump hub, Daryl Caudle, Mental health, Theodore Roosevelt, Evan Sankey, Robert Farley, Government and politics, United States government, China government, Gerald Ford, Washington news, Greg Poling, Nicolas Maduro, Bryan Clark, World news, Michael Swaine, Iran, War and unrest, Frank Bradley, Politics, World News",
"snippet": "Add AP News as your preferred source to see more of our stories on Google.\n\nAdd AP News on Google Add AP News as your preferred source to see more of our storie...",
"url": "https://apnews.com/article/aircraft-carriers-trump-china-pacific-iran-war-87cfb838de8c13464fa3cab1840ad87d",
"image_url": "https://dims.apnews.com/dims4/default/67d5696/2147483647/strip/true/crop/3840x2559+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F8f%2F49%2F8e818c83a337221543092f6b44ff%2F7cd15703625d45bfa28a084fdd6387e8",
"language": "en",
"published_at": "2026-08-15T12:53:02.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "dc041a2a-ceeb-4040-a8dc-c562896c60bd",
"title": "Berkshire adds $17 billion to Alphabet stake",
"description": "Google parent Alphabet is now the third largest holding in Berkshire Hathaway's equity portfolio.",
"keywords": "Berkshire Hathaway Inc, Breaking News: Markets, Coca-Cola Co, Markets, Apple Inc, American Express Co, Delta Air Lines Inc, Macy's Inc, Lennar Corp, Ally Financial Inc, Capital One Financial Corp, Bank of America Corp, United States, Alphabet Class A, Mitsubishi UFJ Financial Group Inc, State Street Financial Select Sector SPDR ETF, iShares U.S. Home Construction ETF, Spdr S&P Homebuilders Etf, SPDR S&P 500 ETF Trust, Warren Buffett, Berkshire Hathaway Inc, business news",
"snippet": "In this article BRK.B\n\nGOOGL\n\nBRK.B Follow your favorite stocks CREATE FREE ACCOUNT\n\n(This is the Warren Buffett Watch newsletter, news and analysis on all thin...",
"url": "https://www.cnbc.com/2026/08/15/berkshire-adds-17-billion-to-alphabet-stake.html",
"image_url": "https://image.cnbcfm.com/api/v1/image/108140490-1746283733049-BUFFETT_3.jpg?v=1747341825&w=1920&h=1080",
"language": "en",
"published_at": "2026-08-15T12:50:41.000000Z",
"source": "cnbc.com",
"categories": [
"general",
"business"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "f894cf6b-45ca-4584-9b69-a47495001969",
"title": "How a squeegee saved six men trapped on an elevator on 9/11: new docuseries",
"description": "A National Geographic docuseries premiering Aug. 21 reunites survivors of the 9/11 terrorist attacks on the Twin Towers 25 years later with the strangers and re...",
"keywords": "Metro, US News, 9/11, Docuseries, elevators, hulu, national geographic, port authority, reunions, twin towers, windows, world trade center",
"snippet": "See more of our coverage in your search results.\n\nWhen al-Qaeda terrorists struck the World Trade Center on 9/11, six strangers found themselves trapped in an e...",
"url": "https://nypost.com/2026/08/15/us-news/how-a-squeegee-saved-six-trapped-on-an-elevator-on-9-11-new-docuseries/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/08/crop-40342823.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-08-15T12:45:00.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "5ffb22e6-a3c5-40dc-a6cf-adf9596a567a",
"title": "5 people injured in shooting with multiple shooters at Virginia State University",
"description": "Five people were injured in the shooting involving multiple suspects. One person is currently listed in critical condition, the university said.",
"keywords": "Virginia",
"snippet": "Multiple people were injured in a shooting involving multiple suspects at Virginia State University, prompting a temporary campus lockdown early Saturday, the u...",
"url": "https://www.cbsnews.com/news/shooting-virginia-state-university/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/06/09/e551616f-07d3-4874-a564-5f4c90eb0f5c/thumbnail/1200x630/0787ec850374917f1666fea60d8cf294/gettyimages-2268337749.jpg",
"language": "en",
"published_at": "2026-08-15T12:42:21.000000Z",
"source": "cbsnews.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "966c3752-0c2e-41eb-ae54-4c255aa81039",
"title": "Between earn-nothing cash, broken long-term bonds, these are the safety trades of 2026 market",
"description": "Investors have flocked to short-term investments like ultra-short bond funds in anticipation of a stock market correction and with long-term bonds broken.",
"keywords": "Personal saving, Personal finance, Retirement planning, Suppress Zephr, Bonds, Breaking News: Investing, Investment strategy, iShares 20+ Year Treasury Bond ETF, U.S. 10 Year Treasury, iShares 7-10 Year Treasury Bond ETF, S&P 500 Index, Exchange-traded funds, JPMorgan Ultra-Short Income ETF, iShares 7-10 Year Treasury Bond ETF, iShares 20+ Year Treasury Bond ETF, United States, business news",
"snippet": "Many investors are turning to short-term investments, particularly ultra-short bond funds, amid persistent concerns that the equity market is headed for an inev...",
"url": "https://www.cnbc.com/2026/08/15/cash-money-market-funds-bonds.html",
"image_url": "https://image.cnbcfm.com/api/v1/image/108132076-17447271382025-04-15t140040z_2020330777_rc2dydafad3y_rtrmadp_0_usa-trump-tariffs-ratings.jpeg?v=1744727164&w=1920&h=1080",
"language": "en",
"published_at": "2026-08-15T12:30:01.000000Z",
"source": "cnbc.com",
"categories": [
"general",
"business"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "3e4aa462-13bf-4cf5-9c60-28d61530d19f",
"title": "NYC designer Martha Nolan-O’Slatarra 'harassed,' accused of fraud by boat owner days before death: texts",
"description": "Texts show NYC designer Martha Nolan-O’Slatarra said she was being \"harassed\" by financier Chris Durnan days before she was found dead on his Montauk boat.",
"keywords": "Metro, US News, Long Island, deaths, ireland, montauk, montauk yacht club, suffolk county, suffolk county police, the hamptons",
"snippet": "See more of our coverage in your search results.\n\nHamptons fashion entrepreneur Martha Nolan-O’Slatarra said she was being “harassed” and accused of fraud...",
"url": "https://nypost.com/2026/08/15/us-news/nyc-designer-martha-nolan-oslatarra-harassed-accused-of-fraud-by-boat-owner-days-before-death-texts/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/08/Comp-01.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-08-15T12:30:00.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "80bc0cff-e12c-4e8e-9725-ba6bb446f4c3",
"title": "Houston woman killed by gunman after domestic fight spins out of control",
"description": "A maniac in Houston fatally shot a woman and injured three others after a domestic spat spun out of control early Saturday, police said.",
"keywords": "US News, houston, shootings, texas",
"snippet": "See more of our coverage in your search results.\n\nA maniac in Houston fatally shot a woman and injured three others after a domestic spat spun out of control ea...",
"url": "https://nypost.com/2026/08/15/us-news/houston-woman-killed-by-gunman-after-domestic-fight-spins-out-of-control/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/08/137495374.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-08-15T12:29:18.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "5df2332e-3c48-4456-a278-8b1e69456851",
"title": "Multiple shooters and 5 people shot at Virginia State University",
"description": "A shooting involving multiple suspects and five people shot at Virginia State University prompted a campus lockdown early Saturday.",
"keywords": "Colleges and universities, Shootings, General news, Crime, Law enforcement, Gun violence, AP Top News, Virginia, U.S. news",
"snippet": "Add AP News as your preferred source to see more of our stories on Google.\n\nAdd AP News on Google Add AP News as your preferred source to see more of our storie...",
"url": "https://apnews.com/article/virginia-state-university-shooting-campus-lockdown-783d5190d7fe0818fc27a98123311dc3",
"image_url": "https://dims.apnews.com/dims4/default/295c329/2147483647/strip/true/crop/675x450+12+0/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F90%2F29%2F4e3c1cc7446089a9101a7bdff4c8%2Fdefaultshareimage-copy.png",
"language": "en",
"published_at": "2026-08-15T12:23:02.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "bb892c6c-0e20-4cb0-9f32-bb5923d50941",
"title": "The buck stops somewhere else: A look at Trump’s tendency to avoid blame when things go awry",
"description": "Former President Harry Truman famously kept a “The Buck Stops Here” sign on his White House desk. But the current president, Donald Trump, often veers from ...",
"keywords": "Harry S. Truman, Donald Trump, Joe Biden, Iran war, Barack Obama, General news, Trump hub, AP Top News, U.S. news, Taylor Rogers, Tom Daschle, Politics, Franklin D. Roosevelt, Frank Luntz, Iran, Washington news, Inflation, Andrew Bates, George W. Bush, Iran government, John F. Kennedy, Ronald Reagan, U.S. Republican Party, U.S. News",
"snippet": "Add AP News as your preferred source to see more of our stories on Google.\n\nAdd AP News on Google Add AP News as your preferred source to see more of our storie...",
"url": "https://apnews.com/article/trump-dodging-responsibility-buck-stops-here-truman-305caf9eaeee3d479f099e2423de8741",
"image_url": "https://dims.apnews.com/dims4/default/ab02d39/2147483647/strip/true/crop/2597x1730+0+3/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fdc%2Fd5%2Fe51ba81a6ac7925ed48bdcf8fc1c%2F5e89021a0465468186a49ddb00b3c3e9",
"language": "en",
"published_at": "2026-08-15T12:23:02.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"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: 2026-08-15T13:28:34 |
2026-08-15T13:28 |
2026-08-15T13 |
2026-08-15 |
2026-08 |
2026
|
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: 2026-08-15T13:28:34 |
2026-08-15T13:28 |
2026-08-15T13 |
2026-08-15 |
2026-08 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-08-15
|
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": 54761498,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "642846d7-28e9-41ff-91be-ef31ce20551c",
"title": "100원짜리 중국산에 무너진 국산태극기… 나경원, '국산 태극기 살리기법' 발의",
"description": "[뉴스데일리]국민의힘 나경원 의원은 제81주년 광복절을 맞아 국가기관 및 공공기관이 국기를 구매할 때 국내 공정을 거?...",
"keywords": "",
"snippet": "나경원 국민의힘 의원\n\n[뉴스데일리]국민의힘 나경원 의원은 제81주년 광복절을 맞아 국가기관 및 공공기관이 국기를 구?...",
"url": "http://www.newsdaily.kr/news/articleView.html?idxno=260106",
"image_url": "https://cdn.newsdaily.kr/news/thumbnail/202608/260106_177645_2827_v150.jpg",
"language": "ko",
"published_at": "2026-08-15T13:28:05.000000Z",
"source": "newsdaily.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "149cd8fa-8246-4602-ab53-0cd2a6a0c332",
"title": "Zmiana pogody po ciepłym weekendzie. Upał ustąpi burzom",
"description": "Po ciepłym weekendzie początek tygodnia przyniesie wyraźną zmianę pogody. Jak przekazała PAP synoptyczka IMGW Anna Gryczman, w poniedziałek zrobi się ch...",
"keywords": "",
"snippet": "Po ciepłym weekendzie początek tygodnia przyniesie wyraźną zmianę pogody. Jak przekazała PAP synoptyczka IMGW Anna Gryczman, w poniedziałek zrobi się ch...",
"url": "https://www.portalspozywczy.pl/technologie/wiadomosci/zmiana-pogody-po-cieplym-weekendzie-upal-ustapi-burzom,291920.html",
"image_url": "https://pliki.portalspozywczy.pl/i/20/20/43/202043_r2_940.jpg",
"language": "pl",
"published_at": "2026-08-15T13:28:00.000000Z",
"source": "portalspozywczy.pl",
"categories": [],
"relevance_score": null
},
{
"uuid": "531d6579-90ec-4406-baa8-283031b7127b",
"title": "MEEDO米多V8AIR手持吸尘器大吸力防缠毛",
"description": "【叠加淘金币1.59元到手157元！！！】MEEDO米多V8AIR手持吸尘器！150AW大吸力 防缠毛设计，一机搞定地板、床褥、车载、缝?...",
"keywords": "",
"snippet": "注意：商品是限时、限量、限地区促销，下单时可能已变化，请您核对并理解。",
"url": "http://www.kiees.com/2026/08/15/1024981.html",
"image_url": "",
"language": "zh",
"published_at": "2026-08-15T13:27:50.000000Z",
"source": "kiees.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "8c906916-f199-4c37-8a3c-de224d4249d9",
"title": "지난 7월 반도체주 대폭락이 역대급이었다는 증거 : 클리앙",
"description": "https://finance.yahoo.com/markets/stocks/articles/jane-street-takes-15-billion-222108224.html 월가의 새로운 황제로 불리는 Jane Street이 지난 7월...",
"keywords": "",
"snippet": "https://finance.yahoo.com/markets/stocks/articles/jane-street-takes-15-billion-222108224.html\n\n\n\n\n\n월가의 새로운 황제로 불리는 Jane Street이 지난...",
"url": "https://www.clien.net/service/board/park/19247653",
"image_url": "https://edgio.clien.net/F01/2026/8/15800090/4a9c23ee94e6.jpg",
"language": "ko",
"published_at": "2026-08-15T13:27:48.000000Z",
"source": "clien.net",
"categories": [
"tech"
],
"relevance_score": null
},
{
"uuid": "b26fafd2-175c-4faf-82b6-68514989edea",
"title": "Five teams with intriguing salary-cap decisions upcoming",
"description": "After an off-season of big moves and market-setting deals, it’s hard not to look even further into the future. Sportsnet's Emily Sadler breaks down five team...",
"keywords": "",
"snippet": "The 2026-27 NHL season is still about six weeks away, but after an off-season of big moves and market-setting deals, it’s hard not to look even further into t...",
"url": "https://www.sportsnet.ca/nhl/article/five-teams-with-intriguing-salary-cap-decisions-upcoming/",
"image_url": "https://www.sportsnet.ca/wp-content/uploads/2026/06/Anaheim-Ducks-left-wing-Cutter-Gauthier.jpg",
"language": "en",
"published_at": "2026-08-15T13:26:23.000000Z",
"source": "sportsnet.ca",
"categories": [
"sports"
],
"relevance_score": null
},
{
"uuid": "26249877-b29e-4bde-877b-e7ae2161b639",
"title": "写真でたどる南極観測70年 貴重資料を極地研で展示",
"description": "1956年に日本の第1次南極地域観測隊が出発してから今年で70年となるのを記念した写真展が、東京都立川市の国立極地研...",
"keywords": "西日本新聞me, 西日本新聞, ニュース, 九州, 福岡",
"snippet": "1956年に日本の第1次南極地域観測隊が出発してから今年で70年となるのを記念した写真展が、東京都立川市の国立極地研...",
"url": "https://www.nishinippon.co.jp/item/1527179/",
"image_url": "https://www.nishinippon.co.jp/assets/nnp/img/base/og_image.png",
"language": "ja",
"published_at": "2026-08-15T13:25:16.000000Z",
"source": "nishinippon.co.jp",
"categories": [],
"relevance_score": null
},
{
"uuid": "42b074f6-d873-4b82-80d5-b498c0aec5a5",
"title": "충남경찰청, 광복절 천안·아산 일대 폭주 행위 강력 단속...112신고 전년대비 51% 감소",
"description": "[뉴스데일리]충남경찰청(청장 김호승)과 충남자치경찰위원회(위원장 이종원)는 8월 15일 광복절을 맞아 천안·아산 일대?...",
"keywords": "",
"snippet": "충남경찰청(청장 김호승)과 충남자치경찰위원회는 8월 15일 광복절을 맞아 천안·아산 일대에서 대대적인 폭주족 특별 단...",
"url": "http://www.newsdaily.kr/news/articleView.html?idxno=260105",
"image_url": "https://cdn.newsdaily.kr/news/thumbnail/202608/260105_177644_235_v150.jpg",
"language": "ko",
"published_at": "2026-08-15T13:25:12.000000Z",
"source": "newsdaily.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "a83e18d1-76c7-4a76-ae64-3779db784913",
"title": "QQ Bot接入DeepSeek Harness：支持单聊和群聊 会话互不干扰",
"description": "QQ Bot接入DeepSeek Harness：支持单聊和群聊 会话互不干扰",
"keywords": ", QQ Bot接入DeepSeek Harness：支持单聊和群聊 会话互不干扰, 快科技",
"snippet": "QQ Bot接入DeepSeek Harness：支持单聊和群聊 会话互不干扰\n\n快科技8月15日消息，腾讯QQ官宣，QQ Bot现已支持接入DeepSeek Harness官...",
"url": "https://news.mydrivers.com/1/1143/1143946.htm",
"image_url": "https://img1.mydrivers.com/img/20260815/b0d6a25d1aa64d43a3130c397bf21513.png",
"language": "zh",
"published_at": "2026-08-15T13:24:48.000000Z",
"source": "news.mydrivers.com",
"categories": [
"tech",
"general"
],
"relevance_score": null
},
{
"uuid": "39f5cb47-694d-437a-84df-60a6b4960d20",
"title": "REDMI产品经理：澎湃OS 4 Beta核心目的是搜集反馈 排查问题",
"description": "REDMI产品经理：澎湃OS 4 Beta核心目的是搜集反馈 排查问题",
"keywords": ", REDMI产品经理：澎湃OS 4 Beta核心目的是搜集反馈 排查问题, 快科技",
"snippet": "REDMI产品经理：澎湃OS 4 Beta核心目的是搜集反馈 排查问题\n\n快科技8月15日消息，小米澎湃OS 4首批Beta已经开始推送，但此前...",
"url": "https://news.mydrivers.com/1/1143/1143945.htm",
"image_url": "https://img1.mydrivers.com/img/20260815/1a92dacd9bcc48b392b3e697ee21e6b1.png",
"language": "zh",
"published_at": "2026-08-15T13:24:47.000000Z",
"source": "news.mydrivers.com",
"categories": [
"tech"
],
"relevance_score": null
},
{
"uuid": "b2bc46b4-fa8e-4775-aec2-4aa0e2adf1d2",
"title": "[포토뉴스] 진관사 태극기 펼쳐진 제81주년 광복절 서울시 타종행사 - 불교신문",
"description": "서울시가 8월 15일 제81주년 광복절을 맞아 서울 종로 보신각에서 기념 타종행사를 가졌다. ‘광복의 소리, 미래를 깨우다...",
"keywords": "",
"snippet": "제81주년 광복절인 8월15일 서울 종로 보신각에서 열린 기념 타종행사에서 대형 진관사 태극기를 배경으로 오세훈 서울시...",
"url": "http://www.ibulgyo.com/news/articleView.html?idxno=441239",
"image_url": "https://cdn.ibulgyo.com/news/thumbnail/202608/441239_476813_2012_v150.jpg",
"language": "ko",
"published_at": "2026-08-15T13:24:01.000000Z",
"source": "ibulgyo.com",
"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: 2026-08-15T13:28:34 |
2026-08-15T13:28 |
2026-08-15T13 |
2026-08-15 |
2026-08 |
2026
|
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: 2026-08-15T13:28:34 |
2026-08-15T13:28 |
2026-08-15T13 |
2026-08-15 |
2026-08 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-08-15
|
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=2026-08-08
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();