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-09-11
|
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": "d892aa3e-62e5-455e-8cb8-230b48c18ad8",
"title": "Son who lost father in 9/11 attacks shares powerful lessons 25 years later: ‘I’m still here’",
"description": "Podcaster David Ferrugio, who lost his father at the World Trade Center on 9/11, shares grief advice including storytelling, breath work and finding joy amid loss.",
"keywords": "health, september 11, mental health, wellness, lifestyle, stress and anxiety, depression",
"snippet": "NEW You can now listen to Fox News articles!\n\nAs the nation marks 25 years since Sept. 11, 2001, the weight of the loss of loved ones still looms.\n\nPodcaster Da...",
"url": "https://www.foxnews.com/health/son-lost-father-9-11-attacks-shares-powerful-lessons-25-years-later-still-here",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/09/david-ferrugio-with-father.jpg",
"language": "en",
"published_at": "2026-09-11T11:00:40.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "7ac6d7e1-b71f-4eaf-a5de-1e2b0314e026",
"title": "How President Trump will commemorate September 11 25 years after the terrorist attacks",
"description": "President Trump will deliver remarks at a ceremony at the Pentagon where Americans will gather to remember those aboard Airlines Flight 77 that crashed into the military complex 25 years ago. CBS News' Major Garrett reports.",
"keywords": "Pentagon, Donald Trump, 9/11",
"snippet": "How President Trump will commemorate September 11 25 years after the terrorist attacks President Trump will deliver remarks at a ceremony at the Pentagon where ...",
"url": "https://www.cbsnews.com/video/how-president-trump-will-commemorate-september-11-25-years-after-the-terrorist-attacks/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/09/11/851f038b-253d-46e7-a046-83f095df3c8b/thumbnail/1200x630/831e458e3a43ea4494fa43def403fc5c/cbsn-fusion-how-president-trump-will-commemorate-september-11-25-years-after-the-terrorist-attacks-thumbnail.jpg",
"language": "en",
"published_at": "2026-09-11T12:41:02.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "4e91cc47-cae2-4415-af30-1a3326574df8",
"title": "How George W. Bush reacted to the 9/11 attacks",
"description": "Former President George W. Bush was in a classroom at a Florida elementary school when he was informed of the 9/11 attacks. Chief Washington correspondent Major Garrett was traveling with Bush that day, 25 years ago.",
"keywords": "9/11",
"snippet": "How George W. Bush reacted to the 9/11 attacks Former President George W. Bush was in a classroom at a Florida elementary school when he was informed of the 9/1...",
"url": "https://www.cbsnews.com/video/how-george-w-bush-reacted-to-the-911-attacks/",
"image_url": "https://assets2.cbsnewsstatic.com/hub/i/r/2026/09/11/c360d0eb-a82f-4a59-a5e5-e06331daa22d/thumbnail/1200x630/afb8d380b8f116b82f75393dc4cc8697/cbsn-fusion-how-george-w-bush-reacted-to-the-911-attacks-thumbnail.jpg",
"language": "en",
"published_at": "2026-09-11T13:05:31.000000Z",
"source": "cbsnews.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "d1cf946f-7a45-4d43-90f8-37b5e277449c",
"title": "“Horror to Last a Lifetime”: Juan González on Covering 9/11 Attacks in NYC 25 Years Ago Today",
"description": "Friday marks 25 years since the September 11 attacks on the World Trade Center and the Pentagon, and the crash of Flight 93 in Shanksville, Pennsylvania. Around 3,000 people were killed that day, and nearly 10,000 more have died in the years since from 9/11-related illnesses connected to the collapse of the twin towers. In 2001, Democracy Now! was a radio show broadcasting from the attic of Downtown Community Television in Chinatown, just blocks away from ground zero. We were the closest",
"keywords": "",
"snippet": "This is a rush transcript. Copy may not be in its final form.\n\nAMY GOODMAN: Memorials are being held today to mark 25 years since the 9/11 attacks on September ...",
"url": "https://www.democracynow.org/2026/9/11/juan_daily_news_911",
"image_url": "https://www.democracynow.org/images/story/37/83537/full_hd/SEG1-Juan-Article-Split.jpg",
"language": "en",
"published_at": "2026-09-11T12:19:20.000000Z",
"source": "democracynow.org",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "09bd0838-92bf-4ced-9ee7-b08f9a891f04",
"title": "New documents shed light on New York City’s knowledge of post-9/11 air quality",
"description": "Over 170,000 documents related to the 2001 attacks in New York City were recently released",
"keywords": "",
"snippet": "While it has long been known that poor air quality from the rubble of the World Trade Center triggered health problems for New York residents, a recent slew of ...",
"url": "https://theweek.com/environment/new-documents-nyc-9-11-air-quality-health-problems",
"image_url": "https://cdn.mos.cms.futurecdn.net/cA4v7yQcjoUkDUZ4TfsTZa-2000-80.jpg",
"language": "en",
"published_at": "2026-09-11T16:08:27.000000Z",
"source": "theweek.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "a483a06c-cdd5-4a25-ba35-10bfb348192b",
"title": "Universities across America honor the victims of the 9/11 terrorist attacks with memorial stair climbs",
"description": "9/11 memorial stair climbs took place at stadiums across the country as sports teams and universities honored first responders on the 25th anniversary of the World Trade Center attacks.",
"keywords": "september 11, outkick sports, patriotism, sports, america together, events",
"snippet": "9/11 is a sobering day of remembrance for America. It's been 25 years since terrorist attacks rocked our nation to its core. After two planes struck the World T...",
"url": "https://www.foxnews.com/outkick-analysis/universities-across-america-honor-victims-9-11-terrorist-attacks-memorial-stair-climbs",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/09/firefighters-ground-zero-world-trade-center.jpg",
"language": "en",
"published_at": "2026-09-11T15:46:54.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
},
{
"uuid": "d6a173f9-a57f-4bdf-b2e8-a48781038757",
"title": "Look back: 9/11, Osama bin Laden, and a safe haven in Afghanistan",
"description": "After terrorists attacked the United States on Sept. 11, 2001, America's attention turned fully to the group's leader, Osama bin Laden, and his Al Qaeda network, which had found protection in Afghanistan. Correspondent Allen Pizzey reports on a country already devastated by more than 20 years of continuous warfare, which was anticipating further retaliation by Washington, in a story that originally aired Sept. 16, 2001. Pizzey also talks with Vicky and Mark Timlin, of the charity Hope Worldwide, whose head office ordered them to leave Afghanistan following the attacks on the World Trade Center and the Pentagon.",
"keywords": "Afghanistan, Al Qaeda, Osama bin Laden, 9/11",
"snippet": "Look back: 9/11, Osama bin Laden, and a safe haven in Afghanistan After terrorists attacked the United States on Sept. 11, 2001, America's attention turned full...",
"url": "https://www.cbsnews.com/video/look-back-911-osama-bin-laden-and-a-safe-haven-in-afghanistan/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/09/10/9e872aad-d3f6-4688-8f74-4c62245fe402/thumbnail/1200x630/2573685fc02154f668b737c5583daa73/osama-a-yt.jpg",
"language": "en",
"published_at": "2026-09-11T10:30:07.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "71fae7bd-49fa-4a51-9f26-3304c3db09de",
"title": "From Vietnam to 9/11, America keeps abandoning its heroes",
"description": "The country has sacrificed the health of 9/11 first responders, just like it did with Vietnam War veterans",
"keywords": "",
"snippet": "On Sept. 11 I was working for Pacifica Network News. WBAI Radio, 99.5 FM, is one of the network’s flagship stations. At the time, it was located at 120 Wall S...",
"url": "https://www.salon.com/2026/09/11/from-vietnam-to-9-11-america-keeps-abandoning-its-heroes/",
"image_url": "https://www.salon.com/app/uploads/2026/09/Ground-Zero-2291894138.jpg",
"language": "en",
"published_at": "2026-09-11T10:30:08.000000Z",
"source": "salon.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "57b588be-2c2f-4225-aa59-8046434f3e7b",
"title": "Remembering 9/11 and more AI researchers warn of safety risks: Morning Rundown",
"description": "Americans share harrowing memories from the 9/11 attacks as the nation commemorates the 25th anniversary.",
"keywords": "",
"snippet": "Americans share harrowing memories from the 9/11 attacks as the nation commemorates the 25th anniversary. Two more AI researchers sound the alarm about safety r...",
"url": "https://www.nbcnews.com/news/us-news/remembering-911-ai-researchers-warn-safety-risks-morning-rundown-rcna597175",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-09/260910-9-11-vl-1124a-f75b59.jpg",
"language": "en",
"published_at": "2026-09-11T11:01:54.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "c57143bc-b2e2-433a-bcde-d59c259c662c",
"title": "US abused post-9/11 global solidarity – Lavrov — RT Russia & Former Soviet Union",
"description": "The US exploited post-9/11 global solidarity to expand its geopolitical influence, Russian Foreign Minister Sergey Lavrov has said",
"keywords": "",
"snippet": "Washington used the tragedy as a pretext for dictating its own geopolitical agenda, the Russian foreign minister has said\n\nThe US exploited the wave of internat...",
"url": "https://www.rt.com/russia/645497-us-abused-post-911-global-solidarity/",
"image_url": "https://mf.b37mrtl.ru/files/2026.09/article/6aa4110585f54069321c6904.png",
"language": "en",
"published_at": "2026-09-11T14:37:13.000000Z",
"source": "rt.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "00df76cb-1813-4987-8ebb-b3bd30512ed5",
"title": "Forever War: How 9/11 Unleashed U.S. Violence on Civilians Abroad & Attacks on Rights at Home",
"description": "We look at how post-9/11 policies and the so-called war on terror reshaped the country and the world with two Columbia faculty members who convened a two-day symposium on “The Forever War and the First Amendment.” The symposium brought together journalists, scholars, lawyers and activists to explore the legacy of the “war on terror,” specifically focused on the impact on democratic rights, including the freedoms of speech and the press. First Amendment freedoms “were tested right away in the",
"keywords": "",
"snippet": "We look at how post-9/11 policies and the so-called war on terror reshaped the country and the world with two Columbia faculty members who convened a two-day sy...",
"url": "https://www.democracynow.org/2026/9/11/jameel_jaffer_azmat_khan",
"image_url": "https://www.democracynow.org/images/story/38/83538/full_hd/SEG2-Jameel-Azmat-Split.jpg",
"language": "en",
"published_at": "2026-09-11T12:33:27.000000Z",
"source": "democracynow.org",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "28d695a4-a779-45d0-b144-82d946f9b8dc",
"title": "9/11 25th Anniversary Watch Guide: News Specials, Movies, Shows, Documentaries and More",
"description": "Today marks the 25th anniversary of the September 11, 2001 terrorists attacks, and we have a guide to all the 9/11 specials to stream right now",
"keywords": "",
"snippet": "It’s hard to believe it’s been 25 years since the tragic events that occurred on September 11, 2001.\n\nIt’s a moment in time most Americans won’t forget,...",
"url": "https://www.usmagazine.com/entertainment/news/9-11-25th-anniversary-watch-guide-news-specials-movies-shows-more/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/09/world-trade-center-2006.jpg?crop=0px%2C0px%2C1920px%2C1009px&resize=1200%2C630&quality=70&strip=all",
"language": "en",
"published_at": "2026-09-11T16:45:42.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"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-09-11T18:02:57 |
2026-09-11T18:02 |
2026-09-11T18 |
2026-09-11 |
2026-09 |
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-09-11T18:02:57 |
2026-09-11T18:02 |
2026-09-11T18 |
2026-09-11 |
2026-09 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-09-11
|
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": 1702159,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "ee867550-c47c-4073-864a-c9ef988c3a54",
"title": "Investigators Find Video of Kim Zolciak’s Son KJ Allegedly Having Sex With Underage Relative: Report",
"description": "Investigators reportedly discovered videos of KJ Biermann allegedly having sex with a relative under the age of 12",
"keywords": "",
"snippet": "Investigators have reportedly found evidence of Kim Zolciak’s 15-year-old son, Kroy “KJ” Biermann Jr., having sex with an underage relative.\n\nProsecutors ...",
"url": "https://www.usmagazine.com/celebrity-news/news/kim-zolciaks-son-kj-accused-of-having-sex-with-minor-relative/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/09/Kim-Zolciak-and-Son-KJ-IG-Pic.jpg?crop=0px%2C0px%2C2000px%2C1051px&resize=1200%2C630&quality=55&strip=all",
"language": "en",
"published_at": "2026-09-11T17:49:57.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "cb5a1725-6275-4bfe-8aef-513ffcae3b51",
"title": "What to know about the trend of betting in prediction markets",
"description": "Platforms like Polymarket and Kalshi are surging in popularity. But this is not the same as online betting, and it’s important to know the risks involved.",
"keywords": "",
"snippet": "It seems like you can place a bet on the outcome of just about anything these days: a football game, a midterm election, the Grammys, even the likelihood of an ...",
"url": "https://theweek.com/personal-finance/betting-in-prediction-markets-what-to-know",
"image_url": "https://cdn.mos.cms.futurecdn.net/KfrNFYgZ8Y8Z94otR5WZyM-2000-80.jpg",
"language": "en",
"published_at": "2026-09-11T17:43:28.000000Z",
"source": "theweek.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "fc14fd0c-5a2d-4b54-a5f9-65998c423250",
"title": "Shanna Moakler Reveals Why She Regrets Participating in Ex Travis Barker’s Documentary",
"description": "If Shanna Moakler could turn back time, she may have said no to participating in ex-husband Travis Barker’s documentary",
"keywords": "",
"snippet": "If Shanna Moakler could turn back time, she may have said no to participating in ex-husband Travis Barker’s documentary.\n\n“I regret a lot. I wish I didn’t...",
"url": "https://www.usmagazine.com/celebrity-news/news/shanna-moakler-regrets-participating-in-travis-barkers-doc/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/09/GettyImages-84598805-travis-barker-shanna-moakler.jpg?crop=0px%2C42px%2C1200px%2C631px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2026-09-11T17:35:18.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "9f50771b-1d3f-4a0d-bdfa-bcff91374d59",
"title": "Trump admin declassifies 9/11 documents on info presidents knew in lead-up to terrorist attacks",
"description": "Declassified documents show Presidents Clinton and Bush were warned of al Qaeda hijacking and US attack plots starting in 1998.",
"keywords": "Politics, US News, 9/11, 9/11 25th Anniversary, donald trump, terrorism",
"snippet": "See more of our coverage in your search results.\n\nThe Trump administration on Friday declassified pages of documents outlining what the Clinton and Bush adminis...",
"url": "https://nypost.com/2026/09/11/us-news/trump-admin-declassifies-9-11-documents-on-info-presidents-knew-in-lead-up-to-terrorist-attacks/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/09/trump-admin-declassifies-911-documents-comp.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-09-11T17:30:49.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "d68d6e54-1ab3-4f84-b309-8eefa147475b",
"title": "3 Best New Prime Video Movies to Watch This Weekend (September 11-13): ‘Trap’ and More",
"description": "Prime Video's best new movies to watch this September weekend include 'Trap' with Josh Hartnett and films featuring Sharon Stone and more",
"keywords": "",
"snippet": "Two serial killers and a muse with a pixie cut walk into a bar … no, it’s not the start of a lame joke; they’re just characters in some of Prime Video’s...",
"url": "https://www.usmagazine.com/entertainment/news/3-best-new-prime-video-movies-to-watch-this-weekend-september-11-13-2026/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/09/trap-2.jpg?crop=322px%2C9px%2C1138px%2C596px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2026-09-11T17:30:04.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "4ed966ee-f3d7-4815-9242-2ac0bb0de541",
"title": "Why Abdul El-Sayed has a point about 9/11 memorials.",
"description": "The victims of this attack go well beyond those who died that day.",
"keywords": "sept-11, war, middle-east",
"snippet": "Sign up for the Slatest to get the most insightful analysis, criticism, and advice out there, delivered to your inbox daily.\n\nAbdul El-Sayed, the Democratic can...",
"url": "https://slate.com/news-and-politics/2026/09/sept-11-middle-east-wars-memorials-abdul-el-sayed.html?via=rss",
"image_url": "https://compote.slate.com/images/2185614d-1e1e-4ade-8e0a-96fd8b212d08.jpeg?crop=1560%2C1040%2Cx0%2Cy0&width=1560",
"language": "en",
"published_at": "2026-09-11T17:28:39.000000Z",
"source": "slate.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "86d6c917-8e98-422e-be16-54176a43a35a",
"title": "How America remembered 9/11, in photos",
"description": "Americans gathered at the Pentagon, in Shanksville, Pennsylvania and the New York City area on the 25th anniversary of the Sept. 11, 2001, attacks.",
"keywords": "",
"snippet": "September 11, 2026 at 1:25 p.m. EDT Just now\n\nPeople gathered across the country Friday to mark the 25th anniversary of the Sept. 11, 2001, terrorist attacks.\n\n...",
"url": "https://www.washingtonpost.com/nation/interactive/2026/09/11/photos-911-remembrance-ceremonies-new-york-pennsylvania/",
"image_url": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://cloudfront-us-east-1.images.arcpublishing.com/wapo/SQR76EBV74GF2FHYXYGIRZADNM.JPG&w=1200",
"language": "en",
"published_at": "2026-09-11T17:25:00.000000Z",
"source": "washingtonpost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "0b25ea1a-39d9-4d0d-b5f8-9600d3a41416",
"title": "Matt Mullenweg reportedly returns as Automattic CEO two days after getting booted",
"description": "Two days after being placed on a paid leave of absence, Matt Mullenweg says he has been reinstated as CEO of Automattic, according to a Slack message seen by Te...",
"keywords": "",
"snippet": "is a senior reporter covering technology, gaming, and more. He joined The Verge in 2019 after nearly two years at Techmeme.\n\nTwo days after being placed on a pa...",
"url": "https://www.theverge.com/tech/994087/matt-mullenweg-automattic-ceo-return",
"image_url": "https://platform.theverge.com/wp-content/uploads/sites/2/2026/09/gettyimages-2181956675.jpg?quality=90&strip=all&crop=0%2C10.699286964525%2C100%2C78.601426070949&w=1200",
"language": "en",
"published_at": "2026-09-11T17:20:19.000000Z",
"source": "theverge.com",
"categories": [
"tech"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "5e9adc20-b85e-4568-9f07-a8421e0a076f",
"title": "Some 9/11 families call on Trump to hold Saudis accountable during ground zero memorial ceremony",
"description": "Some family members of 9/11 victims used the 25th anniversary ceremonies to openly call on the president to hold Saudi Arabia accountable for the attacks.",
"keywords": "",
"snippet": "Some 9/11 families call on Trump to hold Saudis accountable during ground zero memorial ceremony\n\nTerry Strada who lost her husband Tom Strada, stands with othe...",
"url": "https://abcnews.com/US/911-families-call-trump-hold-saudis-accountable-ground/story?id=136367465",
"image_url": "https://i.abcnewsfe.com/a/28104061-d556-4735-978c-79a8f083c88c/terry-strada-3-gty-gmh-260911_1789138946637_hpMain_16x9.jpg?w=1600",
"language": "en",
"published_at": "2026-09-11T17:19:45.000000Z",
"source": "abcnews.go.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "a46e461c-acd9-4f00-9162-93a0eda6254c",
"title": "Florida creep busted touching himself in a G-string with sex toys in his car outside Target: cops",
"description": "Nicholas Lydic of Florida was busted touching himself while wearing only a G-string and sneakers outside a Target— where cops found women’s underwear and se...",
"keywords": "US News, crime, florida, indecent exposure",
"snippet": "See more of our coverage in your search results.\n\nHe got his panties in a twist.\n\nA Florida creep was busted touching himself while wearing only a G-string and ...",
"url": "https://nypost.com/2026/09/11/us-news/florida-creep-busted-touching-himself-in-a-g-string-with-sex-toys-in-his-car-outside-target-cops/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/09/140651903.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-09-11T17:19:19.000000Z",
"source": "nypost.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-09-11T18:02:57 |
2026-09-11T18:02 |
2026-09-11T18 |
2026-09-11 |
2026-09 |
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-09-11T18:02:57 |
2026-09-11T18:02 |
2026-09-11T18 |
2026-09-11 |
2026-09 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-09-11
|
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": 54922556,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "92e38c1e-fb5a-4f76-a7c5-cc95de7ec5e4",
"title": "No Timeline For Suspension Of Packers RB Josh Jacobs",
"description": "Yesterday saw an end to Josh Jacobs’ legal case. The Packers running back entered a plea of no contest to the two misdemeanor charges he faced. Jacobs now h...",
"keywords": "",
"snippet": "Jacobs now has five conditions stemming from his damage to property count (including restitution to the victim) along with a $1K fine due to his battery count. ...",
"url": "https://www.yardbarker.com/nfl/articles/no_timeline_for_suspension_of_packers_rb_josh_jacobs/s1_14819_44290459",
"image_url": "https://www.yardbarker.com/media/e/1/e1a796e61c41006912aaa0d91f19d5e2a40a0898/thumb_16x9/green-bay-packers-running-back-josh-jacobs-right.jpg",
"language": "en",
"published_at": "2026-09-11T18:02:38.000000Z",
"source": "yardbarker.com",
"categories": [
"sports"
],
"relevance_score": null
},
{
"uuid": "7b1471f6-7e7e-4495-a2d8-e545725ee1d4",
"title": "新潟簡裁の判事、弾劾裁判へ オンライン賭博で有罪",
"description": "国会の裁判官訴追委員会は11日までに、オンラインカジノで賭博をしたとする常習賭博罪などに問われ、執行猶予付き?...",
"keywords": "西日本新聞me, 西日本新聞, ニュース, 九州, 福岡",
"snippet": "国会の裁判官訴追委員会は11日までに、オンラインカジノで賭博をしたとする常習賭博罪などに問われ、執行猶予付き?...",
"url": "https://www.nishinippon.co.jp/item/1537172/",
"image_url": "https://www.nishinippon.co.jp/uploads/image/1938374/sns_PN2026091101001613.-.-.CI0003.jpg",
"language": "ja",
"published_at": "2026-09-11T18:02:07.000000Z",
"source": "nishinippon.co.jp",
"categories": [],
"relevance_score": null
},
{
"uuid": "c9c075a8-4d1d-486e-8810-6bebc47e8f6b",
"title": "원주시, 월드 스마트시티 엑스포서 ‘AI 특화도시’ 비전 선포 - 강원도민일보",
"description": "원주시가 국내 최대 규모 스마트시티 전시회에서 AI(인공지능) 특화도시로서의 비전을 대내외에 선포했다.시는 9~11일 3일...",
"keywords": "",
"snippet": "▲ 원주시가 9~11일 부산 벡스코에서 열린 2026 월드 스마트시티 엑스포(WSCE)에서 ‘AI 특화 시범도시’ 출범식과 함께 ‘AI ...",
"url": "https://www.kado.net/news/articleView.html?idxno=2072061",
"image_url": "https://cdn.kado.net/news/photo/202609/2072061_881067_0129.jpg",
"language": "ko",
"published_at": "2026-09-11T18:02:04.000000Z",
"source": "kado.net",
"categories": [],
"relevance_score": null
},
{
"uuid": "a40f877a-989c-4d70-b84c-16d00fcb15cd",
"title": "بريدج ووتر: الذكاء الاصطناعي قد يقتل البشر قبل كبحه",
"description": "حذر \"جريج جينسن\"، الرئيس المشارك للاستثمار في \"بريدج ووتر أسوشيتس\"، من أن الذكاء الاصطنا?...",
"keywords": "أرقام موقع متخصص في متابعة اعمق لسوق الأسهم السعودي تداول مع تغطيه معمقة لشركات وأسعار البتروكيماويات, تقارير مالية, مؤشرات مالية, قطاع الأسمنت, البنوك",
"snippet": "حذر \"جريج جينسن\"، الرئيس المشارك للاستثمار في \"بريدج ووتر أسوشيتس\"، من أن الذكاء الاصطنا?...",
"url": "https://www.argaam.com/ar/article/articledetail/id/1935774",
"image_url": "https://www.argaam.com/content/ar/images/argaam-plus-ar.jpg",
"language": "ar",
"published_at": "2026-09-11T18:02:00.000000Z",
"source": "argaam.com",
"categories": [
"business"
],
"relevance_score": null
},
{
"uuid": "55e12a9d-8ca8-4895-bd43-13b00da893b7",
"title": "주말 아침엔 선선, 한낮엔 30도 안팎…내륙 일교차 최대 15도 - 강원도민일보",
"description": "토요일 아침에는 선선하지만 낮에는 햇볕에 기온이 오르면서 내륙을 중심으로 낮과 밤의 기온 차가 10∼15도로 크게 벌어...",
"keywords": "",
"snippet": "토요일 아침 12∼20도·낮 25∼30도\n\n13일 수도권·강원 오전 흐리고 일부 빗방울\n\n▲ 녹음이 우거진 춘천 의암공원.김정호 ?...",
"url": "https://www.kado.net/news/articleView.html?idxno=2072062",
"image_url": "https://cdn.kado.net/news/photo/202609/2072062_881069_0131.jpg",
"language": "ko",
"published_at": "2026-09-11T18:01:45.000000Z",
"source": "kado.net",
"categories": [],
"relevance_score": null
},
{
"uuid": "d56ffa1c-9fa0-4ce4-a2cb-280fde5385dc",
"title": "oliva欧利华腿部按摩器 淘礼金+券后2.9元包邮",
"description": "【原价100-商品券84-活动立减12=到手价2.9】宽度随心调，多部位按摩~",
"keywords": "",
"snippet": "注意：商品是限时、限量、限地区促销，下单时可能已变化，请您核对并理解。",
"url": "http://www.kiees.com/2026/09/11/1025957.html",
"image_url": "",
"language": "zh",
"published_at": "2026-09-11T18:01:21.000000Z",
"source": "kiees.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "0f3d26ef-094b-479a-aa8c-c85a62f56998",
"title": "'Preciso elevar meu nível', diz Rybakina sobre final contra Sabalenka",
"description": "Elena Rybakina avisou que precisará \"elevar o nível de jogo\" para superar Aryna Sabalenka na final do US Open, após vencer Coco Gauff por 3-6, 6-4 e 6-4 em u...",
"keywords": "",
"snippet": "Elena Rybakina avisou que precisará \"elevar o nível de jogo\" para superar Aryna Sabalenka na final do US Open, após vencer Coco Gauff por 3-6, 6-4 e 6-4 em u...",
"url": "https://www.uol.com.br/esporte/ultimas-noticias/2026/09/11/preciso-elevar-meu-nivel-diz-rybakina-sobre-final-contra-sabalenka.ghtm",
"image_url": "https://conteudo.imguol.com.br/c/esporte/60/2026/09/09/elena-rybakina-sera-a-nova-numero-1-do-mundo-no-tenis-apos-vencer-qinwen-zheng-no-us-open-1788986119207_v2_615x300.jpg",
"language": "pt",
"published_at": "2026-09-11T18:01:15.000000Z",
"source": "uol.com.br",
"categories": [
"tech",
"science"
],
"relevance_score": null
},
{
"uuid": "35b17004-e96a-4caf-8a08-5c102a0efe87",
"title": "컴투스 신작 ‘제우스’ 뒤흔든 직원 사칭 논란… “당사 직원 아냐, 수사 의뢰 방침”",
"description": "- 출시 직후 양대 앱마켓 매출 1위… 초반 흥행 속 불거진 직원 사칭 논란- CCTV 확인 뒤 임직원 아니라 판단… 게시물 삭제...",
"keywords": "컴투스, 제우스오만의신, 제우스",
"snippet": "- 출시 직후 양대 앱마켓 매출 1위… 초반 흥행 속 불거진 직원 사칭 논란\n\n- CCTV 확인 뒤 임직원 아니라 판단… 게시물 삭?...",
"url": "https://www.ilyoseoul.co.kr/news/articleView.html?idxno=522462",
"image_url": "https://cdn.ilyoseoul.co.kr/news/photo/202609/522462_483616_5130.png",
"language": "ko",
"published_at": "2026-09-11T18:01:11.000000Z",
"source": "ilyoseoul.co.kr",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "02a9bccd-5e9a-4d61-a012-bad927c25ae3",
"title": "日本人のビザ料金引き上げ 中国「相互主義に基づく」",
"description": "【北京共同】在日本中国大使館は11日、日本人へのビザ料金を14日から引き上げると発表した。入国のたびに取得が必要...",
"keywords": "西日本新聞me, 西日本新聞, ニュース, 九州, 福岡",
"snippet": "【北京共同】在日本中国大使館は11日、日本人へのビザ料金を14日から引き上げると発表した。入国のたびに取得が必要...",
"url": "https://www.nishinippon.co.jp/item/1537171/",
"image_url": "https://www.nishinippon.co.jp/uploads/image/1938371/sns_PN2026091101001612.-.-.CI0003.jpg",
"language": "ja",
"published_at": "2026-09-11T18:01:02.000000Z",
"source": "nishinippon.co.jp",
"categories": [],
"relevance_score": null
},
{
"uuid": "650079d8-1091-48f8-93ba-2a86d378f99a",
"title": "Murphy Proposes 10-10 Rounds After Evloev Loss",
"description": "Lerone Murphy wants MMA judges to score uneventful rounds as draws. Murphy, who lost his undefeated record via majority decision to Movsar Evloev in London earl...",
"keywords": "",
"snippet": "Lerone Murphy wants MMA judges to score uneventful rounds as draws.\n\nMurphy, who lost his undefeated record via majority decision to Movsar Evloev in London ear...",
"url": "https://www.yardbarker.com/mma/articles/murphy_proposes_10_10_rounds_after_evloev_loss/s1_17349_44290466",
"image_url": "https://www.yardbarker.com/media/f/8/f829ec3f0ba04a27d62698095c13e8165a229a46/thumb_16x9/mar-21-2026-londonunited-kingdom-movsar-evloev.jpg",
"language": "en",
"published_at": "2026-09-11T18:01:01.000000Z",
"source": "yardbarker.com",
"categories": [
"sports"
],
"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-09-11T18:02:57 |
2026-09-11T18:02 |
2026-09-11T18 |
2026-09-11 |
2026-09 |
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-09-11T18:02:57 |
2026-09-11T18:02 |
2026-09-11T18 |
2026-09-11 |
2026-09 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-09-11
|
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-09-04
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();