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-07-27
|
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": "7c04c086-c3b6-4477-a79f-2e91b1be452a",
"title": "Oil prices slide as U.S. and Iran pause strikes to give ‘space’ for diplomacy",
"description": "Oil prices tumbled on Monday as the United States and Iran paused their escalating strikes to make “space” for diplomacy.",
"keywords": "",
"snippet": "Oil prices tumbled on Monday as the United States and Iran paused their escalating strikes to make “space” for diplomacy.\n\nSubscribe to read this story ad-f...",
"url": "https://www.nbcnews.com/world/iran/oil-prices-slide-us-iran-pause-strikes-trump-diplomacy-hormuz-red-sea-rcna589383",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-07/260620-16x9-Strait-of-Hormuz-ch-1014-fea373-a3b521.jpg",
"language": "en",
"published_at": "2026-07-27T09:52:19.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "a2297d85-3a93-4b41-99f3-a620321602fe",
"title": "Live Updates: U.S.-Iran war appears to pause as Trump gives space for talks to end Strait of Hormuz standoff",
"description": "The U.S. and Iran hold fire amid work on a deal to reopen the Strait of Hormuz, but the Trump administration says a military buildup continues.",
"keywords": "War, Iran, Donald Trump, United States Military, Oman, Middle East, Strait of Hormuz",
"snippet": "2 days since latest U.S. strikes on Iran",
"url": "https://www.cbsnews.com/live-updates/us-iran-war-trump-strait-of-hormuz-talks-oman/",
"image_url": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/07/27/90729fd3-38e8-44d1-8f35-8a0c57af92eb/thumbnail/1200x630g2/b655c61e8836538bdde4789d42fc2925/iran-oman-2286944338.jpg",
"language": "en",
"published_at": "2026-07-27T10:34:55.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "40a54034-c9f9-4f81-995f-690bc68d251d",
"title": "U.S. pauses strikes on Iran amid apparent progress in talks",
"description": "The U.S. paused strikes on Iran after 13 straight days amid apparent progress in talks. Meanwhile, more than half of Americans said they feel uncertain and frustrated about the U.S-Iran conflict, a new CBS News poll shows. Kathryn Watson and Anthony Salvanto have more.",
"keywords": "Iran, Donald Trump, Trump Administration, Middle East",
"snippet": "U.S. pauses strikes on Iran amid apparent progress in talks The U.S. paused strikes on Iran after 13 straight days amid apparent progress in talks. Meanwhile, m...",
"url": "https://www.cbsnews.com/video/us-pauses-iran-strikes-amid-apparent-progress-talks/",
"image_url": "https://assets2.cbsnewsstatic.com/hub/i/r/2026/07/27/98a6acde-0188-4e7b-9222-164413a729b3/thumbnail/1200x630/79c77639ede80221270f3bde2ca68776/cbsn-fusion-us-pauses-iran-strikes-amid-apparent-progress-talks-thumbnail.jpg",
"language": "en",
"published_at": "2026-07-27T12:45:18.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "fe817e93-a76e-4931-aa8a-3ec498367774",
"title": "What's happening with the Strait of Hormuz as U.S. halts Iran strikes after apparent talks progress",
"description": "The U.S. paused its strikes on Iran after 13 days, while apparent progress is being made toward a deal between Oman and Iran, an official told CBS News. Courtney Kealy has more.",
"keywords": "Iran, Oman, Strait of Hormuz",
"snippet": "What's happening with the Strait of Hormuz as U.S. halts Iran strikes after apparent talks progress The U.S. paused its strikes on Iran after 13 days, while app...",
"url": "https://www.cbsnews.com/video/whats-happening-with-the-strait-of-hormuz-as-the-us-halts-iran-strikes-after-apparent-progress/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/07/27/6ab004f9-5a63-4dbf-9a69-ea71dcad3582/thumbnail/1200x630/a056f8ca78c473b81a4e6c3bbd3b8ff0/cbsn-fusion-whats-happening-with-the-strait-of-hormuz-as-the-us-halts-iran-strikes-after-apparent-progress-thumbnail.jpg",
"language": "en",
"published_at": "2026-07-27T13:13:04.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "c5cdca3d-7b5f-42b1-a695-b3910e4c6260",
"title": "Oil prices tumble as pause in U.S.-Iran fighting sparks market relief",
"description": "Stock futures rose and crude fell after U.S. Ambassador Mike Waltz told",
"keywords": "Stock Market, Oil and Gas",
"snippet": "Oil prices tumbled on Monday and the U.S. stock market surged amid a pause in fighting between the U.S. and Iran, with U.S. Ambassador to the United Nations Mik...",
"url": "https://www.cbsnews.com/news/oil-prices-tumble-us-iran-pause/",
"image_url": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/07/21/f88d493b-b61c-4a75-ad4d-045131471b9f/thumbnail/1200x630/89292ff9c301b1c7a164d2e784c03702/gettyimages-2276955761.jpg",
"language": "en",
"published_at": "2026-07-27T13:42:50.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "b02f58a3-911e-42b4-9232-261808756652",
"title": "U.S. and Iran Pause Strikes for Second Straight Day",
"description": "The U.S.and Iran paused their attacks for a second straight day Sunday as both sides reportedly look to return to the negotiating table for a binding resolution to ongoing warfare.",
"keywords": "",
"snippet": "The U.S. and Iran paused their attacks for a second straight day Sunday as both sides reportedly look to return to the negotiating table for a binding resolutio...",
"url": "https://www.breitbart.com/europe/2026/07/27/u-s-and-iran-pause-mutual-attacks-for-second-straight-day/",
"image_url": "https://media.breitbart.com/media/2026/07/gulf-hostilities-640x335.jpg",
"language": "en",
"published_at": "2026-07-27T11:36:23.000000Z",
"source": "breitbart.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
},
{
"uuid": "708a84b8-f842-4ba8-8ee5-91b3767ccb79",
"title": "Three people killed in shooting at Seattle food festival",
"description": "Seattle Police say three people were killed and four others injured in a shooting during the Bite of Seattle food festival. One suspect is in custody and another is believed to still be at large, and the suspects may have been shooting at each other, according to police.",
"keywords": "",
"snippet": "Seattle Police say three people were killed and four others injured in a shooting during the Bite of Seattle food festival. One suspect is in custody and anothe...",
"url": "https://www.nbcnews.com/video/three-people-killed-in-shooting-at-seattle-food-festival-267296837775",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/mpx/2704722219/2026_07/1785132512120_nbc_spec_seattle_presser_update_late_260726_S3_1920x1080-wiuqtl.jpg",
"language": "en",
"published_at": "2026-07-27T06:08:39.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "07a2c37c-7769-406c-8fe4-1dcfd976a247",
"title": "TikTokker voiced concerns about Seattle Center food festival security day before mass shooting that left 3 dead",
"description": "A Washington content creator appeared to be surprised by the apparent lack of security at the \"Bite of Seattle\" food festival – just one day before at least three people died in a mass shooting.",
"keywords": "US News, mass shootings, seattle",
"snippet": "See more of our coverage in your search results.\n\nA Washington-based content creator appeared to be surprised by the apparent lack of security at the “Bite of...",
"url": "https://nypost.com/2026/07/27/us-news/tiktokker-voiced-concerns-about-seattle-center-food-festival-security-day-before-mass-shooting-that-left-3-dead/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/07/135642483.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-07-27T09:20:57.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "b5595cbf-f7fc-42fc-80cb-23b68164dc12",
"title": "Police search for second suspect following Seattle food festival shooting that killed 3",
"description": "Police are searching for a second suspect after gunfire erupted at a crowded food festival beneath Seattle’s Space Needle.",
"keywords": "Seattle, Tyrone Davis, Shootings, Fairs and festivals, General news, Crime, Gun violence, AP Top News, WA State Wire, Washington, Faith Adia Hunter, U.S. news, Roberto Ramirez",
"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/seattle-center-shooting-food-festival-space-needle-90548c65364e742a97fb7cb0fea31209",
"image_url": "https://dims.apnews.com/dims4/default/b83c496/2147483647/strip/true/crop/2900x1932+0+0/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fd8%2Feb%2F4375473de0c41d4458ab2bf26009%2Fbad19cd301a4436baaf867dca83d77bd",
"language": "en",
"published_at": "2026-07-27T10:53:02.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "605c910f-7c26-4277-aa21-fe3ef18a751d",
"title": "Three Dead Following Shootout at Seattle Food Festival",
"description": "Three people are dead following a shootout Sunday evening between at least two people at the Bite of Seattle food festival.",
"keywords": "",
"snippet": "Three people are dead and four others injured following a shootout Sunday evening between at least two people at the Bite of Seattle food festival.\n\nKING5 repor...",
"url": "https://www.breitbart.com/2nd-amendment/2026/07/27/three-dead-following-shootout-at-seattle-food-festival/",
"image_url": "https://media.breitbart.com/media/2026/07/seattle-shooting-640x335.jpg",
"language": "en",
"published_at": "2026-07-27T09:27:25.000000Z",
"source": "breitbart.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "27f39031-135c-43d5-af5c-2d9d86f5b560",
"title": "Shooting at Seattle Food Festival Leaves at Least 3 Dead",
"description": "At least three people were killed and four others were injured when a gunman opened fire at a popular food festival near the Space Needle in Seattle Sunday night. One suspect is in custody another is being sought after fleeing the scene. NBC’s Liz Kreutz reports for TODAY.",
"keywords": "",
"snippet": "\n\nCopied\n\nAt least three people were killed and four others were injured when a gunman opened fire at a popular food festival near the Space Needle in Seattle S...",
"url": "https://www.today.com/video/shooting-at-seattle-food-festival-leaves-at-least-3-dead-267304005825",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_social_share_1200x630_center,f_auto,q_auto:best/mpx/2704722219/2026_07/1785150377711_tdy_news_7a_kreutz_seattle_shooting_260727_S3_1920x1080-i51gl9.jpg",
"language": "en",
"published_at": "2026-07-27T11:06:23.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "ec50669a-ed0e-4b60-b733-f821bea62803",
"title": "Eye Opener: Shooting at Seattle food festival kills 3",
"description": "One suspect is in custody, police say, and another is on the run after a deadly shooting at a food festival in Seattle. Plus, President Trump pauses strikes on Iran. All that and all that matters in today's Eye Opener.",
"keywords": "Seattle, Gun Violence",
"snippet": "Eye Opener: Shooting at Seattle food festival kills 3 One suspect is in custody, police say, and another is on the run after a deadly shooting at a food festiva...",
"url": "https://www.cbsnews.com/video/eye-opener-shooting-at-seattle-food-festival-kills-3/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/07/27/703db4a2-a44a-4a1a-841e-2843ff8967cf/thumbnail/1200x630/110b3d165476dc213cbec97e4bb2bc7d/cbsn-fusion-eye-opener-shooting-at-seattle-food-festival-kills-3-thumbnail.jpg",
"language": "en",
"published_at": "2026-07-27T12:27:53.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-07-27T17:24:47 |
2026-07-27T17:24 |
2026-07-27T17 |
2026-07-27 |
2026-07 |
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-07-27T17:24:47 |
2026-07-27T17:24 |
2026-07-27T17 |
2026-07-27 |
2026-07 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-07-27
|
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": 1673133,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "b82e2446-cf43-4af0-8983-d2f0fc142061",
"title": "How Charlie Kirk Went From Martyr to Meme",
"description": "From the aftermath, Candace Owens has somehow been reborn.",
"keywords": "right-wing-journalism, turning-point, internet-culture",
"snippet": "In the immediate aftermath of Charlie Kirk’s murder, the NFL was holding moments of silence, Ezra Klein was waxing about how he was ‘practicing politics the...",
"url": "https://slate.com/podcasts/what-next/2026/07/charlie-kirks-murder-memes-and-conspiracies-not-a-political-shift?via=rss",
"image_url": "https://compote.slate.com/images/1b91a5d9-7712-4849-8fea-b7dccd2e3456.jpeg?crop=4500%2C3000%2Cx0%2Cy0&width=1560",
"language": "en",
"published_at": "2026-07-27T17:15:34.000000Z",
"source": "slate.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "a2e1ae0c-4d6a-43b3-85f2-7f17c3d2312f",
"title": "John Wells Re-Ups Big Overall Deal To Stay At Warner Bros. Television",
"description": "Emmy-winning 'The Pitt' producer John Wells has signed a new three-year overall deal extension with Warner Bros. Television.",
"keywords": "",
"snippet": "EXCLUSIVE: As he marks his 40th anniversary at Warner Bros. Television this year, Emmy-winning TV producer John Wells has signed a new overall deal extension wi...",
"url": "https://deadline.com/2026/07/john-wells-reups-overall-deal-warner-bros-television-1237003303/",
"image_url": "https://deadline.com/wp-content/uploads/2026/07/The-Pitt-and-John-Wells.jpg?w=1024",
"language": "en",
"published_at": "2026-07-27T17:00:23.000000Z",
"source": "deadline.com",
"categories": [
"entertainment"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "481ad10c-a0c8-4066-a191-ed4642ff3bc1",
"title": "Trump demands Thune keep Senate in session until SAVE America Act passes",
"description": "Donald Trump demands John Thune not let the Senate leave for recess until the SAVE America Act passes, calling to terminate the filibuster for Republicans.",
"keywords": "politics, donald trump, john thune, senate elections, congress",
"snippet": "NEW You can now listen to Fox News articles!\n\nPresident Donald Trump doesn’t want the Senate to leave town with his flagship election security measure still o...",
"url": "https://www.foxnews.com/politics/trump-demands-thune-keep-senate-session-until-save-america-act-passes",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/12/john-thune-donald-trump-senate.jpg",
"language": "en",
"published_at": "2026-07-27T16:58:08.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "23d1c64c-53dc-4940-a3c0-289087412494",
"title": "FIFA president's leaked letter to Argentina following World Cup Final brawl comes across as tone deaf",
"description": "FIFA president Gianni Infantino reportedly praised Argentina's 'professionalism' in a leaked letter despite an ongoing investigation into brawls after the World...",
"keywords": "outkick sports, the world cup, soccer",
"snippet": "The 2026 World Cup was a smashing success, but that doesn't mean certain aspects of the event should be off limits to criticism, and that's especially true when...",
"url": "https://www.foxnews.com/outkick-sports/fifa-presidents-leaked-letter-argentina-following-world-cup-final-brawl-comes-across-tone-deaf",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/07/fifa-letter-featured-image.jpg",
"language": "en",
"published_at": "2026-07-27T16:57:42.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "32b74996-252f-4506-b14b-0caa6a755a6b",
"title": "OpenAI’s biggest threat may just be open AI",
"description": "Chinese labs like Moonshot are forcing OpenAI, Google, and Anthropic to rethink what they lock away.",
"keywords": "",
"snippet": "Silicon Valley has spent much of the past week on red alert, digesting the arrival of Moonshot AI’s Kimi K3, a Chinese AI model that can allegedly beat some o...",
"url": "https://www.theverge.com/ai-artificial-intelligence/971444/how-chinese-open-weight-ai-models-impact-us-companies",
"image_url": "https://platform.theverge.com/wp-content/uploads/sites/2/2026/07/gettyimages-2286280160.jpg?quality=90&strip=all&crop=0%2C10.83178126478%2C100%2C78.336437470441&w=1200",
"language": "en",
"published_at": "2026-07-27T16:56:13.000000Z",
"source": "theverge.com",
"categories": [
"tech"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "f42a5acf-3968-4ab7-96c1-31d9337a8694",
"title": "U.S. death toll rises as Iran war intensifies",
"description": "America is in an increasingly unpopular conflict with no clear strategy or end in sight.",
"keywords": "",
"snippet": "What happened\n\nLawmakers in Washington recently demanded that the Trump administration outline its strategy in Iran, as a war that President Trump had vowed wou...",
"url": "https://theweek.com/world-news/us-death-toll-rises-iran-war",
"image_url": "https://cdn.mos.cms.futurecdn.net/LoLUfBV4CYCixewH2nHEXG-2000-80.jpg",
"language": "en",
"published_at": "2026-07-27T16:54:43.000000Z",
"source": "theweek.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "e955daac-5558-4675-901c-eaf152d2fc6f",
"title": "GIANNO CALDWELL: We marched for every family blue city politicians left behind",
"description": "Chicago gun violence march drew community support as Gov. JB Pritzker and Mayor Brandon Johnson ignored repeated invitations to stand with families of murder vi...",
"keywords": "opinion, chicago, chicagos crime wave, blue city crime, jb pritzker",
"snippet": "NEW You can now listen to Fox News articles!\n\nThis weekend I marched through the streets of Chicago, a few blocks from where my innocent teenage brother Christi...",
"url": "https://www.foxnews.com/opinion/gianno-caldwell-marched-every-family-blue-city-politicians-left-behind",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/07/fox_gianno-caldwell-holding-sign.jpg",
"language": "en",
"published_at": "2026-07-27T16:53:34.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "879be3fc-1406-4aa4-960a-1181ae51383c",
"title": "More disturbing details emerge on suspect in Berlin Pride attack",
"description": "More information is emerging about the timeline of the deadly Berlin Pride car ramming attack and about the suspect. CBS News' Anna Noryskiewicz has the latest.",
"keywords": "Pride, Germany, Crime",
"snippet": "More disturbing details emerge on suspect in Berlin Pride attack More information is emerging about the timeline of the deadly Berlin Pride car ramming attack a...",
"url": "https://www.cbsnews.com/video/more-details-emerge-on-suspect-in-berlin-pride-attack/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/07/27/a56f4fb0-ed8e-4fff-b259-6457f9391972/thumbnail/1200x630/aafafd4d8683bc8ccd28d7830a994f69/cbsn-fusion-more-details-emerge-on-suspect-in-berlin-pride-attack-thumbnail.jpg",
"language": "en",
"published_at": "2026-07-27T16:52:15.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "0a31c253-8dbd-45ba-93be-7eea9a4c1240",
"title": "Police search for second suspect in Seattle food festival shooting",
"description": "Seattle police are searching for a second suspect in the deadly shooting at a food festival near the Space Needle. CBS News' Anna Schecter has the latest.",
"keywords": "Seattle, Gun Violence, Mass Shooting, Crime",
"snippet": "Police search for second suspect in Seattle food festival shooting Seattle police are searching for a second suspect in the deadly shooting at a food festival n...",
"url": "https://www.cbsnews.com/video/police-search-for-second-suspect-in-seattle-food-festival-shooting/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/07/27/d2e624dc-ed45-47c8-abf9-21489358a255/thumbnail/1200x630/e6384e2bb28fe1340f73510a718efb31/cbsn-fusion-police-search-for-second-suspect-in-seattle-food-festival-shooting-thumbnail.jpg",
"language": "en",
"published_at": "2026-07-27T16:51:14.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "c645bbd5-66e1-4943-984f-f1a9d73e2e8e",
"title": "Hear haunting 911 call describing ‘woman screaming’ in influencer Sara Gilson’s murder-suicide",
"description": "Chilling 911 dispatcher audio captures the moment cops reported hearing a \"woman screaming and crying,\" minutes before they found the bodies of an influencer an...",
"keywords": "US News, Influencers, murder suicide, oklahoma, pedophiles",
"snippet": "See more of our coverage in your search results.\n\nChilling 911 audio captures a dispatcher describing a “woman screaming and crying” moments before influenc...",
"url": "https://nypost.com/2026/07/27/us-news/chilling-911-audio-from-influencer-sara-gilsons-murder-suicide/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/07/comp-15-2.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-07-27T16:51:11.000000Z",
"source": "nypost.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-07-27T17:24:47 |
2026-07-27T17:24 |
2026-07-27T17 |
2026-07-27 |
2026-07 |
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-07-27T17:24:47 |
2026-07-27T17:24 |
2026-07-27T17 |
2026-07-27 |
2026-07 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-07-27
|
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": 54289176,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "236ce6c3-1a6b-4d29-8c78-8035a8df53f7",
"title": "iM라이프, 상반기 순이익 182억원…전년比 44억↑",
"description": "컨슈머타임스=김예령 기자 | iM라이프가 가치 중심 영업 전략에 힘입어 올해 상반기 당기순이익 182억원을 기록했다.27일 i...",
"keywords": "",
"snippet": "컨슈머타임스=김예령 기자 | iM라이프가 가치 중심 영업 전략에 힘입어 올해 상반기 당기순이익 182억원을 기록했다.\n\n27일...",
"url": "https://www.cstimes.com/news/articleView.html?idxno=714775",
"image_url": "https://www.cstimes.com/news/photo/202607/714775_634967_2448.jpg",
"language": "ko",
"published_at": "2026-07-27T17:24:52.000000Z",
"source": "cstimes.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "8a14a796-9c28-4bca-a752-3014736afb18",
"title": "Israeli rock band Eifo Hayeled releases new album Ambulans Shirim",
"description": "Created over the past three years against the backdrop of the Gaza war, the album moves between personal reflection and national pain.",
"keywords": "music, Culture in Israel, Concert, Museum of Tolerance, music industry",
"snippet": "Nearly 40 years after its founding, the Israeli rock band Eifo Hayeled (Where’s the Child) has released its seventh studio album, titled Ambulans Shirim (Ambu...",
"url": "https://www.jpost.com/israel-news/culture/article-903816",
"image_url": "https://images.jpost.com/image/upload/f_auto,fl_lossy/q_auto/c_fill,g_faces:center,h_720,w_1280/731674",
"language": "en",
"published_at": "2026-07-27T17:23:32.000000Z",
"source": "jpost.com",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "9cc122f6-1c5f-4e2b-98a7-1444cfa38fe2",
"title": "에코프로에이치엔, 삼성E&A와 330억 규모 RCS 공급 계약",
"description": "[디지털투데이 석대건 기자] 에코프로에이치엔은 삼성E&A와 중앙식 온실가스 저감 시스템(RCS) 공급 계약을 체결했다고 27?...",
"keywords": "에코프로에이치엔",
"snippet": "에코프로에이치엔 전경 [사진: 에코프로]\n\n[디지털투데이 석대건 기자] 에코프로에이치엔은 삼성E&A와 중앙식 온실가스 ?...",
"url": "https://www.digitaltoday.co.kr/news/articleView.html?idxno=687374",
"image_url": "https://cdn.digitaltoday.co.kr/news/photo/202607/687374_635510_1037.jpg",
"language": "ko",
"published_at": "2026-07-27T17:23:27.000000Z",
"source": "digitaltoday.co.kr",
"categories": [
"tech",
"general"
],
"relevance_score": null
},
{
"uuid": "a50589a8-9073-4458-a386-1b5c400d132c",
"title": "우리나라에는 빅브라더가 있군요. : 클리앙",
"description": "조지오웰의 소설에 나오는 빅브라더가 우리나라에는 이미 있다고 합니다. 그 소설에서 빅브라더는 텔레스크린이라는 장...",
"keywords": "",
"snippet": "조지오웰의 소설에 나오는 빅브라더가 우리나라에는 이미 있다고 합니다.\n\n그 소설에서 빅브라더는 텔레스크린이라는 ?...",
"url": "https://www.clien.net/service/board/park/19235749",
"image_url": "https://www.clien.net/service/image/favicon.ico",
"language": "ko",
"published_at": "2026-07-27T17:23:23.000000Z",
"source": "clien.net",
"categories": [
"tech"
],
"relevance_score": null
},
{
"uuid": "e9501f0a-69ff-4289-9f55-4fdfe3518473",
"title": "하나증권, 450억원 규모 중간배당 결정…전액 하나금융지주 귀속",
"description": "하나증권이 보통주 1주당 559.48원, 총 450억원 규모의 중간배당을 실시한다.27일 업계에 따르면 하나증권은 지난 23일 이사?...",
"keywords": "",
"snippet": "하나증권\n\n[출처: 연합뉴스 자료 사진]\n\n(서울=연합인포맥스) 최정우 기자 = 하나증권이 보통주 1주당 559.48원, 총 450억원 ?...",
"url": "https://news.einfomax.co.kr/news/articleView.html?idxno=4427092",
"image_url": "https://cdn.news.einfomax.co.kr/news/thumbnail/202607/4427092_332420_242_v150.jpg",
"language": "ko",
"published_at": "2026-07-27T17:23:21.000000Z",
"source": "t240.ndsoftnews.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "257d55df-e854-4c31-b3e0-2672327d1a58",
"title": "Canada's Fontaine, Carroll, Dolci win gymnastics gold medals at Commonwealth Games",
"description": "",
"keywords": "",
"snippet": "Lia-Monica Fontaine, Jordan Carroll and Félix Dolci captured gold as Canadian gymnasts racked up six medals at the Commonwealth Games on Monday.\n\nFontaine scor...",
"url": "https://www.sportsnet.ca/olympics/article/canadas-fontaine-carroll-dolci-win-gymnastics-gold-medals-at-commonwealth-games/",
"image_url": "https://www.sportsnet.ca/wp-content/uploads/2026/07/Untitled-design-87.jpg",
"language": "en",
"published_at": "2026-07-27T17:23:15.000000Z",
"source": "sportsnet.ca",
"categories": [
"sports"
],
"relevance_score": null
},
{
"uuid": "ba557af4-c2fa-404c-8966-7d52d62d09c5",
"title": "한화플러스제5호기업인수목적, SPAC 합병 예비심사 청구로 주권 매매거래 정지",
"description": "[디지털투데이 AI공시팀] 한국거래소는 한화플러스제5호기업인수목적(498390)의 주권 매매거래가 정지됐다고 27일 공시했?...",
"keywords": "한화플러스제5호스팩, 금융 지원 서비스업, 주권매매거래정지(SPAC합병(예비심사청구대상)), 투자판단·경영, AI공시",
"snippet": "[디지털투데이 AI공시팀] 한국거래소는 한화플러스제5호기업인수목적(498390)의 주권 매매거래가 정지됐다고 27일 공시했?...",
"url": "https://www.digitaltoday.co.kr/news/articleView.html?idxno=687390",
"image_url": "https://cdn.digitaltoday.co.kr/news/photo/202607/687390_635518_2525.jpg",
"language": "ko",
"published_at": "2026-07-27T17:23:07.000000Z",
"source": "digitaltoday.co.kr",
"categories": [
"tech",
"general"
],
"relevance_score": null
},
{
"uuid": "81ea8300-e274-4246-944a-8ea755920888",
"title": "한울앤제주, 제11회차 신주인수권 행사…8만2202주 신규 발행",
"description": "[디지털투데이 AI공시팀] 수제맥주 업체 한울앤제주(276730)가 제11회차 신주인수권부사채에 대한 신주인수권을 행사해 총 ...",
"keywords": "한울앤제주, 알코올음료 제조업, 코스닥, 신주인수권행사(제11회차), 부채·채권, AI공시",
"snippet": "[디지털투데이 AI공시팀] 수제맥주 업체 한울앤제주(276730)가 제11회차 신주인수권부사채에 대한 신주인수권을 행사해 총 ...",
"url": "https://www.digitaltoday.co.kr/news/articleView.html?idxno=687389",
"image_url": "https://cdn.digitaltoday.co.kr/news/photo/202607/687389_635517_2523.jpg",
"language": "ko",
"published_at": "2026-07-27T17:23:06.000000Z",
"source": "digitaltoday.co.kr",
"categories": [
"tech",
"general"
],
"relevance_score": null
},
{
"uuid": "58c22184-7c15-4bcd-a86f-c5b2690a121c",
"title": "아이에스동서, 대구 남산4-7구역 재개발 시공사 선정",
"description": "[디지털투데이 김지선 에디터] 콘크리트 제품 제조 기업 아이에스동서(010780)가 남산4-7구역 주택재개발정비사업의 시공?...",
"keywords": "아이에스동서, 시멘트 석회 플라스터 및 그 제품 제조업, 코스피, 투자판단관련주요경영사항, 투자판단·경영, AI공시",
"snippet": "[디지털투데이 김지선 에디터] 콘크리트 제품 제조 기업 아이에스동서(010780)가 남산4-7구역 주택재개발정비사업의 시공?...",
"url": "https://www.digitaltoday.co.kr/news/articleView.html?idxno=687388",
"image_url": "https://cdn.digitaltoday.co.kr/news/photo/202607/687388_635516_2520.jpg",
"language": "ko",
"published_at": "2026-07-27T17:23:05.000000Z",
"source": "digitaltoday.co.kr",
"categories": [
"tech",
"general"
],
"relevance_score": null
},
{
"uuid": "fc31c336-482f-4a8e-8b8e-0c731dc5ce89",
"title": "넥슨, 대학생 게임잼 '재밌넥' 성료 - 경향게임스",
"description": "넥슨이 AI를 활용한 게임 개발을 주제로 한 대학생 게임잼 '2026 넥슨 대학생 게임잼 재밌넥'을 마무리했다. 넥슨은 지난 24...",
"keywords": "",
"snippet": "넥슨이 AI를 활용한 게임 개발을 주제로 한 대학생 게임잼 '2026 넥슨 대학생 게임잼 재밌넥'을 마무리했다.\n\n\n\n제공=넥슨\n\n?...",
"url": "https://www.khgames.co.kr/news/articleView.html?idxno=306728",
"image_url": "https://cdn.khgames.co.kr/news/photo/202607/306728_312168_2253.jpg",
"language": "ko",
"published_at": "2026-07-27T17:23:04.000000Z",
"source": "khgames.co.kr",
"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-07-27T17:24:47 |
2026-07-27T17:24 |
2026-07-27T17 |
2026-07-27 |
2026-07 |
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-07-27T17:24:47 |
2026-07-27T17:24 |
2026-07-27T17 |
2026-07-27 |
2026-07 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-07-27
|
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-07-20
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();