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-04-28
|
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": "c17cb4d8-6cb2-4ced-9b02-3e3465be7fd5",
"title": "What Jimmy Kimmel Said About Melania Trump: His ‘Expectant Widow’ Joke and More Controversial Remarks",
"description": "Jimmy Kimmel's 'expectant widow' quip drew condemnation from Melania Trump, the White House and critics after shooting involving Donald Trump",
"keywords": "",
"snippet": "Jimmy Kimmel caused controversy after quipping that first lady Melania Trump has a “glow like an expectant widow” days before the annual White House Corresp...",
"url": "https://www.usmagazine.com/celebrity-news/news/what-did-jimmy-kimmel-say-about-melania-trump-on-tv/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/04/What-Jimmy-Kimmel-Said-About-Melania-Trump-His-Expectant-Widow-Joke-and-More-Controversial-Remarks.jpg?crop=0px%2C0px%2C2000px%2C1051px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2026-04-27T20:17:24.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"locale": "us",
"similar": [
{
"uuid": "0d9a0c72-1d06-4a5a-b855-9c3fcccca43a",
"title": "Ex-Obama aide calls on Kimmel to apologize for 'tasteless' Trump joke ahead of assassination attempt",
"description": "David Axelrod called on Jimmy Kimmel to apologize for the \"tasteless\" joke about President Donald Trump and Melania Trump made before the third assassination attempt.",
"keywords": "jimmy kimmel, barack obama, melania trump, donald trump, assassinations murders, fox news media",
"snippet": "NEW You can now listen to Fox News articles!\n\nA top Democratic strategist for former President Barack Obama is calling on Jimmy Kimmel to apologize for the poor...",
"url": "https://www.foxnews.com/media/ex-obama-advisor-calls-kimmel-apologize-tasteless-trump-joke-assassination-attempt",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/04/david-axelrod-jimmy-kimmel.jpg",
"language": "en",
"published_at": "2026-04-27T21:22:36.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "27e2a35e-4bd5-419f-90dd-dc4ce68b2ed9",
"title": "Jimmy Kimmel isn't worth the trouble for ABC | Bobby Burack",
"description": "Jimmy Kimmel faces calls for firing from Donald Trump after a skit mocking Melania Trump. An opinion piece argues his declining ratings make him a liability for ABC.",
"keywords": "outkick analysis, jimmy kimmel, politics on late night, gutfeld, stephen colbert",
"snippet": "Jimmy Kimmel isn’t worth the problem for ABC.\n\nLast Thursday, Kimmel ran a skit parodying the White House Correspondents’ Dinner, mocking First Lady Melania...",
"url": "https://www.foxnews.com/outkick-analysis/jimmy-kimmel-isnt-worth-trouble-abc",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/04/jimmy-kimmel-melania-trump.jpg",
"language": "en",
"published_at": "2026-04-27T21:29:05.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "6659ef18-46ab-4530-ad3f-793b0271add5",
"title": "I Think I Know Why Melania Trump Really Just Went After Jimmy Kimmel",
"description": "It was another joke on Thursday night that might have gotten to her.",
"keywords": "melania-trump, donald-trump, late-night, free-speech",
"snippet": "Sign up for the Slatest to get the most insightful analysis, criticism, and advice out there, delivered to your inbox daily.\n\nEven those of us who don’t consi...",
"url": "https://slate.com/life/2026/04/melania-trump-jimmy-kimmel-assasination-attempt-news.html?via=rss",
"image_url": "https://compote.slate.com/images/e93b9751-0774-4967-a5f6-a43a809a65ee.jpeg?crop=7942%2C5295%2Cx1%2Cy0&width=1560",
"language": "en",
"published_at": "2026-04-27T22:39:54.000000Z",
"source": "slate.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "58ffdbe3-2457-4381-9bf5-bb49adb3842b",
"title": "Disney under fire as ABC grapples with another Jimmy Kimmel controversy",
"description": "Critics are taking aim at Disney as ABC grapples another controversy surrounding its host Jimmy Kimmel over his poorly-timed joke targeting President Donald Trump and First Lady Melania Trump.",
"keywords": "jimmy kimmel, donald trump, melania trump, fox news media, disney",
"snippet": "NEW You can now listen to Fox News articles!\n\nThe latest controversy hovering over liberal comedian Jimmy Kimmel is leaving a sour taste among those in ABC's or...",
"url": "https://www.foxnews.com/media/disney-under-fire-abc-grapples-another-jimmy-kimmel-controversy",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/09/jimmy-kimmel-may-2025-stage.jpg",
"language": "en",
"published_at": "2026-04-27T22:52:10.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "a464e4bb-85d6-470b-8c1e-330a272ce2c5",
"title": "Jimmy Kimmel repeats ‘hateful’ joke about ‘expectant widow’ Melania Trump in attempt to defend himself after WHCD shooting",
"description": "Late-night host Jimmy Kimmel dared to repeat the",
"keywords": "Politics, US News, Entertainment, 2026 White House Correspondents' Dinner Shooting, donald trump, jimmy kimmel, jimmy kimmel live, melania trump, white house correspondents’ dinner",
"snippet": "Late-night host Jimmy Kimmel dared to repeat the “hateful” ill-timed joke he made about first lady Melania Trump looking like an “expectant widow” in a ...",
"url": "https://nypost.com/2026/04/28/us-news/jimmy-kimmel-repeats-hateful-joke-about-melania-trump-in-attempt-to-defend-himself/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/04/jimmy-kimmel-defends-himself-by-telling-crude-melania-trump-joke-again.jpg?quality=75&strip=all&1777335311&w=1200",
"language": "en",
"published_at": "2026-04-28T04:19:15.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"locale": "us"
}
]
},
{
"uuid": "d7e1126f-1ff1-4034-b988-6964d67309ad",
"title": "Correspondents' dinner shooting rekindles DHS funding fight: What to know",
"description": "The shooting at the White House Correspondents' Association Dinner has renewed calls from lawmakers to fund the Department of Homeland Security.",
"keywords": "",
"snippet": "Security officials evacuate U.S. House Speaker Mike Johnson at the annual White House Correspondents' Association dinner in Washington, April 25, 2026.\n\nSecurit...",
"url": "https://abcnews.com/Politics/correspondents-dinner-shooting-rekindles-dhs-funding-fight/story?id=132422234",
"image_url": "https://i.abcnewsfe.com/a/8070a086-1f54-4e94-b59b-4f64befa53d0/donald-trump-9-rt-gmh-260425_1777164684022_hpMain_16x9.jpg?w=1600",
"language": "en",
"published_at": "2026-04-27T19:29:46.000000Z",
"source": "abcnews.go.com",
"categories": [
"general"
],
"locale": "us",
"similar": [
{
"uuid": "c1b2bfcb-c258-4cb2-bd05-0a242def40bc",
"title": "Inside the White House Correspondents' Dinner shooting",
"description": "Prosecutors on Monday charged the man accused of opening fire at the White House Correspondents' Dinner on Saturday with three counts, including the attempted assassination of President Trump. CBS News' Jake Rosen, Nicole Sganga and Aaron Navarro have the latest.",
"keywords": "Shooting, United States Secret Service, Donald Trump, United States Department of Justice, Politics, Crime",
"snippet": "Inside the White House Correspondents' Dinner shooting Prosecutors on Monday charged the man accused of opening fire at the White House Correspondents' Dinner o...",
"url": "https://www.cbsnews.com/video/inside-white-house-correspondents-dinner-shooting/",
"image_url": "https://assets2.cbsnewsstatic.com/hub/i/r/2026/04/27/38a383ca-278d-456e-af09-350fa28ffcf1/thumbnail/1200x630/5d4284d5e842dff2098b4bb30f6ad25a/cbsn-fusion-inside-white-house-correspondents-dinner-shooting-thumbnail.jpg",
"language": "en",
"published_at": "2026-04-27T22:43:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "b27ea831-9ca7-4994-957d-9b21d4a2965f",
"title": "White House correspondents' dinner shooting: Timeline of chaos",
"description": "Here is a timeline of events leading up to Saturday night's shooting and its aftermath at the White House Correspondents' Association Dinner.",
"keywords": "",
"snippet": "The suspect was identified as Cole Allen, 31, of California, officials said.\n\nSecret Service agents surround President Donald Trump as mentalist, Oz Pearlman st...",
"url": "https://abcnews.com/US/white-house-correspondents-dinner-shooting-timeline-chaos/story?id=132413783",
"image_url": "https://i.abcnewsfe.com/a/f9d88ecf-c091-4c3b-8ab6-9389a0bcaf7b/whcd-pearlman-trump-20260426-ap-jh_1777224364949_hpMain_16x9.jpg?w=1600",
"language": "en",
"published_at": "2026-04-27T21:53:23.000000Z",
"source": "abcnews.go.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "134f87d7-0809-45e3-9390-825a0863deda",
"title": "Trump administration blames heightened political rhetoric for correspondents' dinner shooting",
"description": "The shooting at the White House Correspondents' Dinner is shedding light on the increase in political rhetoric and violence in the U.S. Trump administration officials have pointed the finger at Democrats and the media. CBS News political director Fin Gómez joins with analysis.",
"keywords": "Shooting, Republicans, United States Secret Service, Donald Trump, Politics, Democrats",
"snippet": "Trump administration blames heightened political rhetoric for correspondents' dinner shooting The shooting at the White House Correspondents' Dinner is shedding...",
"url": "https://www.cbsnews.com/video/trump-administration-blames-heightened-political-rhetoric-correspondents-dinner-shooting/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/04/27/bda73f9d-bfc2-4b3c-af98-f2faf1780bc8/thumbnail/1200x630/bb9b22f095b47f99284f57d1e2ce82df/cbsn-fusion-trump-administration-blames-heightened-political-rhetoric-correspondents-dinner-shooting-thumbnail.jpg",
"language": "en",
"published_at": "2026-04-27T23:27:46.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "b01f4201-8344-4870-8f1e-aa4d7276ec21",
"title": "New details on suspect's movements ahead of correspondents' dinner shooting",
"description": "We are learning more about the suspect and his movements ahead of Saturday night's alleged assassination attempt of President Trump at the White House Correspondents' Dinner. CBS News' Anna Schecter has the details.",
"keywords": "Shooting, United States Secret Service, Donald Trump, United States Department of Justice, Crime",
"snippet": "New details on suspect's movements ahead of correspondents' dinner shooting We are learning more about the suspect and his movements ahead of Saturday night's a...",
"url": "https://www.cbsnews.com/video/new-details-suspect-movements-ahead-of-correspondents-dinner-shooting/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/04/27/d8fd7642-a322-469b-b68c-8fc2afeaf973/thumbnail/1200x630/74ace15f89c867faaa8e1175b6f692a4/cbsn-fusion-new-details-suspect-movements-ahead-of-correspondents-dinner-shooting-thumbnail.jpg",
"language": "en",
"published_at": "2026-04-27T23:28:47.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "918d1a59-7a80-447f-9c46-f8f881abc2e8",
"title": "Why the planned White House ballroom couldn't host correspondents' dinner",
"description": "President Trump has used Saturday's shooting to renew his push for his presidential ballroom and East Wing renovations at the White House. CBS News' Lindsey Reiser takes a look at some of the reasons why the white house may not be an appropriate venue to hold the correspondents' dinner.",
"keywords": "Shooting, Donald Trump, Politics",
"snippet": "Why the planned White House ballroom couldn't host correspondents' dinner President Trump has used Saturday's shooting to renew his push for his presidential ba...",
"url": "https://www.cbsnews.com/video/why-planned-white-house-ballroom-couldnt-host-correspondents-dinner/",
"image_url": "https://assets2.cbsnewsstatic.com/hub/i/r/2026/04/27/933464c4-8018-4e26-a4a4-ce17bfd4f7ad/thumbnail/1200x630/89b4ef84e13da993c3b267b1c9ebf941/cbsn-fusion-why-planned-white-house-ballroom-couldnt-host-correspondents-dinner-thumbnail.jpg",
"language": "en",
"published_at": "2026-04-27T23:30:29.000000Z",
"source": "cbsnews.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: 2026-04-28T07:23:50 |
2026-04-28T07:23 |
2026-04-28T07 |
2026-04-28 |
2026-04 |
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-04-28T07:23:50 |
2026-04-28T07:23 |
2026-04-28T07 |
2026-04-28 |
2026-04 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-04-28
|
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": 1609429,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "db387f96-267f-483f-95dc-81281fd57d67",
"title": "Inside Jay Leno and Wife Mavis Leno's Enduring Relationship",
"description": "Jay Leno and Mavis Leno's love story is one of nonstop support. And nothing matters more to the comedian than keeping his wife, who's battling dementia, laughin...",
"keywords": "",
"snippet": "Watch : Jay Leno Says He Was Asked If He Would “Get a Girlfriend” Amid His Wife’s Dementia Battle\n\nJay Leno has entertained millions of people over the ye...",
"url": "https://www.eonline.com/news/1416715/jay-leno-wife-mavis-lenos-5-decade-love-story?cmpid=rss-syndicate-genericrss-us-top_stories",
"image_url": "https://akns-images.eonline.com/eol_images/Entire_Site/20250428/283cfc7d-4890-4ad7-92b2-b4b31b0467a6_1745857448.jpg?fit=around%7C1080:1080&output-quality=90&crop=1080:1080;center,top",
"language": "en",
"published_at": "2026-04-28T07:00:00.000000Z",
"source": "eonline.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "52461a69-1682-4138-98e2-0dc6097893e6",
"title": "Oil major BP beats profit expectations as Iran war boosts fuel prices",
"description": "The results come shortly after BP's board suffered a shareholder revolt at its annual general meeting.",
"keywords": "Earnings, Oil and Gas, Energy, Breaking News: Europe, Europe Earnings, TotalEnergies SE, Business, BP PLC, Environment, TotalEnergies SE, Iran, business news",
"snippet": "British energy major BP on Tuesday reported stronger-than-expected first-quarter profit, following a surge in oil and gas prices driven by the Middle East confl...",
"url": "https://www.cnbc.com/2026/04/28/bp-q1-earnings-oil-energy.html",
"image_url": "https://image.cnbcfm.com/api/v1/image/108152372-1748602162238-gettyimages-2209616466-bp2-1.jpeg?v=1770741762&w=1920&h=1080",
"language": "en",
"published_at": "2026-04-28T06:04:55.000000Z",
"source": "cnbc.com",
"categories": [
"general",
"business"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "a13d6ea0-e0d0-4fc1-b16b-8adde7ccb1e8",
"title": "Not just folklore: A giant kraken-like octopus terrorized the seas in the age of dinosaurs",
"description": "Gigantic octopuses may have been apex predators 100 million years ago. Many of their behaviors reflect those of octopuses today.",
"keywords": "",
"snippet": "The giant kraken, a mythical marine beast, may not be entirely fiction. New evidence suggests that octopuses up to 62 feet long likely roamed the waters of anci...",
"url": "https://theweek.com/science/giant-kraken-like-octopus-ruled-ancient-seas-cretaceous",
"image_url": "https://cdn.mos.cms.futurecdn.net/JHLaqt63GxjHe3kWTtpV5X-2000-80.jpg",
"language": "en",
"published_at": "2026-04-28T06:00:00.000000Z",
"source": "theweek.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "0ea26cab-cdf5-4642-a093-4c250602a2df",
"title": "Colorado grandpa finishes world’s largest jigsaw puzzle with 60K pieces 4 years after starting it",
"description": "A Colorado man was finally able to complete the world's largest jigsaw puzzle four years after starting the project when the brain teaser's maker sent him the 6...",
"keywords": "US News, charity, colorado, family, good news, jigsaw puzzle",
"snippet": "A Colorado grandfather finally completed the world’s largest jigsaw puzzle four years after starting the project when the brain teaser’s maker sent him the ...",
"url": "https://nypost.com/2026/04/28/us-news/colorado-grandpa-finishes-worlds-largest-jigsaw-puzzle-with-60k-pieces-4-years-after-starting-it/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/04/newspress-collage-7ihg9dkmg-1777354634146.jpg?quality=75&strip=all&1777340327&w=1200",
"language": "en",
"published_at": "2026-04-28T05:39:06.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "a7378578-3748-48b9-a151-c752d4d7f302",
"title": "Jimmy Kimmel Breaks His Silence on Donald and Melania Trump Demanding His Firing",
"description": "Jimmy Kimmel has spoken out following President Donald Trump and first lady Melania Trump demanding his firing from his late-night show",
"keywords": "",
"snippet": "Jimmy Kimmel has broken his silence over President Donald Trump and first lady Melania Trump demanding his firing from his late-night show.\n\n“Sometimes you wa...",
"url": "https://www.usmagazine.com/entertainment/news/jimmy-kimmel-breaks-silence-on-trump-calling-for-his-firing/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/04/Jimmy-Kimmel-Breaks-Silence-on-Trump-Calling-for-His-Firing-e1777352151474.jpg?crop=0px%2C0px%2C2000px%2C1051px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2026-04-28T05:36:47.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "d115dcbf-6cb5-4476-9a44-7d01806e5b41",
"title": "Kid Rock, Pete Hegseth fly in Army Apache attack helicopters weeks after viral fly-by stunt over rocker’s home draws backlash",
"description": "Kid Rock and Secretary of War Pete Hegseth took to the skies in Army Apache attack helicopters Monday — just weeks after two chopper crews got in hot water fo...",
"keywords": "US News, army, helicopters, kid rock, military, Pete Hegseth, the pentagon, viral videos",
"snippet": "Kid Rock and Secretary of War Pete Hegseth took to the skies in Army Apache attack helicopters Monday — just weeks after two chopper crews got in hot water fo...",
"url": "https://nypost.com/2026/04/28/us-news/kid-rock-pete-hegseth-fly-in-army-apache-attack-helicopters/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/04/usarmy-apache-pilots-ride-morning-126534161.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-04-28T05:34:00.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "2cf80e82-6369-445d-96e1-5b62ff1e9ddb",
"title": "Kimmel responds to Trumps' calls for his firing",
"description": "Kimmel responds to Trumps' calls for his firing",
"keywords": "",
"snippet": "IE 11 is not supported. For an optimal experience visit our site on another browser.",
"url": "https://www.nbcnews.com/video/shorts/kimmel-responds-to-trumps-calls-for-his-firing-262229061553",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/mpx/2704722219/2026_04/thumb-ho7rth.jpg",
"language": "en",
"published_at": "2026-04-28T05:25:47.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "6e7585b8-0969-428b-8d3f-04003475a2ca",
"title": "European markets to open higher as Trump considers Iran peace proposal",
"description": "European stocks are expected to open higher on Tuesday as investors assess the latest developments in the Iran war, and look ahead to earnings reports.",
"keywords": "World economy, World Markets, FTSE MIB, CAC 40 Index, DAX, FTSE 100, Novartis AG, Airbus SE, BP PLC, Barclays PLC, Donald J. Trump, United States, Prices, Iran, Foreign policy, Jerome Powell, Germany, Kevin Warsh, Italy, France, Donald Trump, business news",
"snippet": "LONDON — European stocks are expected to open higher on Tuesday as investors await Washington's response to Iranian peace proposals and look ahead to earnings...",
"url": "https://www.cnbc.com/2026/04/28/european-markets-stoxx-600-ftse-dax-cac-iran-latest-news.html",
"image_url": "https://image.cnbcfm.com/api/v1/image/108296801-1777031509213-gettyimages-2272108336-TRUMP_CEASEFIRE.jpeg?v=1777031558&w=1920&h=1080",
"language": "en",
"published_at": "2026-04-28T05:24:28.000000Z",
"source": "cnbc.com",
"categories": [
"general",
"business"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "86844339-87c4-479e-a68e-93f606f323c9",
"title": "Latin America’s Anti-Women Movement Is Spreading",
"description": "Chile's president José Antonio Kast is following the regressive examples set elsewhere in the region.",
"keywords": "",
"snippet": "Kast already has his eye on changing the sex education that is taught in schools. During his first presidential campaign in 2017, Kast proposed removing school ...",
"url": "https://foreignpolicy.com/2026/04/28/chile-kast-latin-america-anti-women-movement-spreading/",
"image_url": "https://foreignpolicy.com/wp-content/uploads/2026/04/1-chile-anti-women-presiden-fuller-project-Illustration-Jawhar-Soudani.jpg",
"language": "en",
"published_at": "2026-04-28T05:17:54.000000Z",
"source": "foreignpolicy.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "5af98395-b031-4aa0-98fd-a3e067f6c2a2",
"title": "Today's NYT Mini Crossword Answers for April 28",
"description": "Here's today's NYT Mini Crossword answer. These answers will help you solve New York Times' popular crossword game, Mini Crossword, every day!",
"keywords": "",
"snippet": "Gael Cooper\n\nCNET editor Gael Fashingbauer Cooper, a journalist and pop-culture junkie, is co-author of \"Whatever Happened to Pudding Pops? The Lost Toys, Taste...",
"url": "https://www.cnet.com/tech/gaming/todays-nyt-mini-crossword-answers-for-tuesday-april-28/",
"image_url": "https://www.cnet.com/a/img/resize/4a7dc34963db8f9a51abae1ab77ec99b498be36f/hub/2024/07/25/50d61b9b-1c76-4678-9a92-f6eca531f4a8/nyt-mini-crossword-234876.jpg?auto=webp&fit=crop&height=675&width=1200",
"language": "en",
"published_at": "2026-04-28T05:07:02.000000Z",
"source": "cnet.com",
"categories": [
"tech",
"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-04-28T07:23:50 |
2026-04-28T07:23 |
2026-04-28T07 |
2026-04-28 |
2026-04 |
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-04-28T07:23:50 |
2026-04-28T07:23 |
2026-04-28T07 |
2026-04-28 |
2026-04 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-04-28
|
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": 54040854,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "4bfb92e6-7292-44e0-b156-1affe4ca5111",
"title": "Base das Lajes: \"seria ingénuo, se estivesse otimista da possibilidade de alguma alteração\"",
"description": "\"No curto prazo, confesso que seria ingénuo, se estivesse otimista da possibilidade de alteração\" no acordo que Portugal e os Estados Unidos da América (EUA...",
"keywords": "RTP, Notícias, RTP Notícias",
"snippet": "desfavorável” para Portugal, “temos de compreender que existem ambientes para diálogo e negociação com lealdade” e que esta não é a melhor altura da...",
"url": "https://www.rtp.pt/noticias/politica-com-assinatura/base-das-lajes-seria-ingenuo-se-estivesse-otimista-da-possibilidade-de-alguma-alteracao_v1737253",
"image_url": "https://cdn-images.rtp.pt/icm/noticias/images/1e/1e0f1bac2c5168eed42338d978ceb07b?q=90&rect=0,0,1920,1080&auto=format",
"language": "pt",
"published_at": "2026-04-28T07:23:37.000000Z",
"source": "rtp.pt",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "5c6c90b3-1d9d-4ca7-88fc-0835e48984c2",
"title": "종전협상 교착에 뉴욕증시 혼조…나스닥 0.2%↑",
"description": "뉴욕증시 3대 주가지수가 혼조 마감했다. 미국과 이란의 종전 협상이 교착 상태에서 빠져나오지를 못하면서 기대감으로 ...",
"keywords": "뉴욕증시, 다우존스30, S&P500, 나스닥, 미국, 이란, 협상, 유가",
"snippet": "미국과 이란의 종전 협상이 난항에 빠지면서 뉴욕증시 3대 주가지수가 혼조 마감했다. 사진/pixabay\n\n뉴욕증시 3대 주가지?...",
"url": "http://www.smedaily.co.kr/news/articleView.html?idxno=356228",
"image_url": "https://cdn.smedaily.co.kr/news/thumbnail/202604/356228_291421_198_v150.jpg",
"language": "ko",
"published_at": "2026-04-28T07:23:01.000000Z",
"source": "smedaily.co.kr",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "0d52e151-ed12-4daf-9753-6dc5f697863e",
"title": "Kooperationen prägen das Innovationsgeschehen deutscher Hochschulen",
"description": "Deutsche Hochschulen melden Patente deutlich häufiger in Kooperation mit Forschungspartnern an als andere Akteure. Mit 29,2 Prozent liegt ihr Kooperationsantei...",
"keywords": "IW, Institut der deutschen Wirtschaft (IW)",
"snippet": "Deutsche Hochschulen melden Patente deutlich häufiger in Kooperation mit Forschungspartnern an als andere Akteure. Mit 29,2 Prozent liegt ihr Kooperationsantei...",
"url": "https://www.iwkoeln.de/studien/enno-kohlisch-oliver-koppel-kooperationen-praegen-das-innovationsgeschehen-deutscher-hochschulen.html",
"image_url": "https://www.iwkoeln.de/typo3temp/assets/_processed_/a/f/csm_iw-gebaeude_e1bf71e276.jpg",
"language": "de",
"published_at": "2026-04-28T07:22:00.000000Z",
"source": "iwkoeln.de",
"categories": [
"business"
],
"relevance_score": null
},
{
"uuid": "2f381cb3-eb65-4881-bc3a-75d18c1c552b",
"title": "4499元起 联想来酷AI迷你主机开售 一键部署OpenClaw",
"description": "4499元起 联想来酷AI迷你主机开售 一键部署OpenClaw",
"keywords": ", 4499元起 联想来酷AI迷你主机开售 一键部署OpenClaw, 快科技",
"snippet": "4499元起 联想来酷AI迷你主机开售 一键部署OpenClaw\n\n快科技4月28日消息，联想来酷AI MINI高性能迷你主机正式开售，主打小巧...",
"url": "https://news.mydrivers.com/1/1118/1118861.htm",
"image_url": "https://img1.mydrivers.com/img/20260428/5ff40df0d9084cac963630fbe9bc6d9c.png",
"language": "zh",
"published_at": "2026-04-28T07:21:16.000000Z",
"source": "news.mydrivers.com",
"categories": [
"tech",
"general"
],
"relevance_score": null
},
{
"uuid": "ee2251f0-5d05-4385-93d5-1e10ff5e37fa",
"title": "비트코인, 12억 달러 폭탄에 좌절...\"8만 달러 넘기고 더 큰 폭락 올 수도\"",
"description": "비트코인(BTC)하락/AI생성이미지 비트코인(Bitcoin,BTC)이8만달러돌파를눈앞에두고또다시급락한배경에는뉴스가아닌파생...",
"keywords": "",
"snippet": "",
"url": "https://www.coinreaders.com/233171",
"image_url": "https://www.coinreaders.com/imgdata/coinreaders_com/202601/800_437_2026011915366186.jpg",
"language": "ko",
"published_at": "2026-04-28T07:20:00.000000Z",
"source": "coinreaders.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "c2279860-1b02-41a2-80bb-5867f89ac174",
"title": "ジェンダー平等推進を 航空連合、小林新会長",
"description": "航空業界の労働組合でつくる産業別労組「航空連合」は、昨年10月に就任した初の女性会長の下、今春闘でジェンダー?...",
"keywords": "西日本新聞me, 西日本新聞, ニュース, 九州, 福岡",
"snippet": "航空業界の労働組合でつくる産業別労組「航空連合」は、昨年10月に就任した初の女性会長の下、今春闘でジェンダー?...",
"url": "https://www.nishinippon.co.jp/item/1486679/",
"image_url": "https://www.nishinippon.co.jp/assets/nnp/img/base/og_image.png",
"language": "ja",
"published_at": "2026-04-28T07:19:11.000000Z",
"source": "nishinippon.co.jp",
"categories": [],
"relevance_score": null
},
{
"uuid": "0384d568-d73a-44dc-8483-3f1cfa5232c7",
"title": "O INDEFECTÍVEL",
"description": "",
"keywords": "",
"snippet": "",
"url": "http://oindefectivel.blogspot.com/feeds/4518574405798224583/comments/default",
"image_url": "",
"language": "pt",
"published_at": "2026-04-28T07:19:06.000000Z",
"source": "oindefectivel.blogspot.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "16f551a0-821f-427e-99d3-3c4cad0a985e",
"title": "O INDEFECTÍVEL",
"description": "",
"keywords": "",
"snippet": "",
"url": "http://oindefectivel.blogspot.com/feeds/6745718122153257902/comments/default",
"image_url": "",
"language": "pt",
"published_at": "2026-04-28T07:19:06.000000Z",
"source": "oindefectivel.blogspot.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "5bd84940-5ad7-43b9-af5d-6cefde270a59",
"title": "O INDEFECTÍVEL",
"description": "",
"keywords": "",
"snippet": "",
"url": "http://oindefectivel.blogspot.com/feeds/1127703218066502985/comments/default",
"image_url": "",
"language": "pt",
"published_at": "2026-04-28T07:19:06.000000Z",
"source": "oindefectivel.blogspot.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "17ab786b-f04d-4536-8523-2fcb68be9e85",
"title": "O INDEFECTÍVEL",
"description": "",
"keywords": "",
"snippet": "",
"url": "http://oindefectivel.blogspot.com/feeds/4521337289360295265/comments/default",
"image_url": "",
"language": "pt",
"published_at": "2026-04-28T07:19:06.000000Z",
"source": "oindefectivel.blogspot.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-04-28T07:23:50 |
2026-04-28T07:23 |
2026-04-28T07 |
2026-04-28 |
2026-04 |
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-04-28T07:23:50 |
2026-04-28T07:23 |
2026-04-28T07 |
2026-04-28 |
2026-04 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-04-28
|
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-04-21
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();