Documentation
Sign up for free!
Get instant access to the API with your free API token. No billing details required!
Getting Started
Introduction
Our API was developed to provide global news from thousands of sources with exceptional response times. On average we add over 1 million articles weekly, so you will never be short of content. Even better, it is completely free!
To get started simply sign up and use your API token in any of the available API endpoints documented below for instant access.
If you have any questions or concerns, feel free to contact us.
Authentication
As mentioned above, when you sign up for free you will find your API token on your dashboard. Simply add this to any of our API endpoints as a GET parameter to gain access. Examples of how this is done can be found below.
API Endpoints
Headlines Available on: Standard plan and above
Endpoint
GET https://api.thenewsapi.com/v1/news/headlines HTTP/1.1
Use this endpoint to find get the latest headlines by category along with similar articles, allowing you to create the perfect news aggregation page similar to Google News .
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
locale |
false | Comma separated list of country codes to include in the result set. Default is all countries.
Click here for a list of supported countries.
Example: us,ca (US + Canada).
|
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_on |
false | Find headlines for articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-04-20
|
headlines_per_category |
false | Specify the number of articles you want to return per category. The maximum is 10 and the default is 6. |
include_similar |
false | Specify if you wish to include similar articles with each base article. Default is true. |
Response Objects
| name | description |
|---|---|
data > uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
data > title |
The article title. |
data > description |
The article meta description. |
data > keywords |
The article meta keywords. |
data > snippet |
The first 60 characters of the article body. |
data > url |
The URL to the article. |
data > image_url |
The URL to the article image. |
data > language |
The language of the source. |
data > published_at |
The datetime the article was published. |
data > source |
The domain of the source. |
data > categories |
Array of strings which the source is categorized as. |
data > locale |
Locale of the source. |
data > similar |
An array of similar articles to the base article. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/headlines?locale=us&language=en&api_token=YOUR_API_TOKEN
Example Response
{
"data": {
"general": [
{
"uuid": "7cea0ffe-eae4-4c45-a28b-01c5d8c4a82d",
"title": "8 children killed in Louisiana mass shooting",
"description": "Eight children were killed in a mass shooting in Shreveport, Louisiana, on Sunday morning, according to police",
"keywords": "",
"snippet": "Eight children were killed in a mass shooting in Shreveport, Louisiana, on Sunday morning, according to police.\n\nSubscribe to read this story ad-free Get unlimi...",
"url": "https://www.nbcnews.com/news/us-news/louisiana-shreveport-mass-shooting-rcna340868",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-04/200701-shreveport-police-ONETIMEUSEONLY-mn-0920-60c18d.jpg",
"language": "en",
"published_at": "2026-04-19T16:13:11.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "591c0975-3327-4356-901e-7787326e2715",
"title": "8 children dead after a mass shooting in Louisiana, police say",
"description": "Authorities in Louisiana say eight children were killed in a “domestic disturbance,” with the victims ranging in age from 1 to 14 years old",
"keywords": "Law enforcement, Crime, Shootings, U.S. news, General news",
"snippet": "Authorities say eight children were killed in a \"domestic disturbance.\"\n\n8 children dead after a mass shooting in Louisiana, police say\n\nBy The Associated Press...",
"url": "https://abcnews.com/US/wireStory/8-children-ages-1-14-dead-after-mass-132186417",
"image_url": "https://s.abcnews.com/images/US/abc_news_default_2000x2000_update_16x9_992.jpg",
"language": "en",
"published_at": "2026-04-19T16:26:23.000000Z",
"source": "abcnews.go.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "a9e3dafb-554b-427a-9bbf-636d617e61a8",
"title": "8 children killed in Louisiana shooting, police say",
"description": "The victims ranged in age from 1 to about 14, police said. The shooter, who was related to some of the children, is dead.",
"keywords": "",
"snippet": "Eight children were killed Sunday in a shooting in Shreveport, Louisiana, that police say appeared to be linked to a domestic disturbance.\n\nShreveport Police Ch...",
"url": "https://www.washingtonpost.com/nation/2026/04/19/louisiana-shooting/",
"image_url": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://arc-anglerfish-washpost-prod-washpost.s3.amazonaws.com/public/ZTHTPCG7DCNXCNBENNM6FTVEYM_size-normalized.jpg&w=1440",
"language": "en",
"published_at": "2026-04-19T16:56:45.000000Z",
"source": "washingtonpost.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "b7750f57-9d6d-4e25-b921-77892bed73a2",
"title": "Eight children killed in shooting in Louisiana – police — RT World News",
"description": "Eight children died in a Shreveport shooting linked to a domestic dispute, police say. The suspect was killed after fleeing and carjacking a vehicle",
"keywords": "",
"snippet": "Officials described the incident as a domestic dispute gone wrong\n\nEight children were killed in a mass shooting in Shreveport, Louisiana on Sunday, police have...",
"url": "https://www.rt.com/news/638724-shooting-us-eight-children-dead/",
"image_url": "https://mf.b37mrtl.ru/files/2026.04/article/69e5086720302715077540e4.jpg",
"language": "en",
"published_at": "2026-04-19T16:55:11.000000Z",
"source": "rt.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "df1f6f3c-9140-4a19-9e8e-92ce05bbf6d5",
"title": "8 children fatally shot in Louisiana domestic violence incident: Police",
"description": "8 children were fatally shot in what police say was a domestic violence incident, while others were injured.",
"keywords": "",
"snippet": "Two other people survived gunshot wounds, police said.\n\nThis is a breaking news story please check back for updates.\n\nThis is a breaking news story please check...",
"url": "https://abcnews.com/US/8-children-fatally-shot-louisiana-domestic-violence-incident/story?id=132187316",
"image_url": "https://s.abcnews.com/images/General/Breaking-News-banner-abc-ps-181024_hpMain_16x9_992.jpg?w=1600",
"language": "en",
"published_at": "2026-04-19T17:34:36.000000Z",
"source": "abcnews.go.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "a23fe25e-d559-4efb-bef7-b4298a14fb3f",
"title": "Police give early update on Shreveport, Louisiana mass shooting",
"description": "Officials in Louisiana held a news conference after 10 people were shot in a domestic disturbance that left eight children dead. Corporal Chris Bordelon of the Shreveport Police Department, Mayor Tom Arceneaux and Chief Wayne Smith provided updates on Sunday afternoon.",
"keywords": "Gun Violence, Mass Shooting, Louisiana",
"snippet": "Police give early update on Shreveport, Louisiana mass shooting Officials in Louisiana held a news conference after 10 people were shot in a domestic disturbanc...",
"url": "https://www.cbsnews.com/video/louisiana-shreveport-police-mass-shooting-update/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/04/19/1094da50-9c59-4240-8b24-4eaf1625c0e0/thumbnail/1200x630/42fa13501faca97e9ce8de6a97617714/untitled-design-2026-04-19t133501-826.jpg",
"language": "en",
"published_at": "2026-04-19T17:56:21.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
},
{
"uuid": "3ad72bf0-3bfc-46c9-86a3-f66ebdcc1c89",
"title": "Roman Reigns, CM Punk put on professional wrestling masterclass at WrestleMania 42",
"description": "Roman Reigns won the world heavyweight championship at WrestleMania 42, defeating CM Punk in a hard-hitting main event at Allegiant Stadium in Las Vegas.",
"keywords": "wrestlemania, wwe, pro wrestling",
"snippet": "NEW You can now listen to Fox News articles!\n\nCM Punk and Roman Reigns met at WrestleMania 42 in a clash between two titans of the pro wrestling industry who he...",
"url": "https://www.foxnews.com/sports/roman-reigns-cm-punk-put-professional-wrestling-masterclass-wrestlemania-42",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/04/roman-reigns-cm-punk-wrestlemania-fox-news-001.jpeg",
"language": "en",
"published_at": "2026-04-20T02:26:10.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "f0d27a4a-6b36-4696-98d5-3717a05ed70f",
"title": "WWE WrestleMania 42 Night 2: Live match results and analysis",
"description": "ESPN breaks down all the action from Night 2 of WrestleMania 42 in Las Vegas.",
"keywords": "",
"snippet": "Open Extended Reactions\n\nAfter a massive night of high-flying moments and title changes on Night 1, the WrestleMania 42 action continues on Night 2 at Allegiant...",
"url": "https://www.espn.com/wwe/story/_/id/48494669/wwe-wrestlemania-42-night-2-live-match-results-analysis-cm-punk-vs-roman-reigns",
"image_url": "https://a1.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0415%2Fr1644001_1200x675_16%2D9.jpg",
"language": "en",
"published_at": "2026-04-19T23:03:59.000000Z",
"source": "espn.com",
"categories": [
"sports",
"general"
],
"locale": "us"
},
{
"uuid": "10591fb3-52a5-4420-be2f-5b94c3aec4d5",
"title": "Oba Femi conquers ‘The Beast Incarnate,’ Brock Lesnar signals WWE retirement at WrestleMania 42",
"description": "Oba Femi defeated Brock Lesnar at WrestleMania 42 in Las Vegas, pinning him after hitting the Fall from Grace in the newcomer's stunning WrestleMania debut.",
"keywords": "wrestlemania, wwe, pro wrestling",
"snippet": "NEW You can now listen to Fox News articles!\n\nOba Femi and Brock Lesnar entered their WrestleMania 42 match on Sunday night in what was poised to be a true \"sho...",
"url": "https://www.foxnews.com/sports/oba-femi-conquers-beast-incarnate-brock-lesnar-signals-wwe-retirement-wrestlemania-42",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/04/oba-femi-brock-lesnar-wrestlemania-fox-news-001.jpeg",
"language": "en",
"published_at": "2026-04-19T22:45:58.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "76ec7a37-8dd4-4279-9514-aa64071cc3eb",
"title": "Penta hangs on to Intercontinental Championship in exhilarating ladder match at WrestleMania 42",
"description": "Penta retained the Intercontinental Championship in a thrilling six-man ladder match at WrestleMania 42, hitting a Mexican Destroyer on Je'Von Evans before climbing to grab the belt.",
"keywords": "wrestlemania, wwe, pro wrestling",
"snippet": "NEW You can now listen to Fox News articles!\n\nA six-man ladder match for the Intercontinental Championship with some of WWE’s best superstars proved to be one...",
"url": "https://www.foxnews.com/sports/penta-hangs-intercontinental-championship-exhilarating-ladder-match-wrestlemania-42",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/04/penta-intercontinental-championship-ladder-fox-news-001.jpeg",
"language": "en",
"published_at": "2026-04-19T23:22:37.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "e51b7988-3a8d-406d-b8f0-6d0b96375cea",
"title": "‘Demon’ Finn Balor settles score with Dominik Mysterio at WrestleMania 42",
"description": "Finn Balor defeated Dominik Mysterio in a street fight at WrestleMania 42, bringing out his \"Demon\" persona and hitting a Coup de Grâce through a table to win.",
"keywords": "wrestlemania, wwe, pro wrestling",
"snippet": "NEW You can now listen to Fox News articles!\n\nFinn Balor and Dominik Mysterio were once brothers in arms in the Judgment Day. The two helped the faction run \"Mo...",
"url": "https://www.foxnews.com/sports/demon-finn-balor-settles-score-dominik-mysterio-wrestlemania-42",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/04/finn-balor-wrestlemania-las-vegas-fox-news-003.jpeg",
"language": "en",
"published_at": "2026-04-20T00:18:52.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "ee976701-d52c-43ff-9032-a9ae26903849",
"title": "Rhea Ripley captures WWE Women's Championship at WrestleMania 42",
"description": "Rhea Ripley recaptured the WWE Women's Championship at WrestleMania 42 by pinning Jade Cargill after Iyo Sky helped neutralize interference from B-Fab and Michin.",
"keywords": "wrestlemania, wwe, pro wrestling",
"snippet": "NEW You can now listen to Fox News articles!\n\nRhea Ripley’s path back to the top of the women’s division was a long one, but on Sunday night, she survived t...",
"url": "https://www.foxnews.com/sports/rhea-ripley-captures-wwe-womens-championship-wrestlemania-42",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/04/rhea-ripley-wwe-womens-championship-fox-news-001.jpeg",
"language": "en",
"published_at": "2026-04-20T01:07:41.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
}
],
"business": ...,
"sports": ...,
"tech": ...,
"science": ...,
"health": ...
}
}
Top Stories Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/top HTTP/1.1
Use this endpoint to find live and historical top stories around the world or filter to get only top stories for specific countries. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
locale |
false | Comma separated list of country codes to include in the result set. Default is all countries.
Click here for a list of supported countries.
Example: us,ca (US + Canada).
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-04-20T03:56:28 |
2026-04-20T03:56 |
2026-04-20T03 |
2026-04-20 |
2026-04 |
2026
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-04-20T03:56:28 |
2026-04-20T03:56 |
2026-04-20T03 |
2026-04-20 |
2026-04 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-04-20
|
sort |
false | Sort by published_on or relevance_score (only available when used in conjunction with search).
Default is published_at unless search is used and sorting by published_at is not included,
in which case relevance_score is used. |
limit |
false | Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan. |
page |
false | Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of articles found for the request. |
meta > returned |
The number of articles returned on the page.
This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page. |
meta > limit |
The limit based on the limit parameter. |
meta > page |
The page number based on the page parameter. |
data > uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
data > title |
The article title. |
data > description |
The article meta description. |
data > keywords |
The article meta keywords. |
data > snippet |
The first 60 characters of the article body. |
data > url |
The URL to the article. |
data > image_url |
The URL to the article image. |
data > language |
The language of the source. |
data > published_at |
The datetime the article was published. |
data > source |
The domain of the source. |
data > categories |
Array of strings which the source is categorized as. |
data > relevance_score |
Relevance score based on the search parameter. If the search parameter is not used, this will be null. |
data > locale |
Locale of the source. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/top?api_token=YOUR_API_TOKEN&locale=us&limit=3
Example Response
{
"meta": {
"found": 1602931,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "47a3ea74-b1ad-4a2e-9975-1c523433c9c7",
"title": "‘Mormon Wives’ Star Jessi Draper Reacts to Marciano Brunette Romance Speculation",
"description": "Jessi Draper reacted to Marciano Brunette romance speculation after a news outlet published photos of the duo in Nashville",
"keywords": "",
"snippet": "The Secret Lives of Mormon Wives’ Jessi Draper responded to a report claiming that “sparks might be flying” between her and Vanderpump Villa’s Marciano ...",
"url": "https://www.usmagazine.com/celebrity-news/news/jessi-draper-reacts-to-marciano-brunette-romance-speculation/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/04/Jessi-split.jpg?crop=0px%2C0px%2C2000px%2C1051px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2026-04-20T03:18:10.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "3042b12e-d319-40e9-a35a-7264c51f5b72",
"title": "Anthony Scaramucci Says Bitcoin 'Checks Every Single Box' Of What Defines 'Money' And That's Why He's 'Bu",
"description": "Anthony Scaramucci, founder of global investment firm SkyBridge Capital, said on Sunday that Bitcoin (CRYPTO: BTC) fulfills",
"keywords": "",
"snippet": "‘Bitcoin Has Built Its Own Trust System’\n\nIn an X post, Scaramucci emphasized the trustworthiness of Bitcoin, comparing it to the trust people have in fiat ...",
"url": "https://www.benzinga.com/crypto/cryptocurrency/26/04/51904642/scaramucci-bitcoin-money-definition-bullish-argument-checks-every-box",
"image_url": "https://cdn.benzinga.com/files/images/story/2026/04/19/Washington--Dc---usa---April-26--2018-An.jpeg?width=1200&height=800&fit=crop",
"language": "en",
"published_at": "2026-04-20T03:17:41.000000Z",
"source": "benzinga.com",
"categories": [
"business"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "11912bad-ad5d-4186-8b1a-6c54a4c3ad28",
"title": "Taylor Frankie Paul On \"Ugly Parts\" Of Healing After Charges Dropped",
"description": "After her domestic violence charges were dropped last week, Taylor Frankie Paul has opened up about moving forward.",
"keywords": "",
"snippet": "After her domestic violence charges were dropped last week, Taylor Frankie Paul has opened up about moving forward.\n\nThe Secret Lives of Mormon Wives star, whos...",
"url": "https://deadline.com/2026/04/taylor-frankie-paul-healing-charges-dropped-1236865456/",
"image_url": "https://deadline.com/wp-content/uploads/2026/04/P104S2N7-e1776653393546.jpg?w=827",
"language": "en",
"published_at": "2026-04-20T03:12:46.000000Z",
"source": "deadline.com",
"categories": [
"entertainment"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "38a38e1c-e0a8-4186-b23f-c3b6e3c6f4ea",
"title": "4/19/2026: Iran's HEU; One Mother's Story; Wild Concerto",
"description": "First, U.S. eyes Iran's highly enriched uranium. Then, Rachel Goldberg-Polin | 60 Minutes Interview. And, turning recordings of animals into music.",
"keywords": "Iran, Hamas, Israel, Gaza, Middle East",
"snippet": "4/19/2026: Iran's HEU; One Mother's Story; Wild Concerto First, U.S. eyes Iran's highly enriched uranium. Then, Rachel Goldberg-Polin | 60 Minutes Interview. An...",
"url": "https://www.cbsnews.com/video/60minutes-2026-04-19/",
"image_url": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/04/19/139dda4d-28c2-486d-8cb6-5aae96238a56/thumbnail/1200x630/602811a6f7c7995ad680f349ed8742c1/60-minutes-full-episode-04-19-26.jpg",
"language": "en",
"published_at": "2026-04-20T03:00:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "4f307a4e-f83e-453a-96af-c39b9456cb71",
"title": "Trail Blazers vs. Spurs (Apr 19, 2026) Live Score",
"description": "Live coverage of the Portland Trail Blazers vs. San Antonio Spurs NBA game on ESPN, including live score, highlights and updated stats.",
"keywords": "",
"snippet": "Paolo Banchero scores 23 and Magic beat Pistons 112-101 to extend NBA's longest home postseason skid\n\n— Paolo Banchero had 23 points, nine rebounds and four a...",
"url": "https://www.espn.com/nba/game/_/gameId/401869194/trail-blazers-spurs",
"image_url": "http://s.espncdn.com/stitcher/sports/basketball/nba/events/401869194.png?templateId=espn.com.share.1",
"language": "en",
"published_at": "2026-04-20T02:30:18.000000Z",
"source": "espn.com",
"categories": [
"sports",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "3ad72bf0-3bfc-46c9-86a3-f66ebdcc1c89",
"title": "Roman Reigns, CM Punk put on professional wrestling masterclass at WrestleMania 42",
"description": "Roman Reigns won the world heavyweight championship at WrestleMania 42, defeating CM Punk in a hard-hitting main event at Allegiant Stadium in Las Vegas.",
"keywords": "wrestlemania, wwe, pro wrestling",
"snippet": "NEW You can now listen to Fox News articles!\n\nCM Punk and Roman Reigns met at WrestleMania 42 in a clash between two titans of the pro wrestling industry who he...",
"url": "https://www.foxnews.com/sports/roman-reigns-cm-punk-put-professional-wrestling-masterclass-wrestlemania-42",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/04/roman-reigns-cm-punk-wrestlemania-fox-news-001.jpeg",
"language": "en",
"published_at": "2026-04-20T02:26:10.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "fa586ca5-d3bd-489c-ac6c-44f049ba55a1",
"title": "4/19: CBS Weekend News",
"description": "Eight kids killed in Louisiana shooting; U.S.-Iran ceasefire on shaky ground.",
"keywords": "Iran, Republicans, Donald Trump, Politics, Democrats, Louisiana",
"snippet": "4/19: CBS Weekend News Eight kids killed in Louisiana shooting; U.S.-Iran ceasefire on shaky ground.",
"url": "https://www.cbsnews.com/video/041926-cbs-weekend-news/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/04/20/bded5eea-584f-4c6a-aecd-270eb3c1b4fa/thumbnail/1200x630/2bac79eaaa576e6c2104ea6dc12fb9d0/enfull0419.jpg",
"language": "en",
"published_at": "2026-04-20T02:12:26.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "13e68f42-3f18-4907-8077-0c1cce809251",
"title": "WWE Star Brock Lesnar Seemingly Retires, Leaves Boots in the Ring at WrestleMania",
"description": "WWE star Brock Lesnar appeared to retire at WrestleMania by placing his boots in the ring after a short match with Oba Femi in Las Vegas",
"keywords": "",
"snippet": "WWE star Brock Lesnar has seemingly hung up his boots.\n\nOn the second night of WrestleMania, staged in Las Vegas’ Allegiant Stadium, on Sunday, April 19, Lesn...",
"url": "https://www.usmagazine.com/entertainment/news/brock-lesnar-retires-leaves-boots-in-ring-at-wrestlemania/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/04/GettyImages-2272111297-Brock.jpg?crop=230px%2C324px%2C1028px%2C541px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2026-04-20T02:12:15.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "41912407-3a09-482d-8935-bd32e9dd9966",
"title": "Bitcoin, Ethereum, XRP, Dogecoin Slide As Iran Claims 'Ceasefire Violations' Amid Middle-East Tensions: A",
"description": "Leading cryptocurrencies fell alongside stock futures Sunday evening as tensions between the U.S. and Iran increased dramatically over the weekend.",
"keywords": "",
"snippet": "Leading cryptocurrencies fell alongside stock futures Sunday evening as tensions between the U.S. and Iran increased dramatically over the weekend.\n\nCrypto Mark...",
"url": "https://www.benzinga.com/crypto/cryptocurrency/26/04/51904565/bitcoin-ethereum-xrp-dogecoin-slide-iran-ceasefire-violations-btc-momentum-fading",
"image_url": "https://cdn.benzinga.com/files/images/story/2026/04/19/Golden-Bitcoin-Coin-In-Red-And-Blue-Smok.jpeg?width=1200&height=800&fit=crop",
"language": "en",
"published_at": "2026-04-20T02:10:40.000000Z",
"source": "benzinga.com",
"categories": [
"business"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "668da567-e7a5-4ca6-949f-674401747937",
"title": "Johnny Knoxville shocks suburbs with epic explosion that Southern California locals mistook for plane crash",
"description": "Johnny Knoxville says a \"monstrous explosion\" that alarmed Simi Valley residents was from the final day ever of \"Jackass\" filming at Big Sky Movie Ranch.",
"keywords": "reality, entertainment, tv",
"snippet": "NEW You can now listen to Fox News articles!\n\nJohnny Knoxville played chaos agent in Southern California over the weekend.\n\nA \"double explosion\" was captured on...",
"url": "https://www.foxnews.com/entertainment/johnny-knoxville-shocks-suburbs-epic-explosion-southern-california-locals-mistook-plane-crash",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/04/johnny-knoxville.jpeg",
"language": "en",
"published_at": "2026-04-20T02:09:47.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
}
]
}
All News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/all HTTP/1.1
Use this endpoint to find all live and historical articles we collect. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-04-20T03:56:28 |
2026-04-20T03:56 |
2026-04-20T03 |
2026-04-20 |
2026-04 |
2026
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-04-20T03:56:28 |
2026-04-20T03:56 |
2026-04-20T03 |
2026-04-20 |
2026-04 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-04-20
|
sort |
false | Sort by published_on or relevance_score (only available when used in conjunction with search).
Default is published_at unless search is used and sorting by published_at is not included,
in which case relevance_score is used. |
limit |
false | Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan. |
page |
false | Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of articles found for the request. |
meta > returned |
The number of articles returned on the page.
This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page. |
meta > limit |
The limit based on the limit parameter. |
meta > page |
The page number based on the page parameter. |
data > uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
data > title |
The article title. |
data > description |
The article meta description. |
data > keywords |
The article meta keywords. |
data > snippet |
The first 60 characters of the article body. |
data > url |
The URL to the article. |
data > image_url |
The URL to the article image. |
data > language |
The language of the source. |
data > published_at |
The datetime the article was published. |
data > source |
The domain of the source. |
data > categories |
Array of strings which the source is categorized as. |
data > relevance_score |
Relevance score based on the search parameter. If the search parameter is not used, this will be null. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&language=en&limit=3
Example Response
{
"meta": {
"found": 53908920,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "3fa44017-ae69-412b-ab8d-c3151f947b9d",
"title": "Bulgaria's former president Radev takes strong lead in election",
"description": "Progressive Bulgaria, led by pro-Russian former president Rumen Radev, leads the parliamentary election with 44.59% of votes as 32% are counted.",
"keywords": "Elections, Russia, Vladimir Putin, Bulgaria, president",
"snippet": "Progressive Bulgaria, the party of Bulgaria's pro-Russian former president Rumen Radev, was leading in Sunday's parliamentary election with 44.59% of votes, aft...",
"url": "https://www.jpost.com/international/article-893556",
"image_url": "https://images.jpost.com/image/upload/f_auto,fl_lossy/q_auto/c_fill,g_faces:center,h_720,w_1280/716978",
"language": "en",
"published_at": "2026-04-20T03:56:47.000000Z",
"source": "jpost.com",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "3e558deb-dcee-4284-991e-55de9642097b",
"title": "Tadeu se emociona ao falar sobre Oscar e enfatiza 'jeito Schmidt de ser'",
"description": "Tadeu Schmidt se emocionou ao relembrar momentos ao lado do irmão, Oscar Schmidt. A entrevista foi exibida pelo Fantástico na noite deste domingo (19).",
"keywords": "",
"snippet": "Ele é o herói que eu tinha em casa, então, a maneira como eu sempre enfrentei as coisas na minha vida, isso é culpa de Oscar.\n\nTadeu Schmidt, em entrevista ...",
"url": "https://www.uol.com.br/esporte/ultimas-noticias/2026/04/19/tadeu-se-emociona-ao-falar-sobre-oscar-e-enfatiza-jeito-schmidt-de-ser.ghtm",
"image_url": "https://conteudo.imguol.com.br/c/esporte/22/2026/04/19/tadeu-schmidt-se-emociona-ao-falar-sobre-oscar-schmidt-no-fantastico-da-globo-1776644829519_v2_615x300.png",
"language": "pt",
"published_at": "2026-04-20T03:55:20.000000Z",
"source": "uol.com.br",
"categories": [
"tech",
"science"
],
"relevance_score": null
},
{
"uuid": "196b00a5-7142-4fba-8a06-45d687a2af0d",
"title": "한동대, 미국 에반겔리아대학교와 HI Alliance 협약",
"description": "신학·목회 인재 글로벌 경로 열려\r전인지능(HI) 기반 글로벌 교육\r네트워크 'HI Alliance' 참여 확대\r\r한동대학교(총장 박성?...",
"keywords": "",
"snippet": "외국인 졸업생 석·박사 장학 지원\n\n신학·목회 인재 글로벌 경로 열려\n\n전인지능(HI) 기반 글로벌 교육\n\n네트워크 ‘HI Allia...",
"url": "https://www.christiantoday.co.kr/news/374630",
"image_url": "https://images.christiantoday.co.kr/data/images/full/386050/image.jpg",
"language": "ko",
"published_at": "2026-04-20T03:50:24.000000Z",
"source": "christiantoday.co.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "4ad3806f-36f7-4dd2-bce5-78f0b3ab3eeb",
"title": "ВСУ берут в наемники сапожников из Колумбии",
"description": "РИА Новости: ВСУ берут в наемники сапожников и агротехников из Колумбии.",
"keywords": "",
"snippet": "Собеседник агентства рассказал, что по мере развития российско-украинского конфликта ?...",
"url": "https://news.mail.ru/politics/70598290/",
"image_url": "https://news.mail.ru/social_preview/70598290/?time=3f324481ceaf13bb394f4b5efcf917d2",
"language": "ru",
"published_at": "2026-04-20T03:50:19.000000Z",
"source": "news.mail.ru",
"categories": [],
"relevance_score": null
},
{
"uuid": "3cdb8964-a67a-4797-a395-236f86a8b66a",
"title": "«Худший кошмар»: Киеву сообщили плохие новости из-за выборов в Болгарии",
"description": "Telegraph: выборы в Болгарии могут стать худшим кошмаром для Украины и ЕС.",
"keywords": "",
"snippet": "В воскресенье в Болгарии прошли парламентские выборы. Как ранее сообщало Болгарское на...",
"url": "https://news.mail.ru/politics/70598289/",
"image_url": "https://resizer.mail.ru/p/03a3ccaf-74e6-54f4-a997-368f2598f81b/AQAGtu8CY-lv8eap61Dn0Pd1P5r8O3oTF3eO_ktwCsG9C-01An0bx9FazbFs5qewTJd7Lba034-a3Lyx8VMRWMni94g.jpg",
"language": "ru",
"published_at": "2026-04-20T03:50:15.000000Z",
"source": "news.mail.ru",
"categories": [],
"relevance_score": null
},
{
"uuid": "0c6dfe1a-f029-44d2-a895-0b2cb8b12f4b",
"title": "Harry Kane vows Bayern Munich have 'a lot to play for' after Bundesliga title",
"description": "Harry Kane insists Bayern Munich still have \"a lot to play for\" this season after winning the Bundesliga title following their 4-2 thrashing over Stuttgart on S...",
"keywords": "",
"snippet": "Open Extended Reactions\n\nHarry Kane insists Bayern Munich still have \"a lot to play for\" this season after winning the Bundesliga title following their 4-2 thra...",
"url": "https://www.espn.co.uk/football/story/_/id/48534404/harry-kane-vows-bayern-munich-lot-play-bundesliga-title",
"image_url": "https://a4.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0419%2Fr1646095_584x389_3%2D2.jpg",
"language": "en",
"published_at": "2026-04-20T03:48:09.000000Z",
"source": "espn.co.uk",
"categories": [
"sports"
],
"relevance_score": null
},
{
"uuid": "c1423ff3-c513-4b5d-be1d-fe564d809f70",
"title": "계속되는 중동 분쟁, 최선 기도하며 최악 대비해야",
"description": "서남아시아는 인도와 중앙아시아를 제외한 아시아 남서부 지역이며, 흔히 중동(中東) 지방이라 부르는 곳이다. 아시아와...",
"keywords": "",
"snippet": "[김형태 칼럼] 중동 전쟁의 이해\n\n▲미국과 이란의 휴전 발표 보도 화면. ⓒKBS 캡처\n\n서남아시아는 인도와 중앙아시아를 ?...",
"url": "https://www.christiantoday.co.kr/news/374629",
"image_url": "https://images.christiantoday.co.kr/data/images/full/386049/image.jpg",
"language": "ko",
"published_at": "2026-04-20T03:48:07.000000Z",
"source": "christiantoday.co.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "0e938896-f97f-4ecf-8654-2c138d8de603",
"title": "MLB Highlights: Braves 4, Phillies 2",
"description": "",
"keywords": "",
"snippet": "Michael Harris II hit a solo home run, Matt Olson, Austin Riley, and Ozzie Albies chipped in with an RBI each, and the Atlanta Braves handled the Philadelphia P...",
"url": "https://www.sportsnet.ca/mlb/video/mlb-highlights-braves-4-phillies-2-2/",
"image_url": "https://www.sportsnet.ca/sn_favicon.ico",
"language": "en",
"published_at": "2026-04-20T03:47:38.000000Z",
"source": "sportsnet.ca",
"categories": [
"sports"
],
"relevance_score": null
},
{
"uuid": "562a303b-13e7-4214-9edf-004ead5965e9",
"title": "뷰티,패션 인플루언서 다해연 : 네이버 블로그",
"description": "",
"keywords": "",
"snippet": "",
"url": "https://blog.naver.com/dressup6/224258587115?fromRss=true&trackingCode=rss",
"image_url": "https://ssl.pstatic.net/static/blog/icon/favicon.ico",
"language": "ko",
"published_at": "2026-04-20T03:47:16.000000Z",
"source": "blog.naver.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "f09d7073-dde3-493a-ba77-c11977f75aa1",
"title": "Компании уходят из ЕС из-за потери ресурсов из России, заявили в Словакии",
"description": "Гашпар: поставки энергоресурсов из России сохранили бы производства внутри ЕС.",
"keywords": "",
"snippet": "«Российские ресурсы долгое время были дешевле альтернатив. Их возвращение снизило бы д...",
"url": "https://news.mail.ru/politics/70598275/",
"image_url": "https://news.mail.ru/social_preview/70598275/?time=f82b02e95856940239f54c45c98b4141",
"language": "ru",
"published_at": "2026-04-20T03:47:12.000000Z",
"source": "news.mail.ru",
"categories": [],
"relevance_score": null
}
]
}
Similar News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/similar/uuid HTTP/1.1
Use this endpoint to find similar stories to a specific article based on its UUID.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-04-20T03:56:28 |
2026-04-20T03:56 |
2026-04-20T03 |
2026-04-20 |
2026-04 |
2026
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-04-20T03:56:28 |
2026-04-20T03:56 |
2026-04-20T03 |
2026-04-20 |
2026-04 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-04-20
|
limit |
false | Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan. |
page |
false | Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of articles found for the request. |
meta > returned |
The number of articles returned on the page.
This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page. |
meta > limit |
The limit based on the limit parameter. |
meta > page |
The page number based on the page parameter. |
data > uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
data > title |
The article title. |
data > description |
The article meta description. |
data > keywords |
The article meta keywords. |
data > snippet |
The first 60 characters of the article body. |
data > url |
The URL to the article. |
data > image_url |
The URL to the article image. |
data > language |
The language of the source. |
data > published_at |
The datetime the article was published. |
data > source |
The domain of the source. |
data > categories |
Array of strings which the source is categorized as. |
data > relevance_score |
Relevance score based on the article provided. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/similar/cc11e3ab-ced0-4a42-9146-e426505e2e67?api_token=YOUR_API_TOKEN&language=en&published_on=2020-12-01
Example Response
{
"meta": {
"found": 3571,
"returned": 3,
"limit": 3,
"page": 1
},
"data": [
{
"uuid": "df4ad427-a672-4c67-b6c6-6f81aa00e164",
"title": "Tesla stock jumps after announcement it will join S&P 500 in one go",
"description": "Tesla's stock price surged early Tuesday after the company b...",
"keywords": "Business, s&p 500, stocks, tesla",
"snippet": "Tesla’s stock price surged early Tuesday after the company...",
"url": "https://nypost.com/2020/12/01/tesla-stock-jumps-on-news-it-will-join-sp-500-in-one-shot/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2020/12/tesla-52.jpg?quality=90&strip=all&w=1200",
"language": "en",
"published_at": "2020-12-01T14:35:46.000000Z",
"source": "nypost.com",
"categories": [
"business"
],
"relevance_score": 153.61266
},
{
"uuid": "c9a23881-12dd-4005-8982-7b6552a2eb50",
"title": "Tesla To Join S&P 500 With Full Market Cap On December 21",
"description": "Tesla will be added to the S&P 500 index all at once at its ...",
"keywords": "Tesla, S&P500, EV, Automotive, Stocks, Investing",
"snippet": "Tesla (NASDAQ: TSLA) will be added to the S&P 500 index all ...",
"url": "https://oilprice.com/Latest-Energy-News/World-News/Tesla-To-Join-SP-500-With-Full-Market-Cap-On-December-21.html",
"image_url": "https://d32r1sh890xpii.cloudfront.net/news/718x300/2020-12-01_xwjdajwctl.jpg",
"language": "en",
"published_at": "2020-12-01T16:30:00.000000Z",
"source": "oilprice.com",
"categories": [
"general",
"business"
],
"relevance_score": 146.92773
},
{
"uuid": "18afdb1c-7742-4016-bf8c-a2f114e11199",
"title": "Tesla to Enter S&P 500 at Full Weight in December",
"description": "The electric-vehicle maker will be added to the broad stock-...",
"keywords": "Motor Vehicles, Alternative Fuel Vehicles, Trusts Funds Financial Vehicles, Diversified Holding Companies, Automotive",
"snippet": "S&P Dow Jones Indices said it will add Tesla Inc.’s full w...",
"url": "https://www.wsj.com/articles/tesla-to-enter-s-p-500-at-full-weight-in-december-11606780897?mod=pls_whats_news_us_business_f",
"image_url": "https://images.wsj.net/im-265933/social",
"language": "en",
"published_at": "2020-12-01T00:01:00.000000Z",
"source": "online.wsj.com",
"categories": [
"business"
],
"relevance_score": 128.22346
}
]
}
News by UUID Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/uuid/uuid HTTP/1.1
Use this endpoint to find specific articles by the UUID which is returned on our search endpoints. This is useful if you wish to store the UUID to return the article later.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
Response Objects
| name | description |
|---|---|
uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
title |
The article title. |
description |
The article meta description. |
keywords |
The article meta keywords. |
snippet |
The first 60 characters of the article body. |
url |
The URL to the article. |
image_url |
The URL to the article image. |
language |
The language of the source. |
published_at |
The datetime the article was published. |
source |
The domain of the source. |
categories |
Array of strings which the source is categorized as. |
If no results are found, a resource_not_found error will be returned.
Example Request
GET https://api.thenewsapi.com/v1/news/uuid/147013d8-6c2c-4d50-8bad-eb3c8b7f5740?api_token=YOUR_API_TOKEN
Example Response
{
"uuid": "147013d8-6c2c-4d50-8bad-eb3c8b7f5740",
"title": "These Are The Four American Companies Worth Over $1 Trillion Each – 24",
"description": "America’s major market indexes set records in the early pa...",
"keywords": "",
"snippet": "These Are The Four American Companies Worth Over $1 Trillion...",
"url": "https://247wallst.com/investing/2020/10/17/these-are-the-four-american-companies-worth-over-1-trillion-each/",
"image_url": "https://247wallst.com/wp-content/uploads/2020/08/imageForEntry2-Qrj.jpg",
"language": "en",
"published_at": "2020-10-17T11:16:20.000000Z",
"source": "247wallst.com",
"categories": [
"business"
]
}
Sources Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/sources HTTP/1.1
Use this endpoint to sources to use in your news API requests. Note that the limit is 50 for all requests.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
HTTP GET Parameters
| name | required | description |
|---|---|---|
categories |
false | Comma separated list of categories to include
Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
page |
false | Use this to paginate through the result set. Default is 1.
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of sources found for the request. |
meta > returned |
The number of sources returned on the page. |
meta > limit |
The limit is 50. This currently can not be changed. |
meta > page |
The page number based on the page parameter. |
data > source_id |
The unique ID of the source feed. Use this for the source_ids or exclude_source_ids parameters in the news endpoints.
There may be many source_ids for each domain, therefore we would generally suggest using the domains filter instead the source_ids filter. |
data > domain |
The domain of the source. You can use this for the domains or exclude_domains parameters in the news endpoints. |
data > language |
The source language. |
data > locale |
The source locale. Note that only select sources have locales. |
data > categories |
Array of strings which the source is categorized as. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/sources?api_token=YOUR_API_TOKEN&language=en
Example Response
{
"meta": {
"found": 15453,
"returned": 50,
"limit": 50,
"page": 1
},
"data": [
{
"source_id": "arstechnica.com-1",
"domain": "arstechnica.com",
"language": "en",
"locale": null,
"categories": [
"tech"
]
},
{
"source_id": "adweek.com-1",
"domain": "adweek.com",
"language": "en",
"locale": null,
"categories": [
"business"
]
},
...
Errors
Errors
If your request was unsuccessful, you will receive a JSON formatted error. Below you will find the potential errors you may encounter when using the API.
Errors
| error code | HTTP status | description |
|---|---|---|
malformed_parameters |
400 |
Validation of parameters failed. The failed parameters are usually shown in the error message. |
invalid_api_token |
401 |
Invalid API token. |
usage_limit_reached |
402 |
Usage limit of your plan has been reached. Usage limit and remaining requests can be found on the X-UsageLimit-Limit header. |
endpoint_access_restricted |
403 |
Access to the endpoint is not available on your current subscription plan. |
resource_not_found |
404 |
Resource could not be found. |
invalid_api_endpoint |
404 |
API route does not exist. |
rate_limit_reached |
429 |
Too many requests in the past 60 seconds. Rate limit and remaining requests can be found on the X-RateLimit-Limit header. |
server_error |
500 |
A server error occured. |
maintenance_mode |
503 |
The service is currently under maintenance. |
Example Error Response
{
"error": {
"code": "malformed_parameters",
"message": "The published_before parameter(s) are incorrectly formatted."
}
}
Examples
API Examples
Our endpoints are very useful for filtering to find only specific resources you need. Follow each example request below to see how you can build dynamic queries.
Example Request 1
This is a basic request which will return all articles which match the search term "usd" within the title or body of the article:
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd
Example Request 2
This will return all articles which match the search term "usd" OR "gbp":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%7C%20gbp
Example Request 3
This will return all articles which match the search term "usd" AND "gbp":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%2B%20gbp
Example Request 4
This will return all articles which match the search term "usd" AND "gbp" but removes any articles which mentions "cad":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%2B%20gbp%20-cad
Example Request 5
This will return all articles which match the search term "forex" AND "usd" OR "gbp" but removes any articles which mentions "cad":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=forex%20%2B%20%28usd%20%7C%20gbp%29%20-cad
Example Request 6
This is the same as Example Request 5 but will also ensure the articles returned are in English and categorized by business or tech but not travel, and are published within the last week:
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=forex%20%2B%20%28usd%20%7C%20gbp%29%20-cad&language=en&categories=business%2Ctech&exclude_categories=travel&published_after=2026-04-13
Code Examples
See our prepared examples below to quickly get started implementing our API into your next project.
PHP
$queryString = http_build_query([
'api_token' => 'YOUR_API_TOKEN',
'categories' => 'business,tech',
'search' => 'apple',
'limit' => 50,
]);
$ch = curl_init(sprintf('%s?%s', 'https://api.thenewsapi.com/v1/news/all', $queryString));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($ch);
curl_close($ch);
$apiResult = json_decode($json, true);
print_r($apiResult);
Python
# Python 3
import http.client, urllib.parse
conn = http.client.HTTPSConnection('api.thenewsapi.com')
params = urllib.parse.urlencode({
'api_token': 'YOUR_API_TOKEN',
'categories': 'business,tech',
'limit': 50,
})
conn.request('GET', '/v1/news/all?{}'.format(params))
res = conn.getresponse()
data = res.read()
print(data.decode('utf-8'))
Go
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://thenewsapi.com")
baseURL.Path += "v1/news/all"
params := url.Values{}
params.Add("api_token", "YOUR_API_TOKEN")
params.Add("categories", "business,tech")
params.Add("search", "apple")
params.Add("limit", "50")
baseURL.RawQuery = params.Encode()
req, _ := http.NewRequest("GET", baseURL.String(), nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(string(body))
}
JavaScript
var requestOptions = {
method: 'GET'
};
var params = {
api_token: 'YOUR_API_TOKEN',
categories: 'business,tech',
search: 'apple',
limit: '50'
};
var esc = encodeURIComponent;
var query = Object.keys(params)
.map(function(k) {return esc(k) + '=' + esc(params[k]);})
.join('&');
fetch("https://api.thenewsapi.com/v1/news/all?" + query, requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
C#
var client = new RestClient("https://api.thenewsapi.com/v1/news/all");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddQueryParameter("api_token", "YOUR_API_TOKEN");
request.AddQueryParameter("categories", "business,tech");
request.AddQueryParameter("search", "apple");
request.AddQueryParameter("limit", "50");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
Java
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
HttpUrl.Builder httpBuilder = HttpUrl.parse("https://api.thenewsapi.com/v1/news/all").newBuilder();
httpBuilder.addQueryParameter("api_token", "YOUR_API_TOKEN");
httpBuilder.addQueryParameter("categories", "business,tech");
httpBuilder.addQueryParameter("search", "apple");
httpBuilder.addQueryParameter("limit", "50");
Request request = new Request.Builder().url(httpBuilder.build()).build();
Response response = client.newCall(request).execute();