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: 2025-12-13
|
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": "831f998d-2d28-4f1d-844a-0c28ec3e0202",
"title": "Sherrone Moore Arraignment: 3 Charges Against Michigan Coach Revealed",
"description": "Charges against Sherrone Moore were confirmed after the former University of Michigan head football coach was arrested and fired amid assault allegations",
"keywords": "",
"snippet": "The charges filed against former University of Michigan head football coach Sherrone Moore have been confirmed after he was arrested and fired from his position...",
"url": "https://www.usmagazine.com/entertainment/news/sherrone-moore-arraignment-3-charges-against-michigan-coach-revealed/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2025/12/GettyImages-2244528352-Sherrone-Moore-Charges-Revealed-After-Michigan-Coach-Is-Arrested-and-Fired.jpg?crop=0px%2C0px%2C2000px%2C1051px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2025-12-12T18:00:43.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"locale": "us",
"similar": [
{
"uuid": "cfe0ff7f-bbe7-41c0-8e26-70c1a8ab6037",
"title": "Fired Michigan football coach Sherrone Moore faces stalking, home invasion charges",
"description": "Fired Michigan football coach Sherrone Moore will be arraigned in court Friday on stalking and home invasion charges days after his shocking dismissal.",
"keywords": "",
"snippet": "NEW You can now listen to Fox News articles!\n\nFired Michigan football coach Sherrone Moore will be arraigned in court Friday on stalking and home invasion charg...",
"url": "https://www.foxnews.com/sports/fired-michigan-football-coach-sherrone-moore-faces-charges-stalking-home-invasion",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/12/sherrone-moore-michigan-northwestern-looks-on.jpg",
"language": "en",
"published_at": "2025-12-12T17:54:24.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "e984b539-219d-418f-81a3-c6304344d53b",
"title": "Fired Michigan coach Sherrone Moore charged with three crimes",
"description": "Sherrone Moore, abruptly fired this week as Michigan football coach, was charged Friday with three crimes including home invasion and stalking a person he had dated, prosecutors said.",
"keywords": "",
"snippet": "ANN ARBOR, Mich. -- Sherrone Moore, abruptly fired this week as Michigan football coach, was charged Friday with three crimes including home invasion and stalki...",
"url": "https://www.espn.com/college-football/story/_/id/47286996/fired-michigan-coach-sherrone-moore-charged-three-crimes",
"image_url": "https://a3.espncdn.com/combiner/i?img=%2Fphoto%2F2024%2F0613%2Fr1345309_1296x729_16%2D9.jpg",
"language": "en",
"published_at": "2025-12-12T18:21:20.000000Z",
"source": "espn.com",
"categories": [
"sports",
"general"
],
"locale": "us"
},
{
"uuid": "71cd1f2f-66f3-47f2-96f0-d1878967e1a6",
"title": "Fired Michigan football coach Sherrone Moore appears in court",
"description": "Fired Michigan football coach Sherrone Moore appeared virtually in court and is charged with home invasion, stalking and breaking and entering. NBC News' Shaquille Brewster reports on the charges, what prosecutors had to say about Moore's actions and what comes next.",
"keywords": "",
"snippet": "Fired Michigan football coach Sherrone Moore appeared virtually in court and is charged with home invasion, stalking and breaking and entering. NBC News' Shaqui...",
"url": "https://www.nbcnews.com/now/video/fired-michigan-football-coach-sherrone-moore-appears-in-court-254314053794",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/mpx/2704722219/2025_12/1765564879633_now_brk_moore_court_appearance_251212_1920x1080-96kppd.jpg",
"language": "en",
"published_at": "2025-12-12T18:41:28.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "3a138fb5-407e-44a7-9f58-9ee0d393a112",
"title": "Details About Sherrone Moore's Relationship With Staffer Revealed",
"description": "Former University of Michigan head football coach Sherrone Moore appeared via Zoom at an arraignment hearing on Friday, December 12",
"keywords": "",
"snippet": "The alleged “inappropriate” relationship between former Michigan head football coach Sherrone Moore and a woman on his football staff came more into view du...",
"url": "https://www.usmagazine.com/entertainment/news/details-about-sherrone-moores-relationship-with-staffer-revealed/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2025/12/GettyImages-2250192038-Sherrone-Moore-October-2025.jpg?crop=0px%2C125px%2C1333px%2C700px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2025-12-12T19:58:10.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"locale": "us"
},
{
"uuid": "6452c131-ea8e-4465-b20b-607f305b8dec",
"title": "Ex Michigan Coach Jim Harbaugh Addresses Sherrone Moore Scandal",
"description": "Jim Harbaugh breaks his silence about Sherrone Moore's dismissal as Michigan coach and his subsequent arrest",
"keywords": "",
"snippet": "Former Michigan head football coach Jim Harbaugh addressed his successor Sherrone Moore’s dismissal and arrest for the first time.\n\n“I’m still processing ...",
"url": "https://www.usmagazine.com/entertainment/news/ex-michigan-coach-jim-harbaugh-addresses-sherrone-moore-scandal/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2025/12/Former-Michigan-Coach-Jim-Harbaugh-Asked-About-Sherrone-Moore-Scandal.jpg?crop=0px%2C0px%2C1998px%2C1051px&resize=1200%2C630&quality=70&strip=all",
"language": "en",
"published_at": "2025-12-12T22:14:59.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"locale": "us"
}
]
},
{
"uuid": "cb265aa2-772c-45d0-86fd-b33680c553db",
"title": "Preservation group sues Trump administration over White House ballroom project",
"description": "A historic preservation group seeks to halt President Donald Trump's White House ballroom construction, arguing he violated federal statutes and bypassed Congress.",
"keywords": "",
"snippet": "NEW You can now listen to Fox News articles!\n\nPresident Donald Trump is being sued by a historic preservation group seeking to stop construction on his new Whit...",
"url": "https://www.foxnews.com/politics/preservation-group-sues-trump-administration-white-house-ballroom-project",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/10/wh-east-wing-ballroom.jpg",
"language": "en",
"published_at": "2025-12-12T21:01:14.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "d2638055-1f06-4114-9e09-b209b416a1cf",
"title": "House Democrats release photos of Trump, Clinton and Andrew from Epstein’s estate",
"description": "House Democrats have released several photos from the estate of Jeffrey Epstein, including some of Donald Trump, Bill Clinton and the former Prince Andrew.",
"keywords": "Jeffrey Epstein, Bill Clinton, Andrew Mountbatten Windsor, Donald Trump, U.S. Democratic Party, Indictments, General news, Local News for Apple, AP Top News, New York City, New York, Ghislaine Maxwell, U.S. news, Human trafficking, Washington news, Politics, U.S. News",
"snippet": "Add AP News as your preferred source to see more of our stories on Google.\n\nAdd AP News on Google Add AP News as your preferred source to see more of our storie...",
"url": "https://apnews.com/article/epstein-photos-released-democrats-trump-clinton-andrew-f256bd536bf4d2e63c37e59d50a65304",
"image_url": "https://dims.apnews.com/dims4/default/5dbe199/2147483647/strip/true/crop/5760x3240+0+300/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fd1%2Fd6%2F925baf9f0a6f43ba096874931485%2Fe1f5d51e15fe459d9bd31fba756ece4f",
"language": "en",
"published_at": "2025-12-12T15:53:02.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "11da430f-1b4e-4049-8c0f-1dfbaa2478c6",
"title": "White House mocks CNN as ‘Chicken News Network’ after failing to schedule Stephen Miller",
"description": "White House mocks CNN as \"Chicken News Network\" on Thursday for failing to book Stephen Miller, but network quickly says members of the administration are welcome on air.",
"keywords": "",
"snippet": "NEW You can now listen to Fox News articles!\n\nThe White House mocked CNN as \"Chicken News Network\" on Thursday for failing to book deputy chief of staff for pol...",
"url": "https://www.foxnews.com/media/white-house-mocks-cnn-chicken-news-network-after-failing-schedule-stephen-miller",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/12/miller.jpg",
"language": "en",
"published_at": "2025-12-12T15:51:38.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "fb8a775d-2cd7-4627-b88a-4bdb5a884d0c",
"title": "Trump sued by preservationists seeking reviews and congressional approval for ballroom project",
"description": "President Donald Trump has been sued by preservationists seeking an architecture review and congressional approval over his White House ballroom project.",
"keywords": "Donald Trump, Karoline Leavitt, Courts, Decor, General news, Local News for Apple, AP Top News, DC Wire, District of Columbia, Constitutional law, United States government, U.S. news, Washington news, Politics, Legal proceedings, Architecture, U.S. News",
"snippet": "Add AP News as your preferred source to see more of our stories on Google.\n\nAdd AP News on Google Add AP News as your preferred source to see more of our storie...",
"url": "https://apnews.com/article/trump-white-house-ballroom-sued-preservationists-76dc3bbea28257e79f8becd487d2c4d7",
"image_url": "https://dims.apnews.com/dims4/default/2d7000a/2147483647/strip/true/crop/4699x2643+0+245/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F10%2Fd0%2F3da794a563c588cb21068adc3283%2Fd8da7411324a4b158453f08d019190f6",
"language": "en",
"published_at": "2025-12-12T16:53:02.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "243a0b24-a26c-4f4e-a3ba-be0d8cd65fc3",
"title": "Trump Hit With Massive Lawsuit Over His Tacky Ballroom",
"description": "Donald Trump is being sued for destroying the White House to build his gaudy ballroom.",
"keywords": "",
"snippet": "The lawsuit also notes that Congress is required to approve any construction on federal land, and the White House is located at the White House and President’...",
"url": "https://newrepublic.com/post/204360/trump-lawsuit-ballroom",
"image_url": "https://images.newrepublic.com/d1c6862ee572f24303150a625a74f01e8b3eb17d.jpeg?w=1200&h=630&crop=faces&fit=crop&fm=jpg",
"language": "en",
"published_at": "2025-12-12T17:11:08.000000Z",
"source": "newrepublic.com",
"categories": [
"general",
"politics",
"entertainment"
],
"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: 2025-12-13T01:30:46 |
2025-12-13T01:30 |
2025-12-13T01 |
2025-12-13 |
2025-12 |
2025
|
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: 2025-12-13T01:30:46 |
2025-12-13T01:30 |
2025-12-13T01 |
2025-12-13 |
2025-12 |
2025
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-12-13
|
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": 1499039,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "0a70b962-95f8-4556-83f6-1af85f62e05b",
"title": "White House hosts ‘Miracle on Ice’ heroes as Trump signs bill honoring legendary 1980 Olympic hockey win",
"description": "“The whole world expected the Soviets to win — unless the ice melted,” President Trump said, recounting the overwhelming odds facing the US' 1980 hockey.....",
"keywords": "US News, elise stefanik, hockey hall of fame, International Olympic Committee, trump, white house",
"snippet": "WASHINGTON — Do you still believe in miracles?\n\nThe historic USA hockey team that toppled the mighty Soviet Union at the 1980 Lake Placid Olympics got yet ano...",
"url": "https://nypost.com/2025/12/12/us-news/hockey-heroes-honored-with-congressional-gold-medal-45-years-after-historic-upset-over-soviet-union/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2025/12/Miracle-on-Ice-comp-1.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2025-12-13T01:12:49.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "1806d255-ff6b-4767-9c82-968a3dc81907",
"title": "Former Michigan coach Jim Harbaugh reacts to Sherrone Moore's firing and charges",
"description": "Jim Harbaugh said he's 'still processing' news of his Michigan successor Sherrone Moore's arrest on stalking and home invasion charges after firing.",
"keywords": "",
"snippet": "NEW You can now listen to Fox News articles!\n\nJim Harbaugh was asked about his Michigan football successor's current scandal on Friday, and admitted he still ha...",
"url": "https://www.foxnews.com/sports/former-michigan-coach-jim-harbaugh-reacts-sherrone-moores-firing-criminal-charges",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/12/harbaugh-moore.jpg",
"language": "en",
"published_at": "2025-12-13T01:07:48.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "2bb01848-6eb4-4519-9641-58f0c61243b0",
"title": "LAPD ‘bleeding out’ as City Hall fights over cops ahead of World Cup, Olympics",
"description": "As Los Angeles prepares to welcome the World Cup and the 2028 Olympics — spectacles that will put Los Angeles on the world stage and demand airtight security ...",
"keywords": "US News, california, lapd, los angeles, police officers",
"snippet": "LAPD is “bleeding out” — with the clock ticking ahead of two of the biggest global events Los Angeles will ever host.\n\nAs the city prepares to welcome the...",
"url": "https://nypost.com/2025/12/12/us-news/la-faces-world-cup-olympics-safety-questions-with-1400-officer-shortfall/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2025/12/034E0F9A000003E8.t.jpg?quality=75&strip=all&w=200",
"language": "en",
"published_at": "2025-12-13T01:06:01.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "cc7df952-f8e2-4cb7-a45e-bd1199afca46",
"title": "Meet Biff Poggi Michigan Interim Head Coach After Sherrone Moore Arrest",
"description": "Biff Poggi was announced as the interim head coach for Michigan after Sherrone Moore’s firing and arrest and will lead the team in next game",
"keywords": "",
"snippet": "The University of Michigan has named Francis “Biff” Poggi as interim head football coach after Sherrone Moore’s firing and subsequent arrest.\n\nMichigan an...",
"url": "https://www.usmagazine.com/entertainment/news/meet-biff-poggi-michigan-interim-head-coach-after-sherrone-moore-arrest/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2025/12/GettyImages2235235637-Who-Is-Bigg-Poggi.jpg?crop=0px%2C0px%2C2000px%2C1051px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2025-12-13T01:03:42.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "2ab7e0b8-a10e-4aaf-b791-674fac59f395",
"title": "Jessy Schram Imagines Hallmark Movie With Chicago Med’s Luke Mitchell",
"description": "Jessy Schram reveals her Hallmark crossover idea with Chicago Med's Luke Mitchell, including who she'd want him to play in a rom-com",
"keywords": "",
"snippet": "Chicago Med fans know Jessy Schram as Dr. Hannah Asher, while Hallmark viewers have seen her as a musician, designer and more characters. But what would happen ...",
"url": "https://www.usmagazine.com/entertainment/news/jessy-schram-imagines-hallmark-movie-with-chicago-meds-luke-mitchell/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2025/12/Jessy-Schram-Wants-This-Chicago-Med-Costar-to-Make-a-Hallmark-Rom-Com-With-Her-ASAP-003.jpg?crop=131px%2C0px%2C1869px%2C980px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2025-12-13T01:00:52.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "e7e4aac6-afb2-4f42-b0e2-35fe3dd16fe0",
"title": "Six homes, Caribbean vacations and a new SUV: How Oklahoma pastor spent $3.15M of ‘embezzled’ BLM OKC money",
"description": "Tashella Sheri Amore Dickerson allegedly embezzled at least $3.15 million in national bail funds and donations to BLM OKC.",
"keywords": "US News, black lives matter, fraud, oklahoma",
"snippet": "Black Lives Matter OKC leader Tashella Sheri Amore Dickerson calls herself an “unpaid protester” on her Instagram site — but the Oklahoma City-based Bapti...",
"url": "https://nypost.com/2025/12/12/us-news/how-oklahoma-pastor-spent-3-15m-of-embezzled-blm-okc-money/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2025/12/newspress-collage-xf0wigkbk-1765587177562.jpg?quality=75&strip=all&1765569221&w=1200",
"language": "en",
"published_at": "2025-12-13T00:54:35.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "f29e0168-9682-4f39-9325-92dd1876c509",
"title": "Trump on photos with Epstein: 'I know nothing about it'",
"description": "When asked by NBC News’ Yamiche Alcindor about a batch of images from Jeffrey Epstein’s estate, President Trump said he knew “nothing about it,” adding ...",
"keywords": "",
"snippet": "Trump on photos with Epstein: 'I know nothing about it'\n\nWhen asked by NBC News’ Yamiche Alcindor about a batch of images from Jeffrey Epstein’s estate, Pre...",
"url": "https://www.nbcnews.com/video/shorts/trump-on-photos-with-epstein-i-know-nothing-about-it-254345797820",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/mpx/2704722219/2025_12/vert_thumb.00_00_13_13.Still004-9dg13d.jpg",
"language": "en",
"published_at": "2025-12-13T00:50:11.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "8b947370-3634-4502-84c2-589ed3d4851e",
"title": "Bethany Joy Lenz to Star in Hallmark When Calls the Heart Prequel",
"description": "Bethany Joy Lenz and Benjamin Ayres lead 'Hope Valley 1874,' a 'When Calls the Heart' prequel for Hallmark",
"keywords": "",
"snippet": "Brace yourself Hope Valley faithfuls: Hallmark is expanding the When Calls the Heart universe with an all-new prequel series.\n\nBethany Joy Lenz, Benjamin Ayres ...",
"url": "https://www.usmagazine.com/entertainment/news/bethany-joy-lenz-to-star-in-hallmark-when-calls-the-heart-prequel/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2025/12/Bethany-Joy-Lenz-and-Benjamin-Ayres-to-Star-in-Hallmark-When-Calls-the-Heart-Prequel-Details-Bethany-Joy-Lenz-Benjamin-Ayres.jpg?crop=0px%2C43px%2C2000px%2C1051px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2025-12-13T00:49:53.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "87d3b60c-a4b5-46bb-b40a-011f9429b72e",
"title": "12/12: The Takeout with Major Garrett",
"description": "House Oversight Committee Democrats release Epstein estate photos; Senate fails to advance competing health care bills.",
"keywords": "",
"snippet": "12/12: The Takeout with Major Garrett House Oversight Committee Democrats release Epstein estate photos; Senate fails to advance competing health care bills.",
"url": "https://www.cbsnews.com/video/1212-the-takeout-with-major-garrett/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2025/12/13/a96dec51-593e-477f-b1c2-48e8913cdd7e/thumbnail/1200x630/0222b8937624aed8037afb88145149ca/1212-takeout-full-4244192-640x360.jpg",
"language": "en",
"published_at": "2025-12-13T00:41:34.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "942bc49f-0b45-4857-993a-e125b5fe2482",
"title": "Florida influencer, 41, accused of inappropriately touching, exposing herself to teenage son's friend",
"description": "Florida micro-influencer Lisa Singh was arrested in November on charges of indecent touching of a minor following an alleged September incident at her home.",
"keywords": "",
"snippet": "NEW You can now listen to Fox News articles!\n\nA Florida micro-influencer was arrested in November after allegedly making sexual advances on her teenage son's fr...",
"url": "https://www.foxnews.com/us/florida-influencer-accused-inappropriately-touching-exposing-herself-teenage-sons-friend",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/12/lisa-singh.png",
"language": "en",
"published_at": "2025-12-13T00:40:15.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
}
]
}
All News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/all HTTP/1.1
Use this endpoint to find all live and historical articles we collect. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2025-12-13T01:30:46 |
2025-12-13T01:30 |
2025-12-13T01 |
2025-12-13 |
2025-12 |
2025
|
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: 2025-12-13T01:30:46 |
2025-12-13T01:30 |
2025-12-13T01 |
2025-12-13 |
2025-12 |
2025
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-12-13
|
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": 54573604,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "a082437b-5c41-4001-a449-0279121e63e4",
"title": "Infected Rain announce spring 2026 U.S. tour",
"description": "Infected Rain have announced a headlining U.S. tour. Dates are available below.Find Infected Rain tickets here.05/04 Lubbock, TX @ Jakes05/05 Austin, TX @ Come ...",
"keywords": "Infected Rain, Lambgoat, news, hardcore, metal",
"snippet": "Infected Rain have announced a headlining U.S. tour. Dates are available below.\n\nFind Infected Rain tickets here.\n\n05/04 Lubbock, TX @ Jakes\n\n05/05 Austin, TX @...",
"url": "https://lambgoat.com/news/50890/infected-rain-announce-spring-2026-us-tour/",
"image_url": "https://lambgoat.com/cdn/2025/infected-rain-20251211170044.jpg",
"language": "en",
"published_at": "2025-12-13T01:28:00.000000Z",
"source": "lambgoat.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "eb1cfdd9-410f-4f3c-95d7-d5d6fb5f92f2",
"title": "Palmeiras defende campo do sintético e ataca o Flamengo: 'Sintético ou buraco?'",
"description": "A \"guerra\" entre Palmeiras e Flamengo nos bastidores continua. Nesta sexta-feira, o clube paulista fez uma postagem no Instagram defendendo o gramado sintético...",
"keywords": "",
"snippet": "A \"guerra\" entre Palmeiras e Flamengo nos bastidores continua. Nesta sexta-feira, o clube paulista fez uma postagem no Instagram defendendo o gramado sintético...",
"url": "https://www.uol.com.br/esporte/ultimas-noticias/agencia/2025/12/12/palmeiras-volta-a-defender-campo-do-allianz-parque-e-critica-o-flamengo-sintetico-ou-buraco.htm",
"image_url": "https://conteudo.imguol.com.br/c/esporte/01/2020/02/10/gramado-allianz-parque-palmeiras-1581365865128_v2_615x300.jpg",
"language": "pt",
"published_at": "2025-12-13T01:27:50.000000Z",
"source": "uol.com.br",
"categories": [
"tech",
"science"
],
"relevance_score": null
},
{
"uuid": "e9ee90ba-8f4b-4aa5-8959-92a715ed8cfc",
"title": "시카고 연은 총재",
"description": "오스탄 굴스비 미국 시카고 연방준비은행 총재는 12일(현지시간) 스스로를 매파적이지 않다면서 향후 정책금리 인하에 ?...",
"keywords": "",
"snippet": "\"더 많은 데이터를 기다렸어야…내년으로 넘겼다면 추가 위험 없었을 것\"\n\n\"금리 인하를 너무 앞당기는 데 불편함을 느껴...",
"url": "https://news.einfomax.co.kr/news/articleView.html?idxno=4388738",
"image_url": "https://cdn.news.einfomax.co.kr/news/thumbnail/202512/4388738_274921_261_v150.jpg",
"language": "ko",
"published_at": "2025-12-13T01:25:13.000000Z",
"source": "news.einfomax.co.kr",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "f6513fb3-1476-4b82-8a67-4523b92e5484",
"title": "187㎝ 피지컬에 베테랑 빅맨도 '추풍낙엽', 그런데 '귀요미' 반전매력... 본인은 \"농구를 잘해야 귀엽죠\"",
"description": "코트 밖에서는 선배들에게 '귀요미' 소리를 들을 정도지만, 경기장에서는 치열하게 싸우고 있다. 2년 차 빅맨 김도연(20·?...",
"keywords": "김도연, BNK썸, 여자농구, 빅맨, 피지컬, 귀요미",
"snippet": "BNK 김도연이 스타뉴스와 인터뷰를 하고 있다. /사진=양정웅 기자\n\n코트 밖에서는 선배들에게 '귀요미' 소리를 들을 정도?...",
"url": "https://www.starnewskorea.com/sports/2025/12/13/2025121309343422440",
"image_url": "https://thumb.mtstarnews.com/21/2025/12/2025121309343422440_1.jpg",
"language": "ko",
"published_at": "2025-12-13T01:22:42.000000Z",
"source": "star.mt.co.kr",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "ae20291f-6d14-4a46-85cd-ec8e00cad209",
"title": "김우빈, '♥신민아'가 결혼 결심할 만했네..스마트+다정+섬세 '콩콩팡팡' 역량 평가 1위",
"description": "배우 김우빈이 tvN 예능 '콩 심은 데 콩 나서 웃음팡 행복팡 해외탐방'(이하 '콩콩팡팡')에서 사람 냄새 나는 매력으로 맹?...",
"keywords": "AAA, 김우빈, 콩콩팡팡, 도경수, 이광수, 신민아",
"snippet": "/사진=tvN\n\n배우 김우빈이 tvN 예능 '콩 심은 데 콩 나서 웃음팡 행복팡 해외탐방'(이하 '콩콩팡팡')에서 사람 냄새 나는 매?...",
"url": "https://www.starnewskorea.com/broadcast-show/2025/12/13/2025121310191250108",
"image_url": "https://thumb.mtstarnews.com/21/2025/12/2025121310191250108_1.jpg",
"language": "ko",
"published_at": "2025-12-13T01:22:37.000000Z",
"source": "star.mt.co.kr",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "ef58c422-cf1c-4aa8-b8be-e0cbfa6f5a33",
"title": "Comedian Andy Dick checks himself into rehab after crack cocaine overdose",
"description": "Andy Dick is reportedly checking himself into rehab after he suffered an overdose on crack cocaine earlier this week.",
"keywords": "Celebrity News, Movies, TV, andy dick, drug overdoses, drugs, rehab",
"snippet": "Andy Dick is reportedly checking himself into rehab after he overdosed on crack cocaine earlier this week.\n\nThe “Road Trip” actor, 59, told TMZ that he’ll...",
"url": "https://pagesix.com/2025/12/12/celebrity-news/comedian-andy-dick-checks-himself-into-rehab-after-crack-cocaine-overdose/",
"image_url": "https://pagesix.com/wp-content/uploads/sites/3/2025/12/117235619.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2025-12-13T01:22:30.000000Z",
"source": "pagesix.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null
},
{
"uuid": "dab4673d-61e7-4f29-b73c-2e155b002ade",
"title": "【写真特集】写真展『プリピクテ』 「嵐」が生む不安と混乱を、再生の力と共に描いて（ニューズウィーク日本版）",
"description": "広島の原爆ドーム、消滅に向かう米ユタ州の湖、稲妻の閃光が写し取ったアマゾンのヤシの木──環境崩壊や社会不安?...",
"keywords": "",
"snippet": "写真の力を使って、サステナビリティーに関する地球規模の課題に注目を集め、議論を喚起する目的で設立された国際?...",
"url": "https://news.yahoo.co.jp/articles/c403cd3223e265aa8db767e7ce3e808e2b1b994d",
"image_url": "https://newsatcl-pctr.c.yimg.jp/t/amd-img/20251213-00010004-newsweek-000-1-view.jpg?exp=10800",
"language": "ja",
"published_at": "2025-12-13T01:20:22.000000Z",
"source": "news.yahoo.co.jp",
"categories": [],
"relevance_score": null
},
{
"uuid": "b2a93b57-a3b8-4fac-ad9f-69e77f435fd5",
"title": "XRP, 아직 2달러 못 벗어났는데...전문가들 \"2030년 전 100달러 가능\"",
"description": "엑스알피(XRP)/챗GPT생성이미지 엑스알피(XRP)가2030년이전100달러에도달할수있다는장기전망이제시되며,낮은암호화폐채...",
"keywords": "",
"snippet": "",
"url": "https://www.coinreaders.com/203975",
"image_url": "https://www.coinreaders.com/imgdata/coinreaders_com/202511/800_800_2025110724487106.jpg",
"language": "ko",
"published_at": "2025-12-13T01:20:00.000000Z",
"source": "coinreaders.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "2e7d1c16-1307-445d-ad0f-644cd01eb57a",
"title": "В Подольске Одесской области и Кировограде прогремели взрывы",
"description": "Взрывы прозвучали в Подольске Одесской области и Кировограде (украинское название - Кр?...",
"keywords": "",
"snippet": "Удары по украинской инфраструктуре ВС РФ начали наносить 10 октября 2022 года - через два д...",
"url": "https://ria.ru/20251213/ukraina-2061790155.html",
"image_url": "https://cdnn21.img.ria.ru/images/sharing/article/2061790155.jpg?19672550591765588798",
"language": "ru",
"published_at": "2025-12-13T01:19:56.000000Z",
"source": "ria.ru",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "379698e3-30b0-4838-b7d0-a1914f9cacb9",
"title": "Corinthians: processo contra Andrés é suspenso, e decisão vai para o TJ",
"description": "A juíza responsável pelo processo que envolve Andrés Sánchez, ex-presidente do Corinthians, determinou a suspensão da decisão que havia reduzido a den?...",
"keywords": "",
"snippet": "A juíza Márcia Mayumi Okoda Oshiro, responsável pelo processo que envolve Andrés Sánchez, ex-presidente do Corinthians, determinou a suspensão da decisão...",
"url": "https://www.uol.com.br/esporte/futebol/ultimas-noticias/2025/12/12/corinthians-juiza-suspende-decisao-favoravel-a-andres-apos-pedido-do-mp.htm",
"image_url": "https://conteudo.imguol.com.br/c/esporte/60/2025/12/12/andres-sanchez-ex-presidente-do-corinthians-1765572236775_v2_615x300.jpg",
"language": "pt",
"published_at": "2025-12-13T01:19:42.000000Z",
"source": "uol.com.br",
"categories": [
"tech",
"science"
],
"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: 2025-12-13T01:30:46 |
2025-12-13T01:30 |
2025-12-13T01 |
2025-12-13 |
2025-12 |
2025
|
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: 2025-12-13T01:30:46 |
2025-12-13T01:30 |
2025-12-13T01 |
2025-12-13 |
2025-12 |
2025
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-12-13
|
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=2025-12-06
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();