Documentation
Sign up for free!
Get instant access to the API with your free API token. No billing details required!
Getting Started
Introduction
Our API was developed to provide global news from thousands of sources with exceptional response times. On average we add over 1 million articles weekly, so you will never be short of content. Even better, it is completely free!
To get started simply sign up and use your API token in any of the available API endpoints documented below for instant access.
If you have any questions or concerns, feel free to contact us.
Authentication
As mentioned above, when you sign up for free you will find your API token on your dashboard. Simply add this to any of our API endpoints as a GET parameter to gain access. Examples of how this is done can be found below.
API Endpoints
Headlines Available on: Standard plan and above
Endpoint
GET https://api.thenewsapi.com/v1/news/headlines HTTP/1.1
Use this endpoint to find get the latest headlines by category along with similar articles, allowing you to create the perfect news aggregation page similar to Google News .
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
locale |
false | Comma separated list of country codes to include in the result set. Default is all countries.
Click here for a list of supported countries.
Example: us,ca (US + Canada).
|
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_on |
false | Find headlines for articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-07-27
|
headlines_per_category |
false | Specify the number of articles you want to return per category. The maximum is 10 and the default is 6. |
include_similar |
false | Specify if you wish to include similar articles with each base article. Default is true. |
Response Objects
| name | description |
|---|---|
data > uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
data > title |
The article title. |
data > description |
The article meta description. |
data > keywords |
The article meta keywords. |
data > snippet |
The first 60 characters of the article body. |
data > url |
The URL to the article. |
data > image_url |
The URL to the article image. |
data > language |
The language of the source. |
data > published_at |
The datetime the article was published. |
data > source |
The domain of the source. |
data > categories |
Array of strings which the source is categorized as. |
data > locale |
Locale of the source. |
data > similar |
An array of similar articles to the base article. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/headlines?locale=us&language=en&api_token=YOUR_API_TOKEN
Example Response
{
"data": {
"general": [
{
"uuid": "07a2c37c-7769-406c-8fe4-1dcfd976a247",
"title": "TikTokker voiced concerns about Seattle Center food festival security day before mass shooting that left 3 dead",
"description": "A Washington content creator appeared to be surprised by the apparent lack of security at the \"Bite of Seattle\" food festival – just one day before at least three people died in a mass shooting.",
"keywords": "US News, mass shootings, seattle",
"snippet": "See more of our coverage in your search results.\n\nA Washington-based content creator appeared to be surprised by the apparent lack of security at the “Bite of...",
"url": "https://nypost.com/2026/07/27/us-news/tiktokker-voiced-concerns-about-seattle-center-food-festival-security-day-before-mass-shooting-that-left-3-dead/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/07/135642483.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-07-27T09:20:57.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"locale": "us",
"similar": [
{
"uuid": "92d8462e-8ba2-4680-8dac-54ce05dc0565",
"title": "Multiple people shot in mass shooting at Seattle Center, police say",
"description": "Multiple people were shot on Sunday in a mass shooting incident at the Seattle Center, according to police. Police have not confirmed whether any suspects were taken into custody.",
"keywords": "seattle, washington, us, crime world, mass shootings",
"snippet": "NEW You can now listen to Fox News articles!\n\nMultiple people were shot on Sunday in a mass shooting incident at the Seattle Center, according to police.\n\nPolic...",
"url": "https://www.foxnews.com/us/multiple-people-shot-mass-shooting-seattle-center-police-say",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2024/09/seattle-police.jpg",
"language": "en",
"published_at": "2026-07-27T02:22:19.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "a6e388f1-0d30-4cee-8f6d-e342b723168c",
"title": "Multiple people wounded in mass shooting at Seattle Center, police say",
"description": "Multiple people were wounded on Sunday in a mass shooting incident at the Seattle Center, according to police. Police have not confirmed whether any suspects were taken into custody.",
"keywords": "seattle, washington, us, crime world, mass shootings",
"snippet": "NEW You can now listen to Fox News articles!\n\nMultiple people were wounded on Sunday in a mass shooting incident at the Seattle Center, according to police.\n\nPo...",
"url": "https://www.foxnews.com/us/multiple-people-wounded-mass-shooting-seattle-center-police-say",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/07/seattle-shooting-fox-news-001.jpg",
"language": "en",
"published_at": "2026-07-27T02:22:19.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "114147af-7b23-4c05-bb91-404fe92010ce",
"title": "At least 2 killed in shooting at Seattle Center food festival that sent attendees running for their lives: ‘Pure chaos’",
"description": "Multiple people were shot at the Seattle Center Sunday evening, where thousands were attending the Bite of Seattle food festival — sending massive crowds running from a hail of bullets, according to cops and witnesses.",
"keywords": "US News, mass shootings, seattle, shootings",
"snippet": "See more of our coverage in your search results.\n\nAt least two people were killed and five were wounded in a mass shooting at a Seattle food festival on Sunday ...",
"url": "https://nypost.com/2026/07/26/us-news/multiple-people-shot-at-seattle-center-food-festival-sending-attendees-running-for-their-lives/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/07/seattle-center-shooting-at-bite-of-seattle.jpg?quality=75&strip=all&1785108629&w=1200",
"language": "en",
"published_at": "2026-07-27T03:20:26.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "708a84b8-f842-4ba8-8ee5-91b3767ccb79",
"title": "Three people killed in shooting at Seattle food festival",
"description": "Seattle Police say three people were killed and four others injured in a shooting during the Bite of Seattle food festival. One suspect is in custody and another is believed to still be at large, and the suspects may have been shooting at each other, according to police.",
"keywords": "",
"snippet": "Seattle Police say three people were killed and four others injured in a shooting during the Bite of Seattle food festival. One suspect is in custody and anothe...",
"url": "https://www.nbcnews.com/video/three-people-killed-in-shooting-at-seattle-food-festival-267296837775",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/mpx/2704722219/2026_07/1785132512120_nbc_spec_seattle_presser_update_late_260726_S3_1920x1080-wiuqtl.jpg",
"language": "en",
"published_at": "2026-07-27T06:08:39.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
},
{
"uuid": "e99eadb4-9098-4b61-a338-bdc508db3cc9",
"title": "2 dead, 5 injured after shooting at Seattle food festival",
"description": "The Seattle Police Department is investigating a shooting that left multiple people injured at the Seattle Center on Sunday, July 26.",
"keywords": "Katie Wilson, Seattle Center, Seattle Mayor, Bite of Seattle, Seattle, Seattle Fire Department, mass shooting",
"snippet": "Police in Seattle are investigating a mass shooting near the city's iconic Space Needle on July 26 that left two people dead and five others injured, including ...",
"url": "https://www.yahoo.com/news/us/articles/multiple-victims-shooting-seattle-center-022325921.html",
"image_url": "https://s.yimg.com/lo/mysterio/api/9e910213ea6d9243ce68e4af9278dc0527d188c93fd6d92d1cc2fdc4448812f8/lightyear_networkapi/resizefill_w1200;quality_80;format_webp/https:%2F%2Fmedia.zenfs.com%2Fen%2Fusa_today_news_641%2F113f966c1d50ef984531c67d72ec9302",
"language": "en",
"published_at": "2026-07-27T02:23:25.000000Z",
"source": "yahoo.com",
"categories": [
"general",
"business",
"sports",
"entertainment"
],
"locale": "us",
"similar": [
{
"uuid": "e85e58f3-8c93-45b6-a98a-d4857cbbf0fe",
"title": "Multiple people injured in Seattle Center shooting, police say",
"description": "Multiple people were injured as gunfire erupted at Seattle Center, police said, a gathering place for cultural and arts events that was hosting a major food festival over the weekend.",
"keywords": "",
"snippet": "Multiple people were injured as gunfire erupted at Seattle Center, police said, a gathering place for cultural and arts events that was hosting a major food fes...",
"url": "https://www.nbcnews.com/news/us-news/multiple-people-injured-seattle-center-shooting-police-say-rcna589371",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-07/260726-seattle-skyline-ww-1903-c53578.jpg",
"language": "en",
"published_at": "2026-07-27T02:10:37.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "2808ca95-7238-4887-bbc9-ad13d74cab47",
"title": "At least two dead, five injured in Seattle shooting",
"description": "At least two people were killed and five others injured in a shooting during the Bite of Seattle food festival at Seattle Center. NBC News and KING report.",
"keywords": "",
"snippet": "At least two dead, five injured in Seattle shooting\n\nAt least two people were killed and five others injured in a shooting during the Bite of Seattle food festi...",
"url": "https://www.nbcnews.com/video/seattle-shooting-kills-at-least-two-people-five-others-injured-267294789759",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/mpx/2704722219/2026_07/1785123953727_nbc_spec_seattle_deaths_king_260726_S3_1920x1080-pt1iv7.jpg",
"language": "en",
"published_at": "2026-07-27T03:46:00.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-07-27T10:23:02 |
2026-07-27T10:23 |
2026-07-27T10 |
2026-07-27 |
2026-07 |
2026
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-07-27T10:23:02 |
2026-07-27T10:23 |
2026-07-27T10 |
2026-07-27 |
2026-07 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-07-27
|
sort |
false | Sort by published_on or relevance_score (only available when used in conjunction with search).
Default is published_at unless search is used and sorting by published_at is not included,
in which case relevance_score is used. |
limit |
false | Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan. |
page |
false | Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of articles found for the request. |
meta > returned |
The number of articles returned on the page.
This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page. |
meta > limit |
The limit based on the limit parameter. |
meta > page |
The page number based on the page parameter. |
data > uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
data > title |
The article title. |
data > description |
The article meta description. |
data > keywords |
The article meta keywords. |
data > snippet |
The first 60 characters of the article body. |
data > url |
The URL to the article. |
data > image_url |
The URL to the article image. |
data > language |
The language of the source. |
data > published_at |
The datetime the article was published. |
data > source |
The domain of the source. |
data > categories |
Array of strings which the source is categorized as. |
data > relevance_score |
Relevance score based on the search parameter. If the search parameter is not used, this will be null. |
data > locale |
Locale of the source. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/top?api_token=YOUR_API_TOKEN&locale=us&limit=3
Example Response
{
"meta": {
"found": 1672812,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "98e29f76-f4a5-4b09-870a-f8d6c21f267e",
"title": "Why the right is freaking out about “third worldism”",
"description": "Conservatives are ginning up a familiar panic about subversive leftists — but also getting at something real.",
"keywords": "",
"snippet": "is a senior correspondent at Vox, where he covers ideology and challenges to democracy, both at home and abroad. His book on democracy,, was published 0n July 1...",
"url": "https://www.vox.com/politics/496566/third-worldism-trump-rubio-cuba",
"image_url": "https://platform.vox.com/wp-content/uploads/sites/2/2026/07/gettyimages-802512056.jpg?quality=90&strip=all&crop=0%2C16.27372884078%2C100%2C67.45254231844&w=1200",
"language": "en",
"published_at": "2026-07-27T10:03:57.000000Z",
"source": "vox.com",
"categories": [
"general",
"politics",
"entertainment"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "e4b9ed8f-2f08-47ea-83ac-bb704b9bea15",
"title": "Iran live updates: 'No negotiations' ongoing with US, Iranian official says",
"description": "President Donald Trump announced \"major combat operations\" against Iran on Feb. 28, with massive joint U.S.-Israeli strikes.",
"keywords": "LiveBlog, 135110405",
"snippet": "Amid the brief pause in the war between the U.S. and Iran, Iranian Foreign Ministry spokesperson Esmaeil Baghaei told journalists at his weekly press conference...",
"url": "https://abcnews.com/International/live-updates/iran-live-updates-tehran-progress-made-strait-hormuz/?id=135110405",
"image_url": "https://i.abcnewsfe.com/a/2e651ca0-90e6-4294-acac-086a3ee617cd/CENTCOM-tanker-DB-260727_1785146447820_hpMain_16x9.jpg?w=1600",
"language": "en",
"published_at": "2026-07-27T10:03:29.000000Z",
"source": "abcnews.go.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "1b876f6a-f582-497d-8a30-3a7f7d8cba2b",
"title": "Prince William likely 'livid' over Meghan Markle's 'tasteless' photos at Princess Diana's home: expert",
"description": "Meghan Markle shared photos of Prince Archie and Princess Lilibet at Princess Diana's childhood home Althorp during a UK visit. Royal experts call the Instagram...",
"keywords": "exclusive, entertainment, prince harry, meghan markle, princess diana",
"snippet": "NEW You can now listen to Fox News articles!\n\nMeghan Markle shared photos of her children, Princess Lilibet and Prince Archie, frolicking around the late Prince...",
"url": "https://www.foxnews.com/entertainment/prince-william-likely-livid-meghan-markle-tasteless-photos-princess-diana-home-expert",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/07/william-markle.jpg",
"language": "en",
"published_at": "2026-07-27T10:00:56.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "344796ce-9364-4e52-97ed-72998ab299a9",
"title": "Heated Lindsay Clancy courtroom exchange over 911 call, crime scene photos sets stage for mom’s murder trial",
"description": "Lindsay Clancy's murder trial is set to begin with opening statements Monday after a jury was seated in the Massachusetts postpartum psychosis case.",
"keywords": "massachusetts, trials, in court, homicide, true crime, crime, us",
"snippet": "NEW You can now listen to Fox News articles!\n\nThis story discusses suicide. If you or someone you know is having thoughts of suicide, please contact the Nationa...",
"url": "https://www.foxnews.com/us/heated-lindsay-clancy-courtroom-exchange-911-call-crime-scene-photos-sets-stage-moms-murder-trial",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/07/Lindsay-Clancy-Trial-2.jpg",
"language": "en",
"published_at": "2026-07-27T10:00:55.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "9ced9c09-e470-4005-9542-cec79bff6cf8",
"title": "Cracker Barrel comeback gains steam as loyal customer says return visit 'felt like coming home'",
"description": "Cracker Barrel Old Country Store says its turnaround is gaining momentum nearly a year after the rebrand backlash, raising its profitability outlook for fiscal ...",
"keywords": "cracker barrel, restaurants, food drink, food, food, lifestyle",
"snippet": "NEW You can now listen to Fox News articles!\n\nAfter months of backlash over a controversial rebranding that alienated many longtime customers, Cracker Barrel Ol...",
"url": "https://www.foxnews.com/food-drink/cracker-barrel-comeback-gains-steam-loyal-customer-says-return-visit-felt-like-coming-home",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/07/cracker-barrel-interior-with-cutomers-in-fort-pierce-june-2025.jpg",
"language": "en",
"published_at": "2026-07-27T10:00:30.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "9d17671c-dd2a-416d-9649-66f5e3ca1386",
"title": "Barns, go-karts and strip malls: The wild west of private schools that collect taxpayer dollars",
"description": "State legislatures are steering money to private schools with far-reaching consequences.",
"keywords": "",
"snippet": "A decade ago, the state of Florida stripped a teacher of her license for sexual abuse of a 16-year-old boy. Last year, she opened a private school there with ea...",
"url": "https://www.salon.com/2026/07/27/barns-go-karts-and-strip-malls-the-wild-west-of-private-schools-that-collect-taxpayer-dollars-partner/",
"image_url": "https://www.salon.com/app/uploads/2024/12/students_raising_their_hands_teacher_class_elementary_school_1397515933.jpg",
"language": "en",
"published_at": "2026-07-27T10:00:27.000000Z",
"source": "salon.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "8c7921e3-c31b-476e-a61b-b71c600c756b",
"title": "My Husband Found Out How His Daughter Has Been Earning Her Spending Money. His Reaction Isn’t Right.",
"description": "I'm not a fan either, but come on.",
"keywords": "advice, personal-finance, relationships, family",
"snippet": "Pay Dirt is Slate’s money advice column. Have a question? Send it to Kristin and Ilyce here. (It’s anonymous!)\n\nDear Pay Dirt,\n\nMy husband “James” and I...",
"url": "https://slate.com/advice/2026/07/money-advice-side-gig-tuition-threat.html?via=rss",
"image_url": "https://compote.slate.com/images/0109b4cc-1e90-4cad-8521-f96fc43c555c.jpeg?crop=1560%2C1040%2Cx0%2Cy0&width=1560",
"language": "en",
"published_at": "2026-07-27T10:00:00.000000Z",
"source": "slate.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "791ffa26-08d1-48da-86e6-0edb4d8c6106",
"title": "Slate SoundBites for July 27, 2026",
"description": "Build your answer from the sound up with our new game, SoundBites!",
"keywords": "slate-games, soundbites",
"snippet": "Only Slate Plus members can gift Slate stories. Become a member to share 10 free articles a month.",
"url": "https://slate.com/life/2026/07/slate-soundbites-for-july-27-2026.html?via=rss",
"image_url": "https://compote.slate.com/images/cfb2ab0f-1ca4-4da3-b38d-817bc8e8315c.png?width=1560",
"language": "en",
"published_at": "2026-07-27T10:00:00.000000Z",
"source": "slate.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "7b1810f9-ea2d-4946-b7f4-e862aab5f164",
"title": "My Mom Refuses to Let Go of a Contentious Moment From My Childhood. It’s Making Us All Miserable.",
"description": "How many times can we rehash this?",
"keywords": "advice, parenting, kids, family",
"snippet": "Sign up for the Slatest to get the most insightful analysis, criticism, and advice out there, delivered to your inbox daily.\n\nCare and Feeding is Slate’s pare...",
"url": "https://slate.com/advice/2026/07/family-advice-parents-arguing-childhood-events.html?via=rss",
"image_url": "https://compote.slate.com/images/00415b40-830e-4b16-83a0-ed888fed0f37.jpeg?crop=1560%2C1040%2Cx0%2Cy0&width=1560",
"language": "en",
"published_at": "2026-07-27T10:00:00.000000Z",
"source": "slate.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "bb72fa5c-fcf4-4fa6-8aa1-5a0f418ce507",
"title": "Trivia quiz: Slate’s daily game of questions about vocabulary.",
"description": "Test your wits on the Slate Quiz for July 27, 2026.",
"keywords": "trivia, quizzes, slate-games",
"snippet": "Only Slate Plus members can gift Slate stories. Become a member to share 10 free articles a month.",
"url": "https://slate.com/news-and-politics/2026/07/trivia-quiz-daily-slate-vocabulary-letters-geography-latin.html?via=rss",
"image_url": "https://compote.slate.com/images/269a8f8f-070e-4891-adee-5cce2b8489be.jpeg?width=1560",
"language": "en",
"published_at": "2026-07-27T09:55:00.000000Z",
"source": "slate.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
}
]
}
All News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/all HTTP/1.1
Use this endpoint to find all live and historical articles we collect. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-07-27T10:23:02 |
2026-07-27T10:23 |
2026-07-27T10 |
2026-07-27 |
2026-07 |
2026
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-07-27T10:23:02 |
2026-07-27T10:23 |
2026-07-27T10 |
2026-07-27 |
2026-07 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-07-27
|
sort |
false | Sort by published_on or relevance_score (only available when used in conjunction with search).
Default is published_at unless search is used and sorting by published_at is not included,
in which case relevance_score is used. |
limit |
false | Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan. |
page |
false | Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of articles found for the request. |
meta > returned |
The number of articles returned on the page.
This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page. |
meta > limit |
The limit based on the limit parameter. |
meta > page |
The page number based on the page parameter. |
data > uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
data > title |
The article title. |
data > description |
The article meta description. |
data > keywords |
The article meta keywords. |
data > snippet |
The first 60 characters of the article body. |
data > url |
The URL to the article. |
data > image_url |
The URL to the article image. |
data > language |
The language of the source. |
data > published_at |
The datetime the article was published. |
data > source |
The domain of the source. |
data > categories |
Array of strings which the source is categorized as. |
data > relevance_score |
Relevance score based on the search parameter. If the search parameter is not used, this will be null. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&language=en&limit=3
Example Response
{
"meta": {
"found": 54242230,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "6c7f8b83-bdbc-4733-8a10-253a2cf69323",
"title": "21년 농지법 개정이후 농지거래 반토막...최근 10년 최저",
"description": "[뉴스데일리]김종양 의원, 농식품부 제출 ‘최근 10년간 농지거래 현황’ 분석 결과 발표 -- 2021년 66만2천 필지 → 2025년 31...",
"keywords": "",
"snippet": "김종양 국민의힘 의원\n\n[뉴스데일리]김종양 의원, 농식품부 제출 ‘최근 10년간 농지거래 현황’ 분석 결과 발표 -\n\n- 2021?...",
"url": "http://www.newsdaily.kr/news/articleView.html?idxno=259539",
"image_url": "https://cdn.newsdaily.kr/news/thumbnail/202607/259539_176625_2212_v150.jpg",
"language": "ko",
"published_at": "2026-07-27T10:22:55.000000Z",
"source": "newsdaily.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "16ba23a3-8202-4861-ba32-c278e9290cc0",
"title": "Deutsche Post will Briefmarke mit Davidstern nicht drucken: „Politisch nicht korrekt“",
"description": "Die Deutsche Post stoppt eine Briefmarke mit einem Symbol gegen Judenhass, das von Politikern unterstützt wurde.",
"keywords": "Antisemitismus, Israel, München, Juden, deutsche Post AG, Briefmarken, Team First, Antisemitismus, Israel, München, Juden, deutsche Post AG, Briefmarken, Team First",
"snippet": "+++Sie feierte mit ihrer Tochter im Tiergarten: Terror-Opfer vom CSD ist eine Mutter aus Polen\n\n+++Sie feierte mit ihrer Tochter im Tiergarten: Terror-Opfer vom...",
"url": "https://www.bild.de/politik/inland/deutsche-post-will-briefmarke-mit-davidstern-nicht-drucken-politisch-nicht-korrekt-6a632dd626ebb8e13e2ef998",
"image_url": "https://images.bild.de/6a632dd626ebb8e13e2ef998/a043f01178f451656e17282049e53050,8b197db5?w=1280",
"language": "de",
"published_at": "2026-07-27T10:22:38.000000Z",
"source": "bild.de",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "964204de-b4a9-40b4-87aa-0792d6cbc39d",
"title": "[특징주] 다날, 과기부 예금토큰 결제 인프라 사업 참여에 급등…CBDC 상용화 기대감",
"description": "컨슈머타임스=전은정 기자 | 다날 주가가 강세다.다날은 27일 오전 10시21분 기준 전일보다 12.39% 오른 4900원에 거래중이다....",
"keywords": "",
"snippet": "컨슈머타임스=전은정 기자 | 다날 주가가 강세다.\n\n다날은 27일 오전 10시21분 기준 전일보다 12.39% 오른 4900원에 거래중이?...",
"url": "https://www.cstimes.com/news/articleView.html?idxno=714709",
"image_url": "https://www.cstimes.com/news/photo/202607/714709_634900_2338.png",
"language": "ko",
"published_at": "2026-07-27T10:22:20.000000Z",
"source": "cstimes.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "250c0b79-78f9-4aa2-8653-ed2ae589e626",
"title": "1만원당 3천원 즉시 할인…농협·농식품부, ‘가루쌀·콩’ 전략작물 소비 총력전",
"description": "밀과 콩, 가루쌀 등 국산 전략작물로 만든 가공식품을 평소보다 훨씬 저렴하게 살 수 있는 기회가 열렸다.농협경제지주?...",
"keywords": "농협하나로마트, 전략작물, 가루쌀, 김주양, 농협경제지주",
"snippet": "농협경제지주는 지난 13일부터 오는 29일까지 전국 농협하나로마트에서 '국산 전략작물 가공식품 특별 할인전'을 진행한?...",
"url": "http://www.ftoday.co.kr/news/articleView.html?idxno=362619",
"image_url": "https://cdn.ftoday.co.kr/news/thumbnail/202607/362619_371416_1812_v150.jpg",
"language": "ko",
"published_at": "2026-07-27T10:22:19.000000Z",
"source": "ftoday.co.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "728784b3-df45-439a-9302-7f1c82cb9466",
"title": "대전시, 하반기 중소기업 경영안정 지원…1800억 규모 혜택 제공",
"description": "[충청투데이 조진오 기자] 대전시가 고금리와 경기 둔화로 자금난을 겪는 지역 중소기업의 경영 안정을 돕고자 총 1800억?...",
"keywords": "자금, 지원, 중소기업, 기업은행, 하반기, 기업, 홈페이지, 하나은행",
"snippet": "하반기 대전시 중소기업 육성자금 공고. 사진=대전시\n\n[충청투데이 조진오 기자] 대전시가 고금리와 경기 둔화로 자금난?...",
"url": "https://www.cctoday.co.kr/news/articleView.html?idxno=2233832",
"image_url": "https://cdn.cctoday.co.kr/news/photo/202607/2233832_690904_2317.jpg",
"language": "ko",
"published_at": "2026-07-27T10:22:02.000000Z",
"source": "cctoday.co.kr",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "294a4cb0-b382-4c55-af7f-01e275187cdb",
"title": "В Уфе батутный центр выплатит 800 тыс. рублей после травмирования ребенка",
"description": "Прокуратура Октябрьского района Уфы провела проверку по обращению местной жительницы ...",
"keywords": "",
"snippet": "Как сообщает пресс-служба прокуратуры, инцидент произошел еще в феврале 2024 года: девяти...",
"url": "https://www.sobaka.ru/ufa/city/city/218441",
"image_url": "https://static.sobaka.ru/images/post/00/21/84/41/_rotator.jpg?v=1785137373",
"language": "ru",
"published_at": "2026-07-27T10:21:28.000000Z",
"source": "sobaka.ru",
"categories": [
"entertainment"
],
"relevance_score": null
},
{
"uuid": "b601dd04-b8db-4003-a8f4-6bf59bc2da3b",
"title": "동화약품, '후시다인' 리브랜딩… 피부 장벽 케어 시장 공략",
"description": "[일요서울] 동화약품이 화장품 브랜드 '후시다인'을 피부 장벽 관리 중심의 더마 브랜드로 새롭게 개편하고 첫 제품군을 ...",
"keywords": "",
"snippet": "동화약품이 화장품 브랜드 '후시다인'을 피부 장벽 관리 중심의 더마 브랜드로 새롭게 개편하고 첫 제품군을 선보였다. [...",
"url": "https://www.ilyoseoul.co.kr/news/articleView.html?idxno=520332",
"image_url": "https://cdn.ilyoseoul.co.kr/news/photo/202607/520332_480178_5741.jpg",
"language": "ko",
"published_at": "2026-07-27T10:21:25.000000Z",
"source": "ilyoseoul.co.kr",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "81a4a737-1d31-4c25-9f5b-ec3b80b65724",
"title": "네이버-엔비디아 ‘AI 팩토리’ 구상은",
"description": "네이버가 글로벌 AI 반도체 기업 엔비디아로부터 1조5000억원 규모의 전략적 투자를 유치하고, 글로벌 자산운용사 브룩필?...",
"keywords": "네이버, 엔비디아, AI, 팩토리, 투자, 증자, 주식, 주주, 브룩필드, GPU, 베라 루빈, 블랙웰, 데이터센터, 각 세종",
"snippet": "지난 24일(현지 시간) 미국 캘리포니아주 엔비디아 사옥에서 이해진 의장과 엔비디아 젠슨 황 CEO가 10억 달러 규모의 전략...",
"url": "http://www.smedaily.co.kr/news/articleView.html?idxno=360842",
"image_url": "https://cdn.smedaily.co.kr/news/thumbnail/202607/360842_295917_1948_v150.jpg",
"language": "ko",
"published_at": "2026-07-27T10:21:14.000000Z",
"source": "smedaily.co.kr",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "5da4885b-d1c7-4b3d-ab32-069c03527650",
"title": "Michael Page unifica bajo una sola marca los servicios de selección y consultoría de PageGroup",
"description": "La compañía integra sus distintas divisiones en una única arquitectura de marca para simplificar su oferta y reforzar su posicionamiento como proveedor globa...",
"keywords": "marketing, publicidad, comunicación, producción, investigación, fotografía, mobile, diseño, creatividad, arte, estrategia publicitaria, planner, consumo, advertainment, marcas, branded content, transmedia, medios, anuncios, publicistas, control de publici",
"snippet": "La compañía integra sus distintas divisiones en una única arquitectura de marca para simplificar su oferta y reforzar su posicionamiento como proveedor globa...",
"url": "https://www.elpublicista.es/anunciantes/michael-page-unifica-bajo-sola-marca-servicios-seleccion",
"image_url": "https://www.elpublicista.es/adjuntos/fichero_46843_20260727.jpg",
"language": "es",
"published_at": "2026-07-27T10:21:00.000000Z",
"source": "elpublicista.es",
"categories": [],
"relevance_score": null
},
{
"uuid": "7ed6d171-262b-426e-ac4a-40e6462facf7",
"title": "셀트리온, 2분기 매출 1조 3937억원 '분기 최대'…영업이익 86% 급증 - 메디팜스투데이",
"description": "셀트리온이 올해 2분기 신규 제품 판매 확대와 원가구조 개선에 힘입어 역대 최대 분기 매출을 기록했다.셀트리온은 2분?...",
"keywords": "",
"snippet": "사진=셀트리온\n\n셀트리온이 올해 2분기 신규 제품 판매 확대와 원가구조 개선에 힘입어 역대 최대 분기 매출을 기록했다....",
"url": "https://www.apsk.co.kr/news/articleView.html?idxno=539934",
"image_url": "https://cdn.apsk.co.kr/news/photo/202607/539934_186589_2029.jpg",
"language": "ko",
"published_at": "2026-07-27T10:20:46.000000Z",
"source": "pharmstoday.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-07-27T10:23:02 |
2026-07-27T10:23 |
2026-07-27T10 |
2026-07-27 |
2026-07 |
2026
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-07-27T10:23:02 |
2026-07-27T10:23 |
2026-07-27T10 |
2026-07-27 |
2026-07 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-07-27
|
limit |
false | Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan. |
page |
false | Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of articles found for the request. |
meta > returned |
The number of articles returned on the page.
This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page. |
meta > limit |
The limit based on the limit parameter. |
meta > page |
The page number based on the page parameter. |
data > uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
data > title |
The article title. |
data > description |
The article meta description. |
data > keywords |
The article meta keywords. |
data > snippet |
The first 60 characters of the article body. |
data > url |
The URL to the article. |
data > image_url |
The URL to the article image. |
data > language |
The language of the source. |
data > published_at |
The datetime the article was published. |
data > source |
The domain of the source. |
data > categories |
Array of strings which the source is categorized as. |
data > relevance_score |
Relevance score based on the article provided. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/similar/cc11e3ab-ced0-4a42-9146-e426505e2e67?api_token=YOUR_API_TOKEN&language=en&published_on=2020-12-01
Example Response
{
"meta": {
"found": 3571,
"returned": 3,
"limit": 3,
"page": 1
},
"data": [
{
"uuid": "df4ad427-a672-4c67-b6c6-6f81aa00e164",
"title": "Tesla stock jumps after announcement it will join S&P 500 in one go",
"description": "Tesla's stock price surged early Tuesday after the company b...",
"keywords": "Business, s&p 500, stocks, tesla",
"snippet": "Tesla’s stock price surged early Tuesday after the company...",
"url": "https://nypost.com/2020/12/01/tesla-stock-jumps-on-news-it-will-join-sp-500-in-one-shot/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2020/12/tesla-52.jpg?quality=90&strip=all&w=1200",
"language": "en",
"published_at": "2020-12-01T14:35:46.000000Z",
"source": "nypost.com",
"categories": [
"business"
],
"relevance_score": 153.61266
},
{
"uuid": "c9a23881-12dd-4005-8982-7b6552a2eb50",
"title": "Tesla To Join S&P 500 With Full Market Cap On December 21",
"description": "Tesla will be added to the S&P 500 index all at once at its ...",
"keywords": "Tesla, S&P500, EV, Automotive, Stocks, Investing",
"snippet": "Tesla (NASDAQ: TSLA) will be added to the S&P 500 index all ...",
"url": "https://oilprice.com/Latest-Energy-News/World-News/Tesla-To-Join-SP-500-With-Full-Market-Cap-On-December-21.html",
"image_url": "https://d32r1sh890xpii.cloudfront.net/news/718x300/2020-12-01_xwjdajwctl.jpg",
"language": "en",
"published_at": "2020-12-01T16:30:00.000000Z",
"source": "oilprice.com",
"categories": [
"general",
"business"
],
"relevance_score": 146.92773
},
{
"uuid": "18afdb1c-7742-4016-bf8c-a2f114e11199",
"title": "Tesla to Enter S&P 500 at Full Weight in December",
"description": "The electric-vehicle maker will be added to the broad stock-...",
"keywords": "Motor Vehicles, Alternative Fuel Vehicles, Trusts Funds Financial Vehicles, Diversified Holding Companies, Automotive",
"snippet": "S&P Dow Jones Indices said it will add Tesla Inc.’s full w...",
"url": "https://www.wsj.com/articles/tesla-to-enter-s-p-500-at-full-weight-in-december-11606780897?mod=pls_whats_news_us_business_f",
"image_url": "https://images.wsj.net/im-265933/social",
"language": "en",
"published_at": "2020-12-01T00:01:00.000000Z",
"source": "online.wsj.com",
"categories": [
"business"
],
"relevance_score": 128.22346
}
]
}
News by UUID Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/uuid/uuid HTTP/1.1
Use this endpoint to find specific articles by the UUID which is returned on our search endpoints. This is useful if you wish to store the UUID to return the article later.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
Response Objects
| name | description |
|---|---|
uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
title |
The article title. |
description |
The article meta description. |
keywords |
The article meta keywords. |
snippet |
The first 60 characters of the article body. |
url |
The URL to the article. |
image_url |
The URL to the article image. |
language |
The language of the source. |
published_at |
The datetime the article was published. |
source |
The domain of the source. |
categories |
Array of strings which the source is categorized as. |
If no results are found, a resource_not_found error will be returned.
Example Request
GET https://api.thenewsapi.com/v1/news/uuid/147013d8-6c2c-4d50-8bad-eb3c8b7f5740?api_token=YOUR_API_TOKEN
Example Response
{
"uuid": "147013d8-6c2c-4d50-8bad-eb3c8b7f5740",
"title": "These Are The Four American Companies Worth Over $1 Trillion Each – 24",
"description": "America’s major market indexes set records in the early pa...",
"keywords": "",
"snippet": "These Are The Four American Companies Worth Over $1 Trillion...",
"url": "https://247wallst.com/investing/2020/10/17/these-are-the-four-american-companies-worth-over-1-trillion-each/",
"image_url": "https://247wallst.com/wp-content/uploads/2020/08/imageForEntry2-Qrj.jpg",
"language": "en",
"published_at": "2020-10-17T11:16:20.000000Z",
"source": "247wallst.com",
"categories": [
"business"
]
}
Sources Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/sources HTTP/1.1
Use this endpoint to sources to use in your news API requests. Note that the limit is 50 for all requests.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
HTTP GET Parameters
| name | required | description |
|---|---|---|
categories |
false | Comma separated list of categories to include
Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
page |
false | Use this to paginate through the result set. Default is 1.
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of sources found for the request. |
meta > returned |
The number of sources returned on the page. |
meta > limit |
The limit is 50. This currently can not be changed. |
meta > page |
The page number based on the page parameter. |
data > source_id |
The unique ID of the source feed. Use this for the source_ids or exclude_source_ids parameters in the news endpoints.
There may be many source_ids for each domain, therefore we would generally suggest using the domains filter instead the source_ids filter. |
data > domain |
The domain of the source. You can use this for the domains or exclude_domains parameters in the news endpoints. |
data > language |
The source language. |
data > locale |
The source locale. Note that only select sources have locales. |
data > categories |
Array of strings which the source is categorized as. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/sources?api_token=YOUR_API_TOKEN&language=en
Example Response
{
"meta": {
"found": 15453,
"returned": 50,
"limit": 50,
"page": 1
},
"data": [
{
"source_id": "arstechnica.com-1",
"domain": "arstechnica.com",
"language": "en",
"locale": null,
"categories": [
"tech"
]
},
{
"source_id": "adweek.com-1",
"domain": "adweek.com",
"language": "en",
"locale": null,
"categories": [
"business"
]
},
...
Errors
Errors
If your request was unsuccessful, you will receive a JSON formatted error. Below you will find the potential errors you may encounter when using the API.
Errors
| error code | HTTP status | description |
|---|---|---|
malformed_parameters |
400 |
Validation of parameters failed. The failed parameters are usually shown in the error message. |
invalid_api_token |
401 |
Invalid API token. |
usage_limit_reached |
402 |
Usage limit of your plan has been reached. Usage limit and remaining requests can be found on the X-UsageLimit-Limit header. |
endpoint_access_restricted |
403 |
Access to the endpoint is not available on your current subscription plan. |
resource_not_found |
404 |
Resource could not be found. |
invalid_api_endpoint |
404 |
API route does not exist. |
rate_limit_reached |
429 |
Too many requests in the past 60 seconds. Rate limit and remaining requests can be found on the X-RateLimit-Limit header. |
server_error |
500 |
A server error occured. |
maintenance_mode |
503 |
The service is currently under maintenance. |
Example Error Response
{
"error": {
"code": "malformed_parameters",
"message": "The published_before parameter(s) are incorrectly formatted."
}
}
Examples
API Examples
Our endpoints are very useful for filtering to find only specific resources you need. Follow each example request below to see how you can build dynamic queries.
Example Request 1
This is a basic request which will return all articles which match the search term "usd" within the title or body of the article:
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd
Example Request 2
This will return all articles which match the search term "usd" OR "gbp":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%7C%20gbp
Example Request 3
This will return all articles which match the search term "usd" AND "gbp":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%2B%20gbp
Example Request 4
This will return all articles which match the search term "usd" AND "gbp" but removes any articles which mentions "cad":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%2B%20gbp%20-cad
Example Request 5
This will return all articles which match the search term "forex" AND "usd" OR "gbp" but removes any articles which mentions "cad":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=forex%20%2B%20%28usd%20%7C%20gbp%29%20-cad
Example Request 6
This is the same as Example Request 5 but will also ensure the articles returned are in English and categorized by business or tech but not travel, and are published within the last week:
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=forex%20%2B%20%28usd%20%7C%20gbp%29%20-cad&language=en&categories=business%2Ctech&exclude_categories=travel&published_after=2026-07-20
Code Examples
See our prepared examples below to quickly get started implementing our API into your next project.
PHP
$queryString = http_build_query([
'api_token' => 'YOUR_API_TOKEN',
'categories' => 'business,tech',
'search' => 'apple',
'limit' => 50,
]);
$ch = curl_init(sprintf('%s?%s', 'https://api.thenewsapi.com/v1/news/all', $queryString));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($ch);
curl_close($ch);
$apiResult = json_decode($json, true);
print_r($apiResult);
Python
# Python 3
import http.client, urllib.parse
conn = http.client.HTTPSConnection('api.thenewsapi.com')
params = urllib.parse.urlencode({
'api_token': 'YOUR_API_TOKEN',
'categories': 'business,tech',
'limit': 50,
})
conn.request('GET', '/v1/news/all?{}'.format(params))
res = conn.getresponse()
data = res.read()
print(data.decode('utf-8'))
Go
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://thenewsapi.com")
baseURL.Path += "v1/news/all"
params := url.Values{}
params.Add("api_token", "YOUR_API_TOKEN")
params.Add("categories", "business,tech")
params.Add("search", "apple")
params.Add("limit", "50")
baseURL.RawQuery = params.Encode()
req, _ := http.NewRequest("GET", baseURL.String(), nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(string(body))
}
JavaScript
var requestOptions = {
method: 'GET'
};
var params = {
api_token: 'YOUR_API_TOKEN',
categories: 'business,tech',
search: 'apple',
limit: '50'
};
var esc = encodeURIComponent;
var query = Object.keys(params)
.map(function(k) {return esc(k) + '=' + esc(params[k]);})
.join('&');
fetch("https://api.thenewsapi.com/v1/news/all?" + query, requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
C#
var client = new RestClient("https://api.thenewsapi.com/v1/news/all");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddQueryParameter("api_token", "YOUR_API_TOKEN");
request.AddQueryParameter("categories", "business,tech");
request.AddQueryParameter("search", "apple");
request.AddQueryParameter("limit", "50");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
Java
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
HttpUrl.Builder httpBuilder = HttpUrl.parse("https://api.thenewsapi.com/v1/news/all").newBuilder();
httpBuilder.addQueryParameter("api_token", "YOUR_API_TOKEN");
httpBuilder.addQueryParameter("categories", "business,tech");
httpBuilder.addQueryParameter("search", "apple");
httpBuilder.addQueryParameter("limit", "50");
Request request = new Request.Builder().url(httpBuilder.build()).build();
Response response = client.newCall(request).execute();