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-03-14
|
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": "062f6ec2-b3aa-4ecb-82a9-bb494ce84047",
"title": "Trump vows to hit Iran 'very hard' after obliterating nearly '90 percent' of regime missiles",
"description": "President Trump says 90% of Iranian missiles destroyed in ongoing Iran war, signals more U.S. strikes as Strait of Hormuz tensions push oil prices higher.",
"keywords": "",
"snippet": "NEW You can now listen to Fox News articles!\n\nPresident Donald Trump revealed more plans for the war with Iran, vowing to continue \"decimating\" the regime over ...",
"url": "https://www.foxnews.com/media/trump-vows-hit-iran-very-hard-after-obliterating-nearly-90-percent-regime-missiles",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/03/trump-iran-strikes-fox-news.jpg",
"language": "en",
"published_at": "2026-03-13T16:53:54.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "a1ab68f1-9978-414c-9f72-17eb63e9daff",
"title": "A 'little excursion' or 'war'? It's 'both,' Trump says: ANALYSIS",
"description": "Amid rising gas prices and uncertainly at home about the cost and duration of the war with Iran, Trump is telling Americans this is only a short-term mission.",
"keywords": "Article, 131003550",
"snippet": "He says, \"we've won\" but also, \"we gotta finish the job.\"\n\nA 'little excursion' or 'war'? It's 'both,' Trump says: ANALYSIS\n\nPresident Donald Trump speaks to jo...",
"url": "https://abcnews.com/Politics/excursion-war-trump-analysis/story?id=131003550",
"image_url": "https://i.abcnewsfe.com/a/35829a36-267e-44ae-a506-5fbc9eaa6cbb/donald-trump-1-gty-gmh-260312_1773327198440_hpMain_16x9.jpg?w=1600",
"language": "en",
"published_at": "2026-03-13T17:43:30.000000Z",
"source": "abcnews.go.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "ff2ca5af-3cfa-418b-bd22-1d989516e804",
"title": "Trump Says Iran War Will Be Over “When I Feel It in My Bones”",
"description": "Donald Trump claimed the U.S. had enough ammunition to keep the war going “forever.”",
"keywords": "",
"snippet": "Brynn Tannehill, a former Iran analyst for the U.S. Naval Reserve, emphasized in The Atlantic that the U.S. and its Gulf allies were chewing through “scarce a...",
"url": "https://newrepublic.com/post/207763/donald-trump-iran-war-over-feel-bones",
"image_url": "https://images.newrepublic.com/ae2bca0a8119fa11678175689eeb8faf06992caf.jpeg?w=1200&h=630&crop=faces&fit=crop&fm=jpg",
"language": "en",
"published_at": "2026-03-13T18:33:05.000000Z",
"source": "newrepublic.com",
"categories": [
"general",
"politics",
"entertainment"
],
"locale": "us"
},
{
"uuid": "fc0a5622-d4b1-474d-a044-4b0b0a2ebe23",
"title": "Approximately 5,000 U.S. sailors & marines deploying to Mideast to support war in Iran",
"description": "The Trump administration downplays concerns about Iran blocking the Strait of Hormuz with gas and oil prices rising and as 5,000 U.S. service members are being deployed to the region. NBC News correspondents Monica Alba, Courtney Kube, Andrea Mitchell and Keir Simmons report on the state of the war.",
"keywords": "",
"snippet": "The Trump administration downplays concerns about Iran blocking the Strait of Hormuz with gas and oil prices rising and as 5,000 U.S. service members are being ...",
"url": "https://www.nbcnews.com/meet-the-press/video/approximately-5-000-u-s-sailors-marines-deploying-to-mideast-to-support-war-in-iran-259278405944",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/mpx/2704722219/2026_03/1773433446799_now_mtp_clip_ablock_260313_1920x1080-hah6ep.jpg",
"language": "en",
"published_at": "2026-03-13T20:24:23.000000Z",
"source": "nbcnews.com",
"categories": [
"politics",
"general"
],
"locale": "us"
},
{
"uuid": "303248e5-1153-4375-85cc-d435c7392067",
"title": "Fewer missiles, drones pierce Israeli air defenses as Iran war persists",
"description": "A total of 13 U.S. service members have been killed in the joint Israeli war with Iran, including the six who died in a plane crash in Iraq. Meanwhile, pro-government protesters took to the streets in Iran despite waves of airstrikes. CBS News chief correspondent Matt Gutman reports on the war's latest and Sumantra Maitra, founder of CLIO strategic consulting, has more.",
"keywords": "Iran, Israel, Donald Trump, Ayatollah Mojtaba Khamenei, Trump Administration, Middle East",
"snippet": "Fewer missiles, drones pierce Israeli air defenses as Iran war persists A total of 13 U.S. service members have been killed in the joint Israeli war with Iran, ...",
"url": "https://www.cbsnews.com/video/fewer-missiles-drones-pierce-israeli-air-defenses-iran-war/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/03/13/cfa52c8b-d75c-4c5b-910d-0f32f7d30203/thumbnail/1200x630/78607011a079d4f08218ac1b72fb82ac/cbsn-fusion-fewer-missiles-drones-pierce-israeli-air-defenses-amid-war-iran-thumbnail.jpg",
"language": "en",
"published_at": "2026-03-13T21:38:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "f87d4468-889a-49ca-8b65-7705ee3dd073",
"title": "The Iran war's looming economic threat: Higher food prices",
"description": "The ongoing war in Iran is disrupting fertilizer shipments through the Strait of Hormuz, raising farmers' costs and pushing food prices higher.",
"keywords": "",
"snippet": "The ongoing war in Iran is driving up more than just the cost of oil. With essential crop fertilizers also caught in the crossfire, U.S. food prices could be ne...",
"url": "https://www.nbcnews.com/business/consumer/iran-war-fertilizer-prices-food-rcna263336",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-03/260313-supermarket-ch-1016-be1695.jpg",
"language": "en",
"published_at": "2026-03-13T22:10:11.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
},
{
"uuid": "fdcd6749-31f9-4153-9df9-91c5315a9f32",
"title": "Trump Orders Strikes on Kharg Island, a Vital Hub for Iran’s Oil",
"description": "However, Trump said that “for reasons of decency,” he chose “NOT to wipe out the Oil Infrastructure on the Island.”",
"keywords": "",
"snippet": "“Moments ago, at my direction, the United States Central Command executed one of the most powerful bombing raids in the History of the Middle East, and totall...",
"url": "https://foreignpolicy.com/2026/03/13/kharg-island-bombing-iran-oil-strike-trump-truth-social/",
"image_url": "https://foreignpolicy.com/wp-content/uploads/2026/03/Kharg.jpeg?w=1000",
"language": "en",
"published_at": "2026-03-14T00:48:51.000000Z",
"source": "foreignpolicy.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "87199fa4-1e5e-4831-9595-5ecf486a9b26",
"title": "Trump says US seizing Kharg Island ‘not high on the list’ of Iran war priorities",
"description": "President Trump has said that seizing Iran's Kharg Island fuel depot is not currently a priority — but he could quickly change his thinking.",
"keywords": "Politics, US News, donald trump, iran, Operation Epic Fury, trump",
"snippet": "President Trump has said that seizing Iran’s Kharg Island fuel depot is not currently a priority — but he could quickly change his thinking.\n\n“It’s not ...",
"url": "https://nypost.com/2026/03/13/us-news/trump-says-us-seizing-kharg-island-not-high-on-the-list-of-iran-war-priorities/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/03/Trump-Karg-island.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-03-13T17:09:48.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "f63c1e7e-57f5-4849-96d4-bc601b2867e0",
"title": "Trump says US ‘obliterated’ targets in strike on key Iranian oil hub",
"description": "Trump said the U.S. carried out a bombing raid on Iran’s Kharg Island, a strategically important Persian Gulf island and key oil export hub.",
"keywords": "",
"snippet": "NEW You can now listen to Fox News articles!\n\nPresident Donald Trump said Friday that the U.S. had carried out a bombing raid on Iran’s Kharg Island, a strate...",
"url": "https://www.foxnews.com/politics/trump-says-u-s-obliterated-targets-strike-key-iranian-oil-hub",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/12/trump-listens-press-conference.png",
"language": "en",
"published_at": "2026-03-14T00:14:31.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "3af0626b-4ae5-4284-b96d-c6da060ce7d9",
"title": "US obliterates ‘every MILITARY target’ on Iran’s Kharg Island in historic bombing raid, Trump says",
"description": "The island, located about 16 miles off the Iranian coast, is one-third the size of Manhattan and controls 90% of Iranian crude oil exports.",
"keywords": "US News, donald trump, iran, military, Operation Epic Fury",
"snippet": "Military targets on Iran’s Kharg Island – the loading site for most of the Islamic Republic’s oil exports – were “totally obliterated” by US airstri...",
"url": "https://nypost.com/2026/03/13/us-news/us-obliterates-every-military-target-on-irans-kharg-island-in-historic-bombing-raid-trump-says/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/03/trump-comp-2.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-03-13T23:18:36.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "09990438-0b9e-47d5-8453-13c1d080c5db",
"title": "Trump says U.S. forces have destroyed the military assets of Kharg Island",
"description": "In a Truth Social post, President Trump said that the U.S. forces",
"keywords": "",
"snippet": "In a Truth Social post, President Trump said that the U.S. forces \"obliterated\" Iranian military targets on Kharg Island. The president said the island's oil in...",
"url": "https://www.nbcnews.com/video/trump-says-u-s-forces-have-obliterated-the-military-assets-of-kharg-island-259293253709",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/mpx/2704722219/2026_03/1773447513831_now_topstory_trump_forces_kharg_island_260313_1920x1080-h2dkxw.jpg",
"language": "en",
"published_at": "2026-03-14T00:18:40.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "c2d95251-7dc4-4b32-b08c-54b5dc2916c3",
"title": "Trump administration directs Sable Offshore to restore Santa Ynez oil unit",
"description": "The move aims to restart oil production at a cluster of offshore platforms as fuel prices continue to rise in the wake of the war on Iran.",
"keywords": "Metro, US News, california, donald trump, iran, oil prices",
"snippet": "The Trump administration on Friday directed Sable Offshore (SOC.N), opens new tab to restore oil drilling operations off the southern California coast, the U...",
"url": "https://nypost.com/2026/03/13/us-news/president-donald-trump-orders-oil-drilling-in-california/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/03/123518693.gif?w=1200",
"language": "en",
"published_at": "2026-03-14T01:32:54.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"locale": "us"
}
]
}
],
"business": ...,
"sports": ...,
"tech": ...,
"science": ...,
"health": ...
}
}
Top Stories Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/top HTTP/1.1
Use this endpoint to find live and historical top stories around the world or filter to get only top stories for specific countries. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
locale |
false | Comma separated list of country codes to include in the result set. Default is all countries.
Click here for a list of supported countries.
Example: us,ca (US + Canada).
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-03-14T03:55:27 |
2026-03-14T03:55 |
2026-03-14T03 |
2026-03-14 |
2026-03 |
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-03-14T03:55:27 |
2026-03-14T03:55 |
2026-03-14T03 |
2026-03-14 |
2026-03 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-03-14
|
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": 1573285,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "6bceca15-6669-4554-a70e-24f658eb2259",
"title": "NJ-based shipping company slams Iran’s ‘barbaric attack’ on oil tanker that killed 1 crew member",
"description": "The crew of a US-owned oil tanker found themselves “fighting for their lives” earlier this week, after a “barbaric attack” by Iran left the ship engulfe...",
"keywords": "Politics, US News, donald trump, iran, military, new jersey, shipping, terrorism",
"snippet": "The crew of a US-owned oil tanker found themselves “fighting for their lives” earlier this week, after a “barbaric attack” by Iran left the ship engulfe...",
"url": "https://nypost.com/2026/03/13/us-news/nj-based-shipper-slams-barbaric-attack-on-tanker-vessel-by-extremist-iran-regime/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/03/newspress-collage-y01ryspcj-1773456571032.jpg?quality=75&strip=all&1773442194&w=1200",
"language": "en",
"published_at": "2026-03-14T03:22:02.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "34ab115d-a0d9-4ad7-a364-2648bae12409",
"title": "Kelly Osbourne Visits Ozzy Osbourne’s Final Resting Place",
"description": "Kelly Osbourne visited her late father Ozzy Osbourne’s final resting place in Buckinghamshire as she continues to grieve",
"keywords": "",
"snippet": "Kelly Osbourne is continuing to grieve for her late father Ozzy Osbourne.\n\nTaking to her Instagram Story on Friday, March 13, Kelly, 41, shared a glimpse of her...",
"url": "https://www.usmagazine.com/celebrity-news/news/kelly-osbourne-visits-ozzy-osbournes-final-resting-place/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/03/GettyImages-1202142538Kelly-Osbourne-Visits-Ozzy-Osbournes-Final-Resting-Place-After-His-Death.jpg?crop=659px%2C103px%2C1799px%2C946px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2026-03-14T03:16:00.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "503efc35-4c16-4fda-b12a-9c4e02aea5ae",
"title": "2026 Players Championship: Looking ahead to the weekend",
"description": "We're halfway through the Players Championship with Ludvig Aberg holding the lead. Here's what we're watching for the rest of the way.",
"keywords": "",
"snippet": "Rory McIlroy speaks after ending round one seven shots off the pace at the Players Championship. (0:53)\n\nOpen Extended Reactions\n\nPONTE VEDRA, Fla. -- Through t...",
"url": "https://www.espn.com/golf/story/_/id/48198376/2026-players-championship-looking-ahead-weekend-tpc-sawgrass",
"image_url": "https://a2.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0313%2Fr1627991_1296x729_16%2D9.jpg",
"language": "en",
"published_at": "2026-03-14T03:05:44.000000Z",
"source": "espn.com",
"categories": [
"sports",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "2c73094a-ea1c-493b-8f7e-b1a99f56566e",
"title": "Vincent’s Clam Bar helping fuel New York’s March Madness-bound teams",
"description": "March Madness-bound St. John’s, Hofstra and Long Island University have a secret weapon behind their banner seasons — cooking from Vincent’s Clam Bar.",
"keywords": "College Basketball, Sports, Long Island, hofstra pride, hofstra university, nassau county, rick pitino, St. John's Red Storm",
"snippet": "It’s their lucky parm!\n\nMarch Madness-bound St. John’s, Hofstra and Long Island University have a secret weapon behind their banner seasons — home cookin?...",
"url": "https://nypost.com/2026/03/13/sports/vincents-clam-bar-helping-fuel-new-yorks-march-madness-bound-teams/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/03/newspress-collage-gcpihwozk-1773455589639.jpg?quality=75&strip=all&1773441223&w=1200",
"language": "en",
"published_at": "2026-03-14T03:05:13.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "d97bbe49-7eb7-4a2c-b8ce-a65dad9a9957",
"title": "WNBPA's Jackson hopeful as sides 'chip away' in CBA negotiations",
"description": "WNBPA chief Terri Carmichael Jackson expressed optimism on Day 4 of CBA negotiations with the league, saying that continued conversations have helped \"chip away...",
"keywords": "",
"snippet": "Open Extended Reactions\n\nNEW YORK -- Women's National Basketball Players Association executive director Terri Carmichael Jackson said Friday that \"movement is s...",
"url": "https://www.espn.com/wnba/story/_/id/48200292/wnbpa-jackson-hopeful-sides-chip-away-cba-negotiations",
"image_url": "https://a2.espncdn.com/combiner/i?img=%2Fphoto%2F2025%2F1119%2Fr1577498_1296x729_16%2D9.jpg",
"language": "en",
"published_at": "2026-03-14T02:51:09.000000Z",
"source": "espn.com",
"categories": [
"sports",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "75cf86ec-ad9d-4ec1-b309-e7c5bbb1889b",
"title": "DOJ drops case against veteran arrested after burning American flag near White House",
"description": "Prosecutors sought to drop the charges against Jan Carey after a judge said he was entitled to further inquiry into whether the administration was vindictively ...",
"keywords": "",
"snippet": "The Justice Department on Friday moved to dismiss charges against a veteran who set an American flag on fire across the street from the White House following an...",
"url": "https://www.nbcnews.com/politics/justice-department/drops-case-veteran-carey-arrested-burning-american-flag-white-house-rcna263438",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-03/260313-jay-carey-ww-2035-d6c260.jpg",
"language": "en",
"published_at": "2026-03-14T02:48:33.000000Z",
"source": "nbcnews.com",
"categories": [
"politics",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "b2f872b8-40b9-44fc-962f-9c00fa671d40",
"title": "'Virgin River's Marco Grazzini On Leaving Netflix Series:",
"description": "Marco Grazzini is leaving Virgin River after six seasons to enter a \"new chapter\" in his career.",
"keywords": "",
"snippet": "Marco Grazzini is leaving Virgin River after six seasons to enter a “new chapter” in his career.\n\nThe actor, who plays Mike Valenzuela, is departing the Net...",
"url": "https://deadline.com/2026/03/virgin-river-marco-grazzini-leaving-netflix-series-1236753459/",
"image_url": "https://deadline.com/wp-content/uploads/2026/03/marco-grazzini-virgin-river-netflix.jpg?w=1024",
"language": "en",
"published_at": "2026-03-14T02:40:51.000000Z",
"source": "deadline.com",
"categories": [
"entertainment"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "3f701382-7ea3-4381-9369-be956ad78ebe",
"title": "Fail: Old Dominion University Is a Gun-Free Campus",
"description": "Old Dominion University has a gun-free campus that did not prevent an attacker from opening fire on ROTC students with a handgun Thursday.",
"keywords": "",
"snippet": "Old Dominion University has a gun-free policy for its campus that did not prevent a determined attacker from opening fire on ROTC students with a handgun Thursd...",
"url": "https://www.breitbart.com/2nd-amendment/2026/03/13/fail-old-dominion-university-is-a-gun-free-campus/",
"image_url": "https://media.breitbart.com/media/2026/03/Old-Dominion-University-No-Guns-Allowed-640x335.jpeg",
"language": "en",
"published_at": "2026-03-14T02:24:18.000000Z",
"source": "breitbart.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "11d9af26-26d8-424b-a87a-d4af8e000b26",
"title": "Doja Cat Shares \"Agonizing\" Struggles With Borderline Personality Disorder",
"description": "Doja Cat shared she's",
"keywords": "",
"snippet": "Watch : Doja Cat Shares Her Lipedema Concerns After Liposuction\n\nDoja Cat is getting real about her mental health.\n\nThe \"Paint the Town\" rapper shared she's \"no...",
"url": "https://www.eonline.com/news/1429722/doja-cat-on-borderline-personality-disorder-diagnosis-mental-health?cmpid=rss-syndicate-genericrss-us-top_stories",
"image_url": "https://akns-images.eonline.com/eol_images/Entire_Site/20260313/ec568ab9-8dca-465e-a6b5-9d94f9a57a52_1773450632.jpg?fit=around%7C1080:1080&output-quality=90&crop=1080:1080;center,top",
"language": "en",
"published_at": "2026-03-14T02:17:46.000000Z",
"source": "eonline.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "c1e76a50-40c8-4253-a901-f229de4614a2",
"title": "Trump Says US 'Obliterated' Military Targets On Iran's Kharg Island, Threatens Tougher Action If Hormuz Shipping Is Disrupted",
"description": "President Trump announced a U.S. bombing raid on Iran's Kharg Island, the country's main crude oil export terminal, warning that any threats to shipping through...",
"keywords": "",
"snippet": "President Donald Trump announced on Friday that U.S. Central Command carried out a major bombing raid on Iran's main crude oil export terminal, Kharg Island, an...",
"url": "https://www.benzinga.com/news/politics/26/03/51256496/trump-says-us-obliterated-military-targets-on-irans-kharg-island-threatens-tougher-action-if-hormuz",
"image_url": "https://cdn.benzinga.com/files/images/story/2026/03/13/Us-iran-Geopolitics-Oil-Industry--Energy.jpeg?width=1200&height=800&fit=crop",
"language": "en",
"published_at": "2026-03-14T02:16:24.000000Z",
"source": "benzinga.com",
"categories": [
"business"
],
"relevance_score": null,
"locale": "us"
}
]
}
All News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/all HTTP/1.1
Use this endpoint to find all live and historical articles we collect. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-03-14T03:55:27 |
2026-03-14T03:55 |
2026-03-14T03 |
2026-03-14 |
2026-03 |
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-03-14T03:55:27 |
2026-03-14T03:55 |
2026-03-14T03 |
2026-03-14 |
2026-03 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-03-14
|
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": 54510290,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "41a7fc02-07aa-4e2c-af3b-284b068f67c3",
"title": "Cardano Midnight Sees Surge in Active Users, Trading Price Up 10%",
"description": "Cardano(ADA),Midnight(NIGHT)/ChatGPT-generatedimageMidnight(NIGHT),aprivacy-focusedsidechainofCardano(ADA),hassurged10%intokenpricewhilesurpassing57,000activeus...",
"keywords": "",
"snippet": "▲ Cardano (ADA), Midnight (NIGHT) / ChatGPT-generated image\n\nMidnight (NIGHT), a privacy-focused sidechain of Cardano (ADA), has surged 10% in token price whi...",
"url": "https://www.coinreaders.com/223775",
"image_url": "https://newsx.ecn.cdn.infralab.net/www.coinreaders.com/imgdata/coinreaders_com/202602/800_800_202602133719492.png",
"language": "ko",
"published_at": "2026-03-14T03:54:22.000000Z",
"source": "coinreaders.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "d0dce6dd-1660-4d72-8fd7-b661fddb8e47",
"title": "Axios: Israel to expand ground offensive in Lebanon",
"description": "According to the report, Israel plans to seize the entire area south of the Litani River and dismantle Hezbollah's military infrastructure, in what officials sa...",
"keywords": "Hezbollah, IDF, Lebanon, Lebanon War, Israel Katz, hezbollah iran, israel hezbollah, Operation Roaring Lion",
"snippet": "Israel is planning a large-scale invasion of southern Lebanon in order to dismantle Hezbollah's assets south of the Litani River, Axios reported on Friday, citi...",
"url": "https://www.jpost.com/israel-news/defense-news/article-889883",
"image_url": "https://images.jpost.com/image/upload/f_auto,fl_lossy/q_auto/c_fill,g_faces:center,h_720,w_1280/710349",
"language": "en",
"published_at": "2026-03-14T03:53:07.000000Z",
"source": "jpost.com",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "1bef602d-8503-4638-8021-464ba29ee382",
"title": "NBA Highlights: Rockets 107, Pelicans 105",
"description": "",
"keywords": "",
"snippet": "Kevin Durant posted 32 points and six rebounds, while Amen Thompson recorded a double-double with 23 points and 12 rebounds, as the Houston Rockets defeated the...",
"url": "https://www.sportsnet.ca/nba/video/nba-highlights-rockets-107-pelicans-105/",
"image_url": "https://www.sportsnet.ca/sn_favicon.ico",
"language": "en",
"published_at": "2026-03-14T03:50:22.000000Z",
"source": "sportsnet.ca",
"categories": [
"sports"
],
"relevance_score": null
},
{
"uuid": "d5f7ff20-1079-4015-948b-c560723713b0",
"title": "스미스전 앞둔 UFC 유수영, 계체 통과… “랭커 진입 밑거름 삼겠다”",
"description": "세계 최고 종합격투기(MMA) 단체 UFC서 활약 중인 ‘유짓수’ 유수영이 계체를 통과하며 한국계 미국 파이터 일라이자 스?...",
"keywords": "",
"snippet": "사진=UFC 제공\n\n세계 최고 종합격투기(MMA) 단체 UFC서 활약 중인 ‘유짓수’ 유수영이 계체를 통과하며 한국계 미국 파이터...",
"url": "https://www.sportsworldi.com:443/newsView/20260314504707",
"image_url": "https://www.sportsworldi.com/content/image/2026/03/14/20260314504706.jpg",
"language": "ko",
"published_at": "2026-03-14T03:49:17.000000Z",
"source": "sportsworldi.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "533c4251-7707-403d-bf99-9e60d0138e2b",
"title": "Trustkill to release Bleeding Through's 'This Is Live, This Is Murderous' on vinyl, now streaming",
"description": "Trustkill and Bleeding Through are preparing to release a limited vinyl run of the Orange County metalcore outfit's live performance recorded in live at The Gla...",
"keywords": "Bleeding Through, Trustkill Records, Lambgoat, news, hardcore, metal",
"snippet": "Trustkill and Bleeding Through are preparing to release a limited vinyl run of the Orange County metalcore outfit's live performance recorded in live at The Gla...",
"url": "https://lambgoat.com/news/52144/trustkill-to-release-bleeding-throughs-this-is-live-this-is-murderous-on-vinyl-now-streaming/",
"image_url": "https://lambgoat.com/cdn/2025/bleeding-through-20250213100654.jpg",
"language": "en",
"published_at": "2026-03-14T03:48:00.000000Z",
"source": "lambgoat.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "60cf8a79-496d-412a-9cf4-ce17037db06d",
"title": "Polícia fecha centro de treinamento do CV para adolescentes em ilha de área indígena de MT",
"description": "Investigação aponta que facção treinava integrantes em técnicas de tiro, guerrilha e sobrevivência",
"keywords": "comando vermelho, Rio de Janeiro, violência, tráfico de drogas, crime organizado, Mato Grosso-estado, região centro-oeste, museu da polícia civil, folha",
"snippet": "São Paulo\n\nUm centro clandestino de treinamento armado mantido por integrantes do Comando Vermelho dentro de uma área indígena em Mato Grosso foi fechado pel...",
"url": "https://www1.folha.uol.com.br/cotidiano/2026/03/policia-fecha-centro-de-treinamento-do-cv-para-adolescentes-em-ilha-de-area-indigena-de-mt.shtml",
"image_url": "https://f.i.uol.com.br/fotografia/2026/03/13/177343861769b48699b7f83_1773438617_3x2_lg.jpg",
"language": "pt",
"published_at": "2026-03-14T03:47:25.000000Z",
"source": "uol.com.br",
"categories": [
"tech",
"science"
],
"relevance_score": null
},
{
"uuid": "5a901c12-cf00-4525-ada4-498ece9ed6b1",
"title": "请稍候...",
"description": "",
"keywords": "",
"snippet": "",
"url": "https://www.jisilu.cn/question/519440",
"image_url": "",
"language": "zh",
"published_at": "2026-03-14T03:46:44.000000Z",
"source": "jisilu.cn",
"categories": [],
"relevance_score": null
},
{
"uuid": "1dcb1659-b148-47d7-b535-26774ecbdbe4",
"title": "????????? ??????? ???????????? ????? ????-??? ?????",
"description": "Серхио Перес не показал времени в первом сегменте квалификации к спринту Гран-при Кита?...",
"keywords": "Гран При Китая, стартовое поле, спринт, формула 1, f1",
"snippet": "",
"url": "https://f1report.ru/news/f1-93597.html",
"image_url": "https://f1report.ru/img/f1report_128.png",
"language": "ru",
"published_at": "2026-03-14T03:46:12.000000Z",
"source": "f1report.ru",
"categories": [
"sports"
],
"relevance_score": null
},
{
"uuid": "a1c71125-7cf1-4b2b-868a-043f3241f91b",
"title": "Randy Orton brutally attacks Cody Rhodes on WWE SmackDown",
"description": "What started as a cordial contract signing turned into a bloody assault at the hands of Orton.",
"keywords": "",
"snippet": "What started as a cordial contract signing turned into a bloody assault.\n\nRandy Orton and Cody Rhodes met in the main event segment of Friday’s SmackDown to s...",
"url": "https://www.f4wonline.com/news/wwe/randy-orton-brutally-attacks-cody-rhodes-on-wwe-smackdown/",
"image_url": "https://www.f4wonline.com/wp-content/uploads/2026/03/HDVwJ8tWoAAUp9Z.jpg",
"language": "en",
"published_at": "2026-03-14T03:45:59.000000Z",
"source": "f4wonline.com",
"categories": [
"sports"
],
"relevance_score": null
},
{
"uuid": "3cbdd52c-20b0-46ba-8c84-b768c9f90a79",
"title": "[뉴욕 금가격] 유가 급등發 인플레 우려에 1.5% 하락",
"description": "국제 금 가격이 약 1.5% 하락했다.국제 유가가 고공행진을 하면서 인플레이션 우려가 되살아났고, 이에 연방준비제도(연?...",
"keywords": "오늘의 마켓뷰",
"snippet": "(뉴욕=연합인포맥스) 최진우 특파원 = 국제 금 가격이 약 1.5% 하락했다.\n\n골드바\n\n연합뉴스 자료사진\n\n국제 유가가 고공행?...",
"url": "https://news.einfomax.co.kr/news/articleView.html?idxno=4403666",
"image_url": "https://cdn.news.einfomax.co.kr/news/thumbnail/202603/4403666_300259_462_v150.jpg",
"language": "ko",
"published_at": "2026-03-14T03:45:42.000000Z",
"source": "news.einfomax.co.kr",
"categories": [
"general"
],
"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-03-14T03:55:27 |
2026-03-14T03:55 |
2026-03-14T03 |
2026-03-14 |
2026-03 |
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-03-14T03:55:27 |
2026-03-14T03:55 |
2026-03-14T03 |
2026-03-14 |
2026-03 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-03-14
|
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-03-07
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();