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-06-12
|
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": "44e3a646-4ffe-4830-a2a3-c7131561b059",
"title": "Visualizing a trillion in charts and graphics as Musk nears trillionaire status",
"description": "Elon Musk, currently worth $696 billion, is poised to become the world’s first trillionaire when SpaceX goes public Friday. Here’s how to visualize that level of wealth in charts and graphics.",
"keywords": "",
"snippet": "While SpaceX may stand out against historical benchmarks, the rapid growth of AI rivals OpenAI and Anthropic, each with a valuation hovering around $900 billion...",
"url": "https://www.nbcnews.com/data-graphics/visualizing-trillion-charts-graphics-musk-nears-trillionaire-status-rcna349018",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-06/20260611-trillion-explaination-cover-2x1-jz-6c33dd.png",
"language": "en",
"published_at": "2026-06-12T09:00:00.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "6c5fc4ec-a779-4f2b-a7ff-ca70db30770a",
"title": "SpaceX's Gwynne Shotwell says IPO is one small step in 'very futuristic' journey",
"description": "Gwynne Shotwell, long Elon Musk's second-in-command at SpaceX, spoke exclusively with CNBC ahead of her company's highly anticipated IPO.",
"keywords": "Technology, Business, Social media, Breaking News: Technology, Elon Musk, Elon Musk, Jeff Bezos, Jeff Bezos, IPO, Autos, Space Exploration Technologies Corp, Gwynne Shotwell, Tesla Inc, Procure Space ETF, State Street SPDR S&P Kensho Final Frontiers ETF, Intel Corp, Alphabet Class A, EchoStar Corp, SPDR S&P Aerospace & Defense ETF, iShares U.S. Aerospace & Defense ETF, State Street Financial Select Sector SPDR ETF, Meta Platforms Inc, Broadcom Inc, Planet Labs PBC, Union Pacific Corp, business news",
"snippet": "In this article SPCX Follow your favorite stocks CREATE FREE ACCOUNT\n\nwatch now\n\nSpaceX didn't just rewrite the playbook for aerospace and defense, it helped bi...",
"url": "https://www.cnbc.com/2026/06/12/spacex-coo-gwynne-shotwell-spcx-ipo.html",
"image_url": "https://image.cnbcfm.com/api/v1/image/108320427-1781196078851-SG_Shotwell_2.jpg?v=1781196230&w=1920&h=1080",
"language": "en",
"published_at": "2026-06-12T09:14:13.000000Z",
"source": "cnbc.com",
"categories": [
"general",
"business"
],
"locale": "us"
},
{
"uuid": "a453b8f6-3f4a-481c-821e-6c4c367a29f0",
"title": "Elon Musk could become the world’s first trillionaire with SpaceX’s IPO",
"description": "Elon Musk is set to become the world's first trillionaire Friday by selling shares in his rocket company in likely the biggest stock debut ever.",
"keywords": "Tesla, Inc., Anthropic PBC, OpenAI Inc, SpaceX, Elon Musk, Aerospace and defense industry, General news, AP Top News, Business, Technology, U.S. news, PayPal Holdings, Inc., Donald Trump, Stan Choe, IPOs, Stocks and bonds, Artificial intelligence, U.S. 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/musk-spacex-tesla-ipo-trillionaire-billionaire-worth-rockets-7723f82b6063a9a17c194e25982cd66d",
"image_url": "https://dims.apnews.com/dims4/default/613066b/2147483647/strip/true/crop/1519x1012+0+0/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fde%2F1f%2Faf2d341c60116187e03dfa6e1939%2Fffba975980904a96ab2dd05a1310409a",
"language": "en",
"published_at": "2026-06-12T11:23:01.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "6a337a4e-2090-44dc-ab48-d2ca14b533e2",
"title": "Elon Musk becomes the world's first trillionaire with SpaceX's IPO",
"description": "The SpaceX CEO's fortune on paper now rivals the annual economic output of many countries, according to World Bank data.",
"keywords": "Elon Musk, SpaceX",
"snippet": "Elon Musk has become the first person to cross the trillionaire threshold, at least on paper, after SpaceX priced its blockbuster initial public offering at $13...",
"url": "https://www.cbsnews.com/news/elon-musk-spacex-ipo-trillionaire-wealth/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/02/03/727e58a0-bb5c-4717-9e7f-7cea1cec2bd0/thumbnail/1200x630/b213b2963bd736c125ccd99f1d7dbd7f/cbsn-fusion-french-authorities-raid-paris-x-office-and-summon-elon-musk-to-appear-for-questioning-thumbnail.jpg",
"language": "en",
"published_at": "2026-06-12T12:11:49.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "b788b644-76f7-4f72-a1e0-61c9e3ab4f7c",
"title": "SpaceX set to begin trading after raising $75 billion in record IPO",
"description": "Investors will get their first chance to trade shares of Elon Musk's space company after the market opens at 9:30 a.m. ET.",
"keywords": "Starlink, Elon Musk, Artificial Intelligence, Satellite, SpaceX",
"snippet": "SpaceX is set to begin trading Friday after completing the largest initial public offering in history, marking the long-awaited Wall Street debut of Elon Musk's...",
"url": "https://www.cbsnews.com/news/spacex-stock-price-ipo-spcx-initial-public-offering/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/06/11/aadf0ef6-4783-4129-80ab-6532cd81cb25/thumbnail/1200x630/a946b013046122007c4763ab79410c3c/gettyimages-2281037300.jpg",
"language": "en",
"published_at": "2026-06-12T13:06:10.000000Z",
"source": "cbsnews.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "c255dac1-912c-462c-9454-34eaf9d7dd06",
"title": "Did Elon Musk, the world's first trillionaire, overvalue SpaceX?",
"description": "Elon Musk's SpaceX will soon be a publicly traded company, and Americans are weighing the risk of investing in the revolutionary company. Puck's William Cohan joins CBS News with more insight.",
"keywords": "Elon Musk, SpaceX",
"snippet": "Did Elon Musk, the world's first trillionaire, overvalue SpaceX? Elon Musk's SpaceX will soon be a publicly traded company, and Americans are weighing the risk ...",
"url": "https://www.cbsnews.com/video/did-elon-musk-the-worlds-first-trillionaire-overvalue-spacex/",
"image_url": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/06/12/0305cab7-0e51-4e42-88d5-6f91e6a6091f/thumbnail/1200x630/a0c7da1a09cbd20d6a9bb049dce652ee/cbsn-fusion-did-elon-musk-the-worlds-first-trillionaire-overvalue-spacex-thumbnail.jpg",
"language": "en",
"published_at": "2026-06-12T12:50:59.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
},
{
"uuid": "bdccbbe9-6338-4d4b-b782-ab46560aae24",
"title": "Empty seats seen at World Cup game after controversy over ticket prices",
"description": "FIFA reported a near-capacity crowd in Guadalajara, Mexico, but images showed large pockets of unoccupied seats.",
"keywords": "Empty seats, World Cup, ticket prices, South Korea, 2022 World Cup, Czech Republic, Mexico, FIFA, the tournament, Football Supporters Europe, Mexico, South Africa, Canada",
"snippet": "Swaths of empty seats visible during Thursday's World Cup match between South Korea and the Czech Republic have raised questions over FIFA's approach to record ...",
"url": "https://www.yahoo.com/news/world/article/empty-seats-seen-at-world-cup-game-after-controversy-over-ticket-prices-105442690.html",
"image_url": "https://s.yimg.com/ny/api/res/1.2/rlUQ2eXuCoMEVWbXxSz2jw--/YXBwaWQ9aGlnaGxhbmRlcjt3PTEyMDA7aD04MDA7Y2Y9d2VicA--/https://s.yimg.com/os/creatr-uploaded-images/2026-06/a98c6d30-662d-11f1-bdfc-5d861243ddc1",
"language": "en",
"published_at": "2026-06-12T10:54:42.000000Z",
"source": "yahoo.com",
"categories": [
"general",
"business",
"sports",
"entertainment"
],
"locale": "us",
"similar": [
{
"uuid": "e00974f3-f403-43ce-8dad-c5c5f1de0da5",
"title": "Empty seats on World Cup’s opening day renew ticket price concerns",
"description": "The World Cup opened with jubilation in Mexico City as a packed stadium roared the hosts to victory.",
"keywords": "",
"snippet": "The World Cup opened with jubilation in Mexico City as a packed stadium roared the hosts to victory. But the second game of the tournament saw empty seats visib...",
"url": "https://www.nbcnews.com/sports/soccer/empty-seats-world-cups-opening-day-renew-ticket-price-concerns-rcna349748",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-06/260612-fifa-rs-3b68ad.jpg",
"language": "en",
"published_at": "2026-06-12T10:31:48.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "dc0aa821-9426-4c40-98ba-43c416a86fea",
"title": "‘Captain America’ Christian Pulisic has played under pressure before, but nothing like this World Cup",
"description": "Pulisic, the face of the U.S. men’s national team, talks about feeling pressure to deliver World Cup success on home soil.",
"keywords": "",
"snippet": "When the U.S. men’s national team opens its World Cup bid on Friday in Los Angeles, all eyes will be on Christian Pulisic. The 27-year-old star is widely cons...",
"url": "https://www.nbcnews.com/sports/soccer/captain-america-christian-pulisic-played-pressure-nothing-world-cup-rcna347197",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-06/260610-Christian-Pulisic-vl-129p-aa8758.jpg",
"language": "en",
"published_at": "2026-06-12T10:04:40.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "d538c1f7-23f4-45d9-b1e3-822423760a7a",
"title": "Iran-linked group claims hack of FBI drones, threatens World Cup, monitor says",
"description": "An Iran-linked hacker group claims to have breached FBI drones and has threatened to target the World Cup, a monitoring group says. The monitor disputes some of the other group's claims.",
"keywords": "Iran, World Cup",
"snippet": "An Iran-linked hacker group claims to have breached FBI drones and has threatened to target the World Cup that kicked off on Thursday, a monitoring group said F...",
"url": "https://www.cbsnews.com/news/iran-linked-group-hack-fbi-drones-world-cup/",
"image_url": "https://assets1.cbsnewsstatic.com/hub/i/r/2018/09/26/e2d69c61-8ebb-4841-9196-6dc6681e15ab/thumbnail/1200x630/f13495026ca3a05c7964ebedaaccac3b/gettyimages-917611366.jpg",
"language": "en",
"published_at": "2026-06-12T11:38:32.000000Z",
"source": "cbsnews.com",
"categories": [
"general"
],
"locale": "us"
}
]
}
],
"business": ...,
"sports": ...,
"tech": ...,
"science": ...,
"health": ...
}
}
Top Stories Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/top HTTP/1.1
Use this endpoint to find live and historical top stories around the world or filter to get only top stories for specific countries. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
locale |
false | Comma separated list of country codes to include in the result set. Default is all countries.
Click here for a list of supported countries.
Example: us,ca (US + Canada).
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-06-12T14:54:20 |
2026-06-12T14:54 |
2026-06-12T14 |
2026-06-12 |
2026-06 |
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-06-12T14:54:20 |
2026-06-12T14:54 |
2026-06-12T14 |
2026-06-12 |
2026-06 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-06-12
|
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": 1643487,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "74cf29da-f7a1-4cee-9f53-2484ddc043d0",
"title": "Tim Allen Says He \"Never Really Wanted to Be a Dad\" Before Welcoming Daughters",
"description": "Tim Allen reflected on his decision to welcome kids after initially being apprehensive about stepping into fatherhood: \"It was a work in progress.\"",
"keywords": "",
"snippet": "Watch : Tim Allen Reveals His and 'Toy Story 5' Costar Tom Hanks' Text Chain\n\nTim Allen wasn't so sure he had a dad in him.\n\nIn fact, the Toy Story 5 actor admi...",
"url": "https://www.eonline.com/news/1432918/tim-allen-never-wanted-to-be-a-dad-before-daughters-katherine-elizabeth?cmpid=rss-syndicate-genericrss-us-top_stories",
"image_url": "https://akns-images.eonline.com/eol_images/Entire_Site/20260612/8e71c33f-5252-4682-8c35-8d28212cfb94_1781274566.jpg?fit=around%7C1080:1080&output-quality=90&crop=1080:1080;center,top",
"language": "en",
"published_at": "2026-06-12T14:31:29.000000Z",
"source": "eonline.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "2734cf2d-f4fd-4ebc-b015-a5d796ecfbea",
"title": "Jeff Bezos’ AI startup aims to build an ‘artificial general engineer’",
"description": "Jeff Bezos revealed that his Prometheus AI startup aims to build an “artificial general engineer.” The startup will focus on building AI-powered tools to he...",
"keywords": "",
"snippet": "is a news writer who covers the streaming wars, consumer tech, crypto, social media, and much more. Previously, she was a writer and editor at MUO.\n\nPosts from ...",
"url": "https://www.theverge.com/ai-artificial-intelligence/949005/jeff-bezos-prometheus-artificial-general-engineer",
"image_url": "https://platform.theverge.com/wp-content/uploads/sites/2/chorus/uploads/chorus_asset/file/23951505/VRG_Illo_STK173_L_Normand_JeffBezos_Positive.jpg?quality=90&strip=all&crop=0%2C10.732984293194%2C100%2C78.534031413613&w=1200",
"language": "en",
"published_at": "2026-06-12T14:24:15.000000Z",
"source": "theverge.com",
"categories": [
"tech"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "ef5c0f51-17b5-441d-b434-a89f71b4c83f",
"title": "Officer killed, \"armed and dangerous\" suspect on run in Canada linked to shooting at U.S. consulate",
"description": "A manhunt is underway for an",
"keywords": "Police Shooting, Iraq, Shooting, Terrorism, Iran, Toronto, Canada",
"snippet": "A Toronto police officer was fatally shot Thursday during an operation linked to a shooting at the U.S. Consulate in Toronto in March, police said. One suspect ...",
"url": "https://www.cbsnews.com/news/canada-us-consulate-shooting-police-officer-killed-hunt-for-armed-suspect/",
"image_url": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/03/10/07474e84-d900-4de4-863e-5dad89c284d4/thumbnail/1200x630/6e47d3155ff728624e69b85242a54f61/us-consulate-toronto.jpg",
"language": "en",
"published_at": "2026-06-12T14:23:42.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "2dc0f067-11dc-4940-8704-a91df4dd3011",
"title": "Koe Wetzel's 'The Night Champion' arrives with 11 songs as country star's rise shows no signs of slowing",
"description": "Koe Wetzel's new album 'The Night Champion' is officially here, featuring 11 tracks that showcase the country music star's wide-ranging sound.",
"keywords": "country, up and country, outkick culture, reviews",
"snippet": "Koe Wetzel's new album \"The Night Champion\" has officially arrived.\n\nWetzel has turned into one of the biggest stars in the country music world, and it's been a...",
"url": "https://www.foxnews.com/outkick-culture/koe-wetzels-night-champion-arrives-11-songs-country-stars-rise-shows-signs-slowing",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/05/Koe_Wetzel.jpeg",
"language": "en",
"published_at": "2026-06-12T14:21:15.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "9c541020-f1d4-45b1-93cd-1b77e34cdfbb",
"title": "Recker Eans Joins Jacob Moran, Christian Convery In Indie Film",
"description": "Recker Eans (Wizards Beyond Waverly Place) joins cast in indie film starring Jacob Moran, Christian Convery, Scarlet Estevez, and Megan Stott.",
"keywords": "",
"snippet": "EXCLUSIVE: Nicol Paone (The Kill Room) is set to direct the independent feature Greatest Night Of Summer following the previous exit of filmmaker William Atticu...",
"url": "https://deadline.com/2026/06/nicol-paone-recker-eans-join-indie-feature-greatest-night-of-summer-1236954627/",
"image_url": "https://deadline.com/wp-content/uploads/2026/06/Nicol-Paone-Carter-Dau-and-Recker-Ens.jpg?w=1024",
"language": "en",
"published_at": "2026-06-12T14:18:56.000000Z",
"source": "deadline.com",
"categories": [
"entertainment"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "101e7bbe-ecbd-4f3c-8e1b-8c8d512a8c9a",
"title": "Fox News AI Newsletter: Top 12 takeaways from Apple's new AI features",
"description": "Apple WWDC 2026 put Siri AI and Apple Intelligence at the center of Tim Cook's final keynote as CEO, alongside iOS 27 support for older iPhones and new child sa...",
"keywords": "artificial intelligence, artificial intelligence newsletter, iphone, privacy, apple",
"snippet": "NEW You can now listen to Fox News articles!\n\nWelcome to Fox News' Artificial Intelligence newsletter with the latest AI technology advancements.\n\nIN TODAY’S ...",
"url": "https://www.foxnews.com/tech/ai-newsletter-top-12-takeaways-apple-new-ai-features",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/06/apple-worldwide-developers-conference-cupertino.jpeg",
"language": "en",
"published_at": "2026-06-12T14:13:29.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "ed96ef73-df36-4ee0-a23f-b0c5edc7b03d",
"title": "Step-grandma of Anna Kepner’s accused killer wants teens’ dad to be charged: ‘Recipe for disaster’",
"description": "The step-grandmother who helped raise Timothy Hudson, the 16-year-old accused of sexually abusing and killing his stepsister Anna Kepner, wants the teens' fathe...",
"keywords": "US News, Anna Kepner",
"snippet": "See more of our coverage in your search results.\n\nThe step-grandmother who helped raise Timothy Hudson, the 16-year-old accused of sexually abusing and killing ...",
"url": "https://nypost.com/2026/06/12/us-news/step-grandma-of-anna-kepners-accused-killer-wants-teens-dad-to-be-charged-recipe-for-disaster/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/06/130685114.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-06-12T14:12:40.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "2e722fcf-cadf-459d-b624-66778fbaee20",
"title": "Betting On SpaceX's IPO – Two Exchanges Let You Trade On The Direction Of This Blockbuster Offering",
"description": "",
"keywords": "",
"snippet": "Traders can bet on the direction of SpaceX's blockbuster IPO thanks to crypto exchanges Binance and Hyperliquid.\n\nUnlike investors who hold actual shares, these...",
"url": "https://www.benzinga.com/news/topics/26/06/53166743/betting-on-spacexs-ipo-two-exchanges-let-you-trade-on-the-direction-of-this-blockbuster-offering",
"image_url": "https://cdn.benzinga.com/cdn-cgi/image/width=1200,height=800,fit=crop/files/images/story/2026/06/12/Hawthorne--United-States---Jul-22--2022-_0.jpeg",
"language": "en",
"published_at": "2026-06-12T14:11:54.000000Z",
"source": "benzinga.com",
"categories": [
"business"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "3061b4ff-becd-4150-9f52-0126b8655247",
"title": "Trump blasts Tehran after Iran leaks its own demands in peace deal: ‘They better get their act together!’",
"description": "President Trump expressed frustration with Iran after its foreign ministry said Tehran \"had not reached a final conclusion” on any peace agreement.",
"keywords": "US News, donald trump, iran",
"snippet": "See more of our coverage in your search results.\n\nPresident Trump expressed frustration with Iran after its foreign ministry said Tehran “had not reached a fi...",
"url": "https://nypost.com/2026/06/12/us-news/trump-blasts-tehran-after-iran-leaks-its-own-demands-in-peace-deal/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/06/crop-39655834.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-06-12T14:09:48.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "c51a9c59-9517-45ce-8ac6-308c52312886",
"title": "'You're Not Put On This Planet To Sit At Home And Watch Television'—Dr. Oz Calls Out Medicaid Users Who W",
"description": "",
"keywords": "",
"snippet": "Speaking on Fox Business recently, Oz said the Trump administration’s changes to Medicaid are designed to encourage more workforce participation and reduce lo...",
"url": "https://www.benzinga.com/news/topics/26/06/53166441/youre-not-put-on-this-planet-to-sit-at-home-and-watch-television-dr-oz-calls-out-medicaid-users-who-w",
"image_url": "https://cdn.benzinga.com/cdn-cgi/image/width=1200,height=800,fit=crop/files/images/story/2026/06/12/President-Donald-J-Trump-Delivers-Remark.jpeg",
"language": "en",
"published_at": "2026-06-12T14:06:51.000000Z",
"source": "benzinga.com",
"categories": [
"business"
],
"relevance_score": null,
"locale": "us"
}
]
}
All News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/all HTTP/1.1
Use this endpoint to find all live and historical articles we collect. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-06-12T14:54:20 |
2026-06-12T14:54 |
2026-06-12T14 |
2026-06-12 |
2026-06 |
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-06-12T14:54:20 |
2026-06-12T14:54 |
2026-06-12T14 |
2026-06-12 |
2026-06 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-06-12
|
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": 54362130,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "989c3e08-099c-46ee-a1d5-6d5578aff797",
"title": "한국사회복지협의회, 중소벤처기업인증원 '인권경영시스템' 인증 획득",
"description": "컨슈머타임스=안성렬 기자 | 한국사회복지협의회가 보건복지부 산하기관 중 국민건강보험공단에 이어 두 번째이자, 사?...",
"keywords": "중소벤처기업인증원, 한국사회복지협의회",
"snippet": "사람 중심 복지 실천 결실…사회복지계 공공기관 중 '최초'\n\n중소벤처기업인증원 엄진엽 원장(왼쪽)과 한국사회복지협의...",
"url": "https://www.cstimes.com/news/articleView.html?idxno=709577",
"image_url": "https://www.cstimes.com/news/photo/202606/709577_629406_5139.jpg",
"language": "ko",
"published_at": "2026-06-12T14:54:53.000000Z",
"source": "cstimes.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "2e915b93-8f0f-42b2-9679-6e1fcfbe46b9",
"title": "利民推出新刺客典范系列散热器：支持Intel LGA1851插槽",
"description": "利民推出新刺客典范系列散热器：支持Intel LGA1851插槽",
"keywords": ", 利民推出新刺客典范系列散热器：支持Intel LGA1851插槽, 快科技",
"snippet": "利民推出新刺客典范系列散热器：支持Intel LGA1851插槽\n\n快科技6月12日消息，利民近日扩充刺客典范系列，发布刺客Classic-4 ...",
"url": "https://news.mydrivers.com/1/1129/1129122.htm",
"image_url": "https://img1.mydrivers.com/img/20260612/41877bc114884a77b1a01f0324c5b44c.png",
"language": "zh",
"published_at": "2026-06-12T14:54:40.000000Z",
"source": "news.mydrivers.com",
"categories": [
"tech",
"general"
],
"relevance_score": null
},
{
"uuid": "416075d4-8eea-47ef-ab36-a902d8e2c4e5",
"title": "라바웨이브 “몸캠피싱 피해자 두번 울리는 대응업체 주의하라” - 테크월드",
"description": "[테크월드=이광재 기자] 라바웨이브가 관계 당국의 공식답변을 통해 일부 불법·허위 대응업체들의 ‘가해자 서버에 직?...",
"keywords": "",
"snippet": "[테크월드=이광재 기자] 라바웨이브가 관계 당국의 공식답변을 통해 일부 불법·허위 대응업체들의 ‘가해자 서버에 직?...",
"url": "https://www.epnc.co.kr/news/articleView.html?idxno=402982",
"image_url": "https://cdn.epnc.co.kr/news/photo/202606/402982_403161_5430.png",
"language": "ko",
"published_at": "2026-06-12T14:54:38.000000Z",
"source": "epnc.co.kr",
"categories": [
"tech"
],
"relevance_score": null
},
{
"uuid": "4fb17a8d-d607-4811-9aec-bc88c855a20c",
"title": "샤이니헌터스, 오라클 피플소프트 제로데이 취약점 공격 벌여",
"description": "[데이터넷] 오라클 피플소프트의 제로데이 취약점이 악명높은 그룹 샤이니헌터스(ShinyHunters, UNC6240)의 금전 갈취 목적 공?...",
"keywords": "맨디언트, 구글 클라우드, 오라클, 샤이니헌터스",
"snippet": "구글 “100개 이상 조직 피해 입어···샤이니헌터스, DLS에 유출 데이터 공개”\n\n캔버스·코인베이스 해킹으로 유명한 샤?...",
"url": "https://www.datanet.co.kr/news/articleView.html?idxno=212318",
"image_url": "https://cdn.datanet.co.kr/news/thumbnail/202606/212318_136473_5414_v150.jpg",
"language": "ko",
"published_at": "2026-06-12T14:54:28.000000Z",
"source": "datanet.co.kr",
"categories": [
"tech"
],
"relevance_score": null
},
{
"uuid": "c68f89a1-9a10-4605-be16-1cb1bb99ba21",
"title": "광화문·여의도에 울린 \"대~한민국\"…도심 응원전의 귀환 - 이코노미사이언스",
"description": "| 이코노미사이언스 박성현 기자 |2026 FIFA 북중미 월드컵이 개막한 가운데 기업들이 단순 후원을 넘어 시민 참여형 응원 ?...",
"keywords": "",
"snippet": "| 이코노미사이언스 박성현 기자 |\n\n2026 FIFA 북중미 월드컵이 개막한 가운데 기업들이 단순 후원을 넘어 시민 참여형 응원...",
"url": "https://www.e-science.co.kr/news/articleView.html?idxno=130554",
"image_url": "https://cdn.e-science.co.kr/news/photo/202606/130554_62322_4810.jpg",
"language": "ko",
"published_at": "2026-06-12T14:54:17.000000Z",
"source": "astronomer.rocks",
"categories": [
"science"
],
"relevance_score": null
},
{
"uuid": "083ec935-fac4-4408-8664-363bd8fc5f4b",
"title": "오픈AI 샘올트먼, 이재용 대신 '전영현 부회장' 만난다 - 신아일보",
"description": "샘 올트먼 오픈AI CEO(최고경영자)가 이번 방한에서 이재용 삼성전자 회장 대신 전영현 부회장을 만나는 것으로 확인됐다....",
"keywords": "",
"snippet": "전영현 삼성전자 DS부문장 부회장. [사진=삼성전자]\n\n샘 올트먼 오픈AI CEO(최고경영자)가 이번 방한에서 이재용 삼성전자 ?...",
"url": "https://www.shinailbo.co.kr/news/articleView.html?idxno=5029949",
"image_url": "https://cdn.shinailbo.co.kr/news/photo/202606/5029949_2028560_1525.jpg",
"language": "ko",
"published_at": "2026-06-12T14:54:03.000000Z",
"source": "shinailbo.co.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "0d89f519-d69e-4d61-b7c4-1a4ffe97212d",
"title": "‘최대 7만원 할인 받고 여행 가요’ 여름맞이 숙박세일페스타 시작!",
"description": "문화체육관광부와 한국관광공사가 최대 7만원의 숙박 할인 혜택을 제공하는 ‘2026 여름맞이 숙박세일 페스타’를 개최?...",
"keywords": "숙박세일페스타, 국내여행, 한국관광공사",
"snippet": "문화체육관광부와 한국관광공사가 2026 여름맞이 숙박세일 페스타를 2026년 6월 11일부터 7월 31일까지 진행한다. / 한국관?...",
"url": "https://www.travie.com/news/articleView.html?idxno=55676",
"image_url": "https://cdn.travie.com/news/thumbnail/202606/55676_45714_5210_v150.jpg",
"language": "ko",
"published_at": "2026-06-12T14:53:56.000000Z",
"source": "travie.com",
"categories": [
"travel"
],
"relevance_score": null
},
{
"uuid": "22410524-2ef1-426a-a893-2a51b034550a",
"title": "UK Column News — 12th June 2026",
"description": "",
"keywords": "",
"snippet": "",
"url": "https://www.ukcolumn.org/video/uk-column-news-12th-june-2026",
"image_url": "https://www.ukcolumn.org/sites/default/files/2026-06/UKC%20News.jpg",
"language": "en",
"published_at": "2026-06-12T14:53:46.000000Z",
"source": "ukcolumn.org",
"categories": [
"general",
"politics",
"tech"
],
"relevance_score": null
},
{
"uuid": "ca50e239-084f-4bb8-b9eb-c7e6d6812f6d",
"title": "연간 106만명 암환자 몰리는 서울아산병원, 중입자치료센터 착공",
"description": "국내 암환자 8명 중 1명을 치료하며 연간 106만 명의 암환자를 진료하고 있는 서울아산병원이 최첨단 암 치료 장비인 중입...",
"keywords": "서울아산병원, 아산재단, 중입자, 꿈의암치료, 암, 암치료, 암환자, 초기",
"snippet": "국내 최대 규모, 회전형 치료기 2대·고정형 치료기 1대 등 도입\n\n정몽준 이사장 \"난치성 암환자들에게 희망이 되는 일\" 평...",
"url": "https://www.doctorsnews.co.kr/news/articleView.html?idxno=164948",
"image_url": "http://www.doctorsnews.co.kr/news/photo/202606/164948_137099_5220.jpg",
"language": "ko",
"published_at": "2026-06-12T14:53:22.000000Z",
"source": "doctorsnews.co.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "9505a5ad-7d8b-4cc2-b4e2-5cd9e79f505e",
"title": "신현송 한은 총재 '강력 시사' 7월 '금리인상' 현실화되나",
"description": "한국은행 신현송 총재가 창립기념사에서 '늦지 않게 기준금리 인상'을 시사했습니다. 성장·물가·금융안정 세 가지 근거...",
"keywords": "",
"snippet": "SNS 기사보내기 카카오스토리(으)로 기사보내기 카카오톡(으)로 기사보내기 네이버밴드(으)로 기사보내기 네이버블로그(?...",
"url": "https://news.einfomax.co.kr/news/articleView.html?idxno=4419724",
"image_url": "https://cdn.news.einfomax.co.kr/news/thumbnail/202606/4419724_321950_5210_v150.jpg",
"language": "ko",
"published_at": "2026-06-12T14:53:07.000000Z",
"source": "news.einfomax.co.kr",
"categories": [
"general"
],
"relevance_score": null
}
]
}
Similar News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/similar/uuid HTTP/1.1
Use this endpoint to find similar stories to a specific article based on its UUID.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-06-12T14:54:20 |
2026-06-12T14:54 |
2026-06-12T14 |
2026-06-12 |
2026-06 |
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-06-12T14:54:20 |
2026-06-12T14:54 |
2026-06-12T14 |
2026-06-12 |
2026-06 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-06-12
|
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-06-05
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();