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-02-08
|
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": "1c973d40-6fa6-4b2d-8ad9-472a5bd6b941",
"title": "How to Watch the 2026 Super Bowl Turning Point USA Halftime Show: Date, Time, Performers and More",
"description": "Want to know where you can find the alternative Turning Point USA halftime show during the 2026 Super Bowl? We'll let you know where to go",
"keywords": "",
"snippet": "The 2026 Super Bowl halftime show has become a lightning rod in America’s ongoing culture war.\n\nThe conservative activist group Turning Point USA is jumping f...",
"url": "https://www.usmagazine.com/entertainment/news/how-to-watch-the-2026-super-bowl-turning-point-usa-halftime-show-date-time-performers-and-more/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2023/04/GettyImages-2175379322-kid-rock.jpg?w=1200&h=630&crop=1&quality=86&strip=all",
"language": "en",
"published_at": "2026-02-08T09:15:09.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"locale": "us",
"similar": [
{
"uuid": "8bfcf160-c937-42ac-bd81-d4e2215c621e",
"title": "2026 Super Bowl Halftime Show: Date, Time, Performers and How to Watch",
"description": "Find out the date, time, who is performing, how to watch and everything else you need to know about the 2026 Super Bowl halftime show",
"keywords": "",
"snippet": "This weekend, the biggest cultural moment of the year (sorry, Oscars) will take place.\n\nNo, I’m not talking about the NFL championship match between the New E...",
"url": "https://www.usmagazine.com/entertainment/news/2026-super-bowl-halftime-show-date-time-performers-and-how-to-watch/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/02/Seahawks-QB-Sam-Darnold-Gives-His-Honest-Opinion-About-Bad-Bunny-Performing-Super-Bowl-60-Halftime-Show.jpg?crop=0px%2C61px%2C1999px%2C1050px&resize=1200%2C630&quality=55&strip=all",
"language": "en",
"published_at": "2026-02-08T09:45:31.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"locale": "us"
},
{
"uuid": "aad385a1-c06f-4675-8a4a-dbe900e6908d",
"title": "Will Bad Bunny be paid for his Super Bowl halftime performance?",
"description": "Here's how much Bad Bunny is expected to earn from his halftime performance at Super Bowl LX.",
"keywords": "",
"snippet": "Super Bowl LX is certain to deliver a financial win for the NFL — but not for halftime performer Bad Bunny, who will take the stage Sunday during the matchup ...",
"url": "https://www.cbsnews.com/news/super-bowl-2026-halftime-show-bad-bunny-do-performers-get-paid/",
"image_url": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/02/06/eb7b24ce-dd86-4f09-b358-f3e9595a8e14/thumbnail/1200x630g2/aeb1b686599b48d4dcb785f151fce7a0/gettyimages-2260094466.jpg",
"language": "en",
"published_at": "2026-02-08T10:00:05.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "71022960-06ff-49c4-a985-0aea7c2e81ce",
"title": "Where you can watch the 2026 Super Bowl live today",
"description": "Not sure where to watch the 2026 Super Bowl live? There are multiple ways to watch the game for free today. Here's how.",
"keywords": "Football, National Football League, Super Bowl",
"snippet": "We may receive commissions from some links to products on this page. Promotions are subject to availability and retailer terms.\n\nThe big game is finally here. I...",
"url": "https://www.cbsnews.com/news/where-to-watch-super-bowl-2026/",
"image_url": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/02/06/f8640622-5801-4464-897e-1b4e5f0ccb77/thumbnail/1200x630/a91e776486aad2a3654b5c9f23372a4e/gettyimages-2259656198.jpg",
"language": "en",
"published_at": "2026-02-08T10:00:06.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "d8601f43-6a3b-426e-9074-8bd7a956d657",
"title": "Super Bowl 60: Where to watch, kickoff time and everything you need to know",
"description": "The Seattle Seahawks and New England Patriots will go head-to-head for football glory at Super Bowl 60 on Sunday",
"keywords": "",
"snippet": "The Seattle Seahawks and New England Patriots will go head-to-head for football glory at Super Bowl 60 on Sunday.\n\nFrom kickoff time to players to watch to half...",
"url": "https://www.nbcnews.com/sports/nfl/2026-super-bowl-watch-time-everything-need-know-rcna257967",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-02/260207-super-bowl-lx-ww-1815-cb54aa.jpg",
"language": "en",
"published_at": "2026-02-08T10:00:40.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "f11f33ca-e7db-4c52-a269-f3b2b66b1125",
"title": "Bad Bunny's Super Bowl halftime show role breaks barriers and sparks debate",
"description": "Reactions poured in when Bad Bunny was named Super Bowl halftime headliner, with some praising and others criticizing the choice.",
"keywords": "Music, Bad Bunny",
"snippet": "A week after his \"ICE out\" declaration dominated Grammy headlines, anticipation is building over whether Bad Bunny will turn the biggest performance of his care...",
"url": "https://www.cbsnews.com/news/bad-bunny-super-bowl-halftime-show-cultural-impact/",
"image_url": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/02/06/4b1761f4-ccbd-4c33-a804-f070cf3374f7/thumbnail/1200x630/c71a7a2b4981876d22ae0f1e95189727/gettyimages-2149763256.jpg",
"language": "en",
"published_at": "2026-02-08T12:00:19.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
},
{
"uuid": "e8a96397-f7f2-46e8-9544-50b180fa33b4",
"title": "Lindsey Vonn Crashes, Airlifted Off Mountain in Shocking Olympics 2026 Moment",
"description": "Lindsey Vonn had to be airlifted off the slopes during the women’s downhill event at the 2026 Olympics following a devastating crash.",
"keywords": "",
"snippet": "Watch : Lindsey Vonn Plans to Compete in Winter Olympics With Ruptured ACL\n\nLindsey Vonn’s return to the Olympics didn’t go as planned.\n\nWhen the alpine ski...",
"url": "https://www.eonline.com/news/1428329/lindsey-vonn-crashes-at-olympics-2026?cmpid=rss-syndicate-genericrss-us-top_stories",
"image_url": "https://akns-images.eonline.com/eol_images/Entire_Site/20260208/14d49b51-7b15-4b7c-aa5e-317b349eaedd_1770558254.jpg?fit=around%7C1080:1080&output-quality=90&crop=1080:1080;center,top",
"language": "en",
"published_at": "2026-02-08T13:57:16.000000Z",
"source": "eonline.com",
"categories": [
"entertainment",
"general"
],
"locale": "us",
"similar": [
{
"uuid": "2293098c-dcc3-49a7-a6f6-231e524d0729",
"title": "2026 Winter Olympics: Follow live updates from Milan",
"description": "The 2026 Milan Cortina Olympics continue. Follow along live with the top highlights from Sunday, which include women's downhill skiing, figure skating's team event and more.",
"keywords": "",
"snippet": "Open Extended Reactions\n\nThe 2026 Milan Cortina Olympics continue Sunday with the return of a legend.\n\nJust days after a devastating knee injury which saw her c...",
"url": "https://www.espn.com/olympics/story/_/id/47861284/2026-milan-cortina-italy-winter-olympics-best-moments-sunday",
"image_url": "https://a2.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0207%2Fr1611856_1296x729_16%2D9.jpg",
"language": "en",
"published_at": "2026-02-08T05:18:04.000000Z",
"source": "espn.com",
"categories": [
"sports",
"general"
],
"locale": "us"
},
{
"uuid": "614a1323-3a37-4d05-8303-fd96c92e649a",
"title": "Lindsey Vonn Crashes, Heard Screaming in Pain at 2026 Olympics After ACL Tear",
"description": "Team USA's Lindsey Vonn was airlifted off the course after crashing just 13 seconds into her women's downhill run on Sunday, February 8",
"keywords": "",
"snippet": "Lindsey Vonn’s heroic attempt at Olympics immortality ended in devastating agony.\n\nVonn, 41, crashed during her women’s downhill run at the 2026 Winter Olym...",
"url": "https://www.usmagazine.com/entertainment/news/lindsey-vonn-crashes-heard-screaming-in-pain-at-2026-olympics-after-acl-tear/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/02/GettyImages-2259737813-Lindsey-Vonn-February-2026.jpg?crop=359px%2C8px%2C1641px%2C861px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2026-02-08T11:45:30.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"locale": "us"
},
{
"uuid": "11a12c52-1e52-4020-ac11-24f6318ad878",
"title": "Breezy Johnson notches Team USA's first gold medal at 2026 Winter Olympics",
"description": "Breezy Johnson was the top skier in the alpine skiing women's downhill event at the 2026 Winter Olympics and gave Team USA its first gold medal.",
"keywords": "",
"snippet": "NEW You can now listen to Fox News articles!\n\nBreezy Johnson put Team USA on the board Sunday when she won a gold medal in the alpine skiing women’s downhill ...",
"url": "https://www.foxnews.com/sports/breezy-johnson-notches-team-usas-first-gold-medal-2026-winter-olympics",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/02/olympics-breezy-johnson-020826-3.jpg",
"language": "en",
"published_at": "2026-02-08T12:25:21.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "410e374f-249e-4f53-b423-05043c98d213",
"title": "Lindsey Vonn crashes in Olympic downhill, taken away by helicopter as US teammate Johnson wins gold",
"description": "Lindsey Vonn's pursuit of a second Olympic downhill gold medal is over. The 41-year-old American, skiing with a badly injured left knee, crashed early in Sunday's race in Italy.",
"keywords": "Lindsey Vonn, Olympic games, General news, Send to Apple News, 2026 Winter Olympics, AP Top News, Snoop Dogg, Alpine skiing, Johan Eliasch, Sofia Goggia, 2026 Milan Cortina Olympic Games, Alan Kildow, Sports, World news, Italy, Emma Aicher, Olympia, World News",
"snippet": "Add AP News as your preferred source to see more of our stories on Google.\n\nAdd AP News on Google Add AP News as your preferred source to see more of our storie...",
"url": "https://apnews.com/article/lindsey-vonn-milan-cortina-olympics-90b10c0a145053f3bbfb573c4024653a",
"image_url": "https://dims.apnews.com/dims4/default/993b660/2147483647/strip/true/crop/1965x1309+0+0/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F9a%2F04%2F8bf58687ea899d1ac403a54c25c4%2Fcf7f1a1230964a7892fbb90a027f5b35",
"language": "en",
"published_at": "2026-02-08T12:23:02.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "8e3eb534-323a-457f-ac13-2ec486dace51",
"title": "Breezy Johnson wins Olympic downhill gold medal, joining Lindsey Vonn as only Americans to accomplish feat",
"description": "Breezy Johnson became the second American woman ever to win the Olympic gold medal in downhill skiing Sunday, hours after the first person to accomplish the feat, Lindsey Vonn, crashed violently on the famed Tofane course.",
"keywords": "",
"snippet": "MILAN — Breezy Johnson became the second American woman ever to win the Olympic gold medal in downhill skiing Sunday, hours after the first person to accompli...",
"url": "https://www.nbcnews.com/sports/olympics/breezy-johnson-wins-olympics-gold-milan-cortina-rcna258003",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-02/260208-breezy-johnson-mb-1305-b300f6.jpg",
"language": "en",
"published_at": "2026-02-08T12:34:04.000000Z",
"source": "nbcnews.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-02-08T14:33:36 |
2026-02-08T14:33 |
2026-02-08T14 |
2026-02-08 |
2026-02 |
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-02-08T14:33:36 |
2026-02-08T14:33 |
2026-02-08T14 |
2026-02-08 |
2026-02 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-02-08
|
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": 1544554,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "c84a1330-36d8-45cb-a32c-e8d84fadbf23",
"title": "Los Angeles Dodgers World Series Champs Share Their Super Bowl Predictions",
"description": "Will Smith, Mookie Betts, Tyler Glasnow and more Los Angeles Dodgers World Series champions predict the winner of Super Bowl 2026",
"keywords": "",
"snippet": "Super Bowl 2026 is finally here, and it’s not too late to place your bets on who’s going to come out on top.\n\nOn Sunday, February 8, the Seattle Seahawks wi...",
"url": "https://www.usmagazine.com/entertainment/news/los-angeles-dodgers-world-series-champs-share-their-super-bowl-predictions/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/02/will-smith-tyler-glasnow-chris-taylor_40ed21.jpg?w=1200&h=630&crop=1&quality=86&strip=all",
"language": "en",
"published_at": "2026-02-08T14:15:44.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "803639f4-1c82-4c7c-9057-0216ac414873",
"title": "Prime Video’s Best Comedy Show Is Returning in 2026 — Here’s Why You Should Watch It",
"description": "Prime Video's best sitcom is making its season 2 return this March. We break down why you need to watch 'Jury Duty' if you haven't already",
"keywords": "",
"snippet": "Amazon Prime Video’s 2023 breakout Jury Duty returns for a brand-new season this March — but if you haven’t already checked it out, what have you been doi...",
"url": "https://www.usmagazine.com/entertainment/news/prime-videos-best-comedy-show-is-returning-in-2026-heres-why-you-should-watch-it/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/02/jury-duty-1.jpg?crop=0px%2C47px%2C1852px%2C974px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2026-02-08T14:05:10.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "e020e4ef-f2ff-4a29-82d1-9da0f2cf4c07",
"title": "Section 230 turns 30 as it faces its biggest tests yet",
"description": "Tech’s legal liability shield, Section 230, has survived 30 years of attacks, but it is about to face a series of major court challenges.",
"keywords": "",
"snippet": "Thirty years ago today, Section 230 of the Communications Decency Act, a bill credited with creating the groundwork for the modern internet, became law and set ...",
"url": "https://www.theverge.com/policy/875300/section-230-turns-30-social-media-addiction-cases-sunset",
"image_url": "https://platform.theverge.com/wp-content/uploads/sites/2/2025/09/STKS519_FREE_SPEECH_CVIRGINIA_E.jpg?quality=90&strip=all&crop=0%2C10.732984293194%2C100%2C78.534031413613&w=1200",
"language": "en",
"published_at": "2026-02-08T14:03:04.000000Z",
"source": "theverge.com",
"categories": [
"tech"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "93c4d1de-1574-4f86-acf8-340626dd15f7",
"title": "Ledecka's quest for Olympic snowboarding 3-peat grinds to a halt",
"description": "Ester Ledecka's quest to become the first snowboarder to win gold medals in three straight Olympics came to a surprisingly early end when she lost her quarterf...",
"keywords": "",
"snippet": "Open Extended Reactions\n\nLIVIGNO, Italy -- Ester Ledecka's quest to become the first snowboarder to win gold medals in three straight Olympics came to a surpris...",
"url": "https://www.espn.com/olympics/story/_/id/47866379/ledecka-quest-olympic-snowboarding-3-peat-comes-shocking-halt",
"image_url": "https://a.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0208%2Fr1612113_1296x729_16%2D9.jpg",
"language": "en",
"published_at": "2026-02-08T14:01:18.000000Z",
"source": "espn.com",
"categories": [
"sports",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "53853222-9938-4469-b8c7-cd6b06e950f3",
"title": "Puppy Bowl Ref Dan Schachner Adopted His Own Dog From the Event (Excl)",
"description": "Puppy Bowl referee Dan Schachner exclusively spoke to Us Weekly about adopting his own dog from the event ahead of the 2026 game",
"keywords": "",
"snippet": "Puppy Bowl’s Dan Schachner meets tons of adorable dogs every year in his role as the event’s official referee, but so far only one pooch has fully stolen hi...",
"url": "https://www.usmagazine.com/entertainment/news/puppy-bowl-ref-dan-schachner-adopted-his-own-dog-from-the-event-excl/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/02/Puppy-Bowl-Ref-Dan-Schachner-Adopted-His-Own-Dog-From-the-Event-GettyImages-2259790145.jpg?crop=0px%2C326px%2C1333px%2C700px&resize=1200%2C630&quality=40&strip=all",
"language": "en",
"published_at": "2026-02-08T14:00:42.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "f4dfa21c-a834-4f73-b514-a4b94cccff54",
"title": "How online sports betting targets Black communities",
"description": "As Super Bowl betting surges, unchecked gambling platforms deepen existing inequities",
"keywords": "",
"snippet": "In 2013, Eddie Roberson and Talif Crowley, two Black New Jersey residents, made a bet on the outcome of the Super Bowl game between the San Francisco 49ers and ...",
"url": "https://www.salon.com/2026/02/08/how-online-sports-betting-targets-black-communities/",
"image_url": "https://www.salon.com/app/uploads/2026/02/Sports-Betting-2155209951.jpg",
"language": "en",
"published_at": "2026-02-08T14:00:02.000000Z",
"source": "salon.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "18ce1190-61d1-4d75-b341-9f93a3e80214",
"title": "DSW's Nike Sneaker Deals Start at $60, Perfect for Spring Workouts",
"description": "We just found so many Nike sneakers under $85 at DSW. But you'd better run and grab them now while you still can!",
"keywords": "",
"snippet": "If your favorite kicks have seen better days, we just found some really good Nike sneaker deals at DSW that you need to know about!\n\nThe sporty brand has so man...",
"url": "https://www.eonline.com/news/1428313/best-nike-womens-sneaker-deals-at-dsw?cmpid=rss-syndicate-genericrss-us-top_stories",
"image_url": "https://akns-images.eonline.com/eol_images/Entire_Site/20260206/1683c92a-fc81-4417-ba93-e233a772015a_1770420569.jpg?fit=around%7C1080:1080&output-quality=90&crop=1080:1080;center,top",
"language": "en",
"published_at": "2026-02-08T14:00:00.000000Z",
"source": "eonline.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "a028793c-bcf3-48da-80f0-71523ea81aa0",
"title": "Why Taylor Swift Has Never Headlined the Super Bowl Halftime Show",
"description": "Taylor Swift wasn't destined to take the field for the 2026 Super Bowl Halftime Show. But once her tight end fiancé Travis Kelce retires, she could be persuade...",
"keywords": "",
"snippet": "Watch : Why Taylor Swift Has Never Headlined the Super Bowl Halftime Show\n\nTaylor Swift added sports media darling/antihero to her overflowing well of accomplis...",
"url": "https://www.eonline.com/news/1421527/taylor-swift-skipping-super-bowl-halftime-show-explained?cmpid=rss-syndicate-genericrss-us-top_stories",
"image_url": "https://akns-images.eonline.com/eol_images/Entire_Site/20250822/a81e2e2b-e522-4a4a-b3cb-16945f9e2a89_1755882567.jpg?fit=around%7C1080:1080&output-quality=90&crop=1080:1080;center,top",
"language": "en",
"published_at": "2026-02-08T14:00:00.000000Z",
"source": "eonline.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "e8a96397-f7f2-46e8-9544-50b180fa33b4",
"title": "Lindsey Vonn Crashes, Airlifted Off Mountain in Shocking Olympics 2026 Moment",
"description": "Lindsey Vonn had to be airlifted off the slopes during the women’s downhill event at the 2026 Olympics following a devastating crash.",
"keywords": "",
"snippet": "Watch : Lindsey Vonn Plans to Compete in Winter Olympics With Ruptured ACL\n\nLindsey Vonn’s return to the Olympics didn’t go as planned.\n\nWhen the alpine ski...",
"url": "https://www.eonline.com/news/1428329/lindsey-vonn-crashes-at-olympics-2026?cmpid=rss-syndicate-genericrss-us-top_stories",
"image_url": "https://akns-images.eonline.com/eol_images/Entire_Site/20260208/14d49b51-7b15-4b7c-aa5e-317b349eaedd_1770558254.jpg?fit=around%7C1080:1080&output-quality=90&crop=1080:1080;center,top",
"language": "en",
"published_at": "2026-02-08T13:57:16.000000Z",
"source": "eonline.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "7a628fa5-c291-47e4-810f-f1e221cbefb9",
"title": "Let Trump Keep Building Monuments to Himself",
"description": "The president’s penchant for gilded statues and self-glorification might at least help clarify the nature of his leadership.",
"keywords": "",
"snippet": "Donald Trump’s supporters really need to think bigger. A 15-foot-tall golden sculpture of the president—“Don Colossus” to friends—has recently been co...",
"url": "https://www.theatlantic.com/culture/2026/02/let-trump-keep-building-monuments-to-himself/685903/",
"image_url": "https://cdn.theatlantic.com/thumbor/AAkSm_GFfF88jY2otbcIOZiMbWc=/0x61:2877x1559/1200x625/media/img/mt/2026/02/20260205_trump_statue/original.jpg",
"language": "en",
"published_at": "2026-02-08T13:53:05.000000Z",
"source": "theatlantic.com",
"categories": [
"general",
"entertainment",
"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-02-08T14:33:36 |
2026-02-08T14:33 |
2026-02-08T14 |
2026-02-08 |
2026-02 |
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-02-08T14:33:36 |
2026-02-08T14:33 |
2026-02-08T14 |
2026-02-08 |
2026-02 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-02-08
|
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": 53842707,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "c3fef9a8-e3c1-46d2-847c-bf0672de095e",
"title": "Pré-Carnaval causa interdições em vias movimentadas de SP neste domingo",
"description": "Veja as principais notícias e manchetes do dia no Brasil e no Mundo. Leia textos e assista a vídeos de Política, Cotidiano, Crimes e mais.",
"keywords": "",
"snippet": "O DJ escocês Calvin Harris estreia nos blocos de São Paulo, na Consolação, a partir das 11h Imagem: Mona @monaelieu | Reprodução/Instagram @calvinharris\n\n...",
"url": "https://noticias.uol.com.br/cotidiano/ultimas-noticias/2026/02/07/pre-carnaval-causa-interdicoes-em-vias-movimentadas-de-sp-neste-domingo.htm",
"image_url": "https://conteudo.imguol.com.br/c/splash/d8/2026/02/07/bloco-casa-comigo-bloco-paulistano-celebra-13-anos-com-o-tema-carnaval-de-cinema-1770481947029_v2_615x300.jpg",
"language": "pt",
"published_at": "2026-02-08T14:33:47.000000Z",
"source": "uol.com.br",
"categories": [
"tech",
"science"
],
"relevance_score": null
},
{
"uuid": "25673b61-b232-4aa9-8696-f0c7d3a7d630",
"title": "한국 정신의학의 발자취, ‘복원_기억의 지층 위에서’ 특별 사진전 개최",
"description": "[뉴스데일리]보건복지부 국립정신건강센터(남윤영 국립정신건강센터장 직무대리)는 개원 64주년*을 맞이하여 2월 9일(월)...",
"keywords": "",
"snippet": "[뉴스데일리]보건복지부 국립정신건강센터(남윤영 국립정신건강센터장 직무대리)는 개원 64주년*을 맞이하여 2월 9일(월)...",
"url": "http://www.newsdaily.kr/news/articleView.html?idxno=254481",
"image_url": "https://cdn.newsdaily.kr/news/thumbnail/202602/254481_168537_3215_v150.jpg",
"language": "ko",
"published_at": "2026-02-08T14:33:11.000000Z",
"source": "newsdaily.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "3d05b901-c6a4-4c27-82f2-1819db76d6c4",
"title": "이문구 기념사업회 출범… 보령의 문인 유산 잇는다",
"description": "［중부매일 서성원 기자］ 보령 관촌 출신으로 한국 현대문학을 대표하는 소설가 이문구를 기리는 기념사업회가 공식 ?...",
"keywords": "이문구, 보령",
"snippet": "▲ 지난 4일 보령시 원도심 어울림센터에서 시민을 비롯해 서울·대전·천안 등지에서 모인 소설가와 시인, 독자 등 50여 ?...",
"url": "https://www.jbnews.com/news/articleView.html?idxno=1498563",
"image_url": "https://cdn.jbnews.com/news/thumbnail/202602/1498563_1346320_3503_v150.jpg",
"language": "ko",
"published_at": "2026-02-08T14:33:06.000000Z",
"source": "jbnews.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "cbf63081-e14c-441d-9afd-49b769cfba38",
"title": "Bitcoin Falls to $34,000? Experts Say the Ultimate Winners Are Long Term Holders",
"description": "Bitcoin(BTC)Bitcoin(BTC)istestingits200-weekmovingaverageamidanunprecedentedcapitulation,standingatacrossroadsbetweenagenerationalbuyingopportunityandfurthercol...",
"keywords": "",
"snippet": "▲ Bitcoin (BTC)\n\nBitcoin (BTC) is testing its 200-week moving average amid an unprecedented capitulation, standing at a crossroads between a generational buyi...",
"url": "https://www.coinreaders.com/214376",
"image_url": "https://www.coinreaders.com/imgdata/coinreaders_com/202508/800_533_202508195137320.png",
"language": "ko",
"published_at": "2026-02-08T14:32:57.000000Z",
"source": "coinreaders.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "b2a54eb7-4128-4f38-a142-e4dd6046552a",
"title": "영양, 정선서 다문화 가족 스키캠프 운영",
"description": "경북 영양군은 지난 6일까지 2박 3일간 강원도 정선군 하이원리조트에서 ‘2026년 영양군 다문화가족 스키캠프’를 개최?...",
"keywords": "",
"snippet": "일상 스트레스 해소·가족 간 유대감 강화\n\n[사진=영양군]\n\n경북 영양군은 지난 6일까지 2박 3일간 강원도 정선군 하이원리...",
"url": "http://www.shinailbo.co.kr/news/articleView.html?idxno=2189297",
"image_url": "http://www.shinailbo.co.kr/news/thumbnail/202602/2189297_1283468_3150_v150.jpg",
"language": "ko",
"published_at": "2026-02-08T14:32:03.000000Z",
"source": "shinailbo.co.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "155f3dd2-70cb-4009-8f31-30b0a9093ca9",
"title": "60조 비트코인 오지급…빗썸, 결국 회사 돈으로 메웠다",
"description": "빗썸_국문BI © 빗썸이최근발생한비트코인(BTC)오지급사고관련,2026년2월7일22시45분기준고객자산정합성확보를완료하고?...",
"keywords": "",
"snippet": "",
"url": "https://www.coinreaders.com/214375",
"image_url": "https://www.coinreaders.com/imgdata/coinreaders_com/202512/800_400_2025120113104941.jpg",
"language": "ko",
"published_at": "2026-02-08T14:32:00.000000Z",
"source": "coinreaders.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "eece7b60-7170-4d7d-a594-9223ca220dc4",
"title": "진주시, '마약 퇴치 합동 추진단' 출범",
"description": "진주시가 건강하고 안전한 도시를 조성하고자 불법 마약류 퇴치를 위한 적극적인 대응에 나섰다.시는 불법 마약류 확산?...",
"keywords": "",
"snippet": "합동 캠페인, 맞춤형 예방 교육 등 체계적 대응으로 불법 마약 퇴치 나서\n\n마약퇴치 합동추진단 출범 / 진주시\n\n진주시가 ...",
"url": "http://www.shinailbo.co.kr/news/articleView.html?idxno=2189241",
"image_url": "http://www.shinailbo.co.kr/news/thumbnail/202602/2189241_1283422_5444_v150.jpg",
"language": "ko",
"published_at": "2026-02-08T14:31:48.000000Z",
"source": "shinailbo.co.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "399e190c-0648-4291-ba46-ab60b704ab14",
"title": "날뛰는 트럼프, 무너지는 미국",
"description": "트럼프가 미국 대통령에 다시 당선되면서 세계가 혼돈에 빠졌다. 쇠락하는 미국을 되살리겠다며 막무가내로 관세를 올?...",
"keywords": "",
"snippet": "이정덕 전북대 교수\n\n트럼프가 미국 대통령에 다시 당선되면서 세계가 혼돈에 빠졌다. 쇠락하는 미국을 되살리겠다며 막...",
"url": "http://www.domin.co.kr/news/articleView.html?idxno=1545037",
"image_url": "http://www.domin.co.kr/news/thumbnail/202602/1545037_748313_3133_v150.jpg",
"language": "ko",
"published_at": "2026-02-08T14:31:40.000000Z",
"source": "domin.co.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "581db129-2815-4999-8c6a-a3346eb11792",
"title": "청송, 사계절 머무는 힐링도시 만든다",
"description": "경북 청송군은 올해 다양한 관광정책을 본격 추진해 ‘자연과 관광이 공존하는 힐링 관광거점도시’ 조성에 박차를 가?...",
"keywords": "",
"snippet": "문화·자연이 어우러진 다양한 관광정책 추진\n\n경북 청송군은 올해 다양한 관광정책을 본격 추진해 ‘자연과 관광이 공?...",
"url": "http://www.shinailbo.co.kr/news/articleView.html?idxno=2189295",
"image_url": "http://www.shinailbo.co.kr/image/logo/snslogo_20210310015526.jpg",
"language": "ko",
"published_at": "2026-02-08T14:30:56.000000Z",
"source": "shinailbo.co.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "3826e6ff-6352-4584-8dc6-a17270a93712",
"title": "조계종 명예원로의원 송암당 혜승대종사 원적 - 불교신문",
"description": "조계종 명예원로의원 송암당 혜승대종사가 2월7일 밤 11시45분 원적에 들었다. 법랍 71년, 세수 91세.장례는 조계종 원로회?...",
"keywords": "",
"snippet": "조계종 명예원로의원 송암당 혜승대종사.\n\n조계종 명예원로의원 송암당 혜승대종사가 2월7일 밤 11시45분 원적에 들었다. ...",
"url": "http://www.ibulgyo.com/news/articleView.html?idxno=435411",
"image_url": "https://cdn.ibulgyo.com/news/thumbnail/202602/435411_464489_2824_v150.jpg",
"language": "ko",
"published_at": "2026-02-08T14:30:49.000000Z",
"source": "ibulgyo.com",
"categories": [],
"relevance_score": null
}
]
}
Similar News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/similar/uuid HTTP/1.1
Use this endpoint to find similar stories to a specific article based on its UUID.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-02-08T14:33:36 |
2026-02-08T14:33 |
2026-02-08T14 |
2026-02-08 |
2026-02 |
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-02-08T14:33:36 |
2026-02-08T14:33 |
2026-02-08T14 |
2026-02-08 |
2026-02 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-02-08
|
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-02-01
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();