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-04-02
|
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": "a2e2a176-99f5-4dcb-ab04-c45cf9baa65e",
"title": "Artemis II crew greets crowds before heading to launch",
"description": "Artemis II crew greets crowds before heading to launch",
"keywords": "",
"snippet": "What value does the U.S. see in a return to the moon? 01:46",
"url": "https://www.nbcnews.com/video/shorts/artemis-ii-crew-greets-crowds-before-heading-to-launch-260530245980",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/mpx/2704722219/2026_04/Artemis_Crew_Thumb_Vert-uvlf46.jpg",
"language": "en",
"published_at": "2026-04-01T19:01:50.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "1b45b55a-98b2-4bf8-9841-09113c310929",
"title": "Artemis II is a \"GO\" for launch after safety issue, NASA says",
"description": "NASA says that a flight termination issue has been resolved and Artemis II is good to launch on Wednesday. U.S. Space Force Brigadier General Nick Hague joins CBS News to discuss.",
"keywords": "Artemis Program, Space, NASA",
"snippet": "Artemis II is a \"GO\" for launch after safety issue, NASA says NASA says that a flight termination issue has been resolved and Artemis II is good to launch on We...",
"url": "https://www.cbsnews.com/video/artemis-ii-go-launch-after-safety-issue-nasa-says/",
"image_url": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/04/01/ba95f099-3f5f-422d-822b-d019f42d6223/thumbnail/1200x630/706b8366f711e19b30c44c2494299969/cbsn-fusion-artemis-ii-go-launch-after-safety-issue-nasa-says-thumbnail.jpg",
"language": "en",
"published_at": "2026-04-01T21:30:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "3e0df62d-6367-464c-a806-451fc8458a32",
"title": "Former NASA astronauts Sen. Mark Kelly and Scott Kelly on Artemis II launch",
"description": "NASA says the Artemis II launch is now a",
"keywords": "Artemis Program, Mark Kelly, NASA, Astronaut",
"snippet": "Former NASA astronauts Sen. Mark Kelly and Scott Kelly on Artemis II launch NASA says the Artemis II launch is now a \"GO,\" after experiencing a technical issue....",
"url": "https://www.cbsnews.com/video/former-nasa-astronauts-sen-mark-kelly-scott-kelly-artemis-ii-launch/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/04/01/25170707-aa07-4e8c-8a29-5aff74211e84/thumbnail/1200x630/0e5d14decd11b4efa638ba25650c5d3a/cbsn-fusion-former-nasa-astronauts-sen-mark-kelly-scott-kelly-artemis-ii-launch-thumbnail.jpg",
"language": "en",
"published_at": "2026-04-01T21:43:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "4ae2cd60-8e88-46d7-b45a-f102d0e4f4a9",
"title": "Artemis II launch is \"America at its finest,\" Florida Rep. Mike Haridopolos says",
"description": "Florida Rep. Mike Haridopolos's district includes the Kennedy Space Center, where Artemis II is launching from on Wednesday. He joins CBS News to discuss the mission ahead of liftoff.",
"keywords": "Kennedy Space Center, Artemis Program, Florida, Space",
"snippet": "Artemis II launch is \"America at its finest,\" Florida Rep. Mike Haridopolos says Florida Rep. Mike Haridopolos's district includes the Kennedy Space Center, whe...",
"url": "https://www.cbsnews.com/video/artemis-ii-launch-america-finest-congressman-kennedy-space-center-district-says/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/04/01/534654bf-396a-4103-a0d2-7bbc5fa68486/thumbnail/1200x630/35dcac7159385ae10127e5a906b861b7/cbsn-fusion-artemis-ii-launch-america-finest-congressman-kennedy-space-center-district-says-thumbnail.jpg",
"language": "en",
"published_at": "2026-04-01T21:56:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "8291074e-0554-4f95-a7de-497137f536c0",
"title": "Breaking down the final checks ahead of Artemis II launch",
"description": "With less than an hour before the launch window opens for the Artemis II mission, NASA is going through its final checks. Retired NASA astronauts Mike Hopkins, Peggy Whitson and Nick Hague join CBS News to discuss. And CBS News' Mark Strassmann has the latest reporting on the launch.",
"keywords": "Artemis Program, Space, NASA",
"snippet": "Breaking down the final checks ahead of Artemis II launch With less than an hour before the launch window opens for the Artemis II mission, NASA is going throug...",
"url": "https://www.cbsnews.com/video/final-moments-ahead-artemis-ii-launch/",
"image_url": "https://assets2.cbsnewsstatic.com/hub/i/r/2026/04/01/176ebb7f-ce23-49b3-b623-6c28fc90a34b/thumbnail/1200x630/0890ffdd1314eb3182bde680d00e4d56/cbsn-fusion-new-issue-rises-ahead-artemis-ii-launch-thumbnail.jpg",
"language": "en",
"published_at": "2026-04-01T22:11:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "3a2de17c-9d8c-47a6-afe1-1bb185bc6ad9",
"title": "Artemis II launches, sending NASA astronauts on historic mission around the moon",
"description": "Four astronauts lifted off from Kennedy Space Center, kicking off NASA's Artemis II mission to the moon. Tony Dokoupil, Mark Strassmann, Bill Harwood and Rob Marciano have more.",
"keywords": "Kennedy Space Center, Artemis Program, NASA",
"snippet": "Artemis II launches, sending NASA astronauts on historic mission around the moon Four astronauts lifted off from Kennedy Space Center, kicking off NASA's Artemi...",
"url": "https://www.cbsnews.com/video/artemis-ii-launches-sending-nasa-astronauts-on-historic-mission-around-the-moon/",
"image_url": "https://assets2.cbsnewsstatic.com/hub/i/r/2026/04/01/c8ccedcb-7569-418a-939a-81e91a1ebb81/thumbnail/1200x630/2d47ee2c38a93469d96c671d270a0e0b/cbsn-fusion-artemis-ii-launches-sending-nasa-astronauts-on-historic-mission-around-the-moon-thumbnail.jpg",
"language": "en",
"published_at": "2026-04-01T23:17:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general"
],
"locale": "us"
}
]
},
{
"uuid": "9e22ddfa-6307-43ed-8faa-94d2fab60f8d",
"title": "Trump Says Core Objectives of Iran War Nearing Completion",
"description": "Trump announced the U.S. military's core objectives in Iran are nearing completion, and over the next two to three weeks, Iran will be sent",
"keywords": "",
"snippet": "President Donald Trump announced Wednesday night that the U.S. military’s core objectives in Iran are nearing completion, and over the next two to three weeks...",
"url": "https://www.breitbart.com/politics/2026/04/01/trump-says-core-objectives-of-iran-war-nearing-completion/",
"image_url": "https://media.breitbart.com/media/2026/04/Iran-War-Concluding-640x335.jpeg",
"language": "en",
"published_at": "2026-04-02T02:38:58.000000Z",
"source": "breitbart.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "31ed88b7-2d8f-40b7-ad81-91b975180a17",
"title": "Trump to address nation about Iran as he signals war could end within weeks",
"description": "President Donald Trump will address the nation Wednesday with an “important update\" on the Iran conflict, as U.S. operations continue and questions remain about the war’s next phase.",
"keywords": "war with iran, donald trump, iran, nato",
"snippet": "NEW You can now listen to Fox News articles!\n\nPresident Donald Trump is expected to address the nation at 9 p.m. Eastern Time Wednesday about U.S. operations in...",
"url": "https://www.foxnews.com/politics/trump-address-nation-about-iran-he-signals-war-could-end-within-weeks",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/01/trump-looks-southern-boulevard-dedication-ceremony-.jpg",
"language": "en",
"published_at": "2026-04-01T20:03:53.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "66e107ed-1dcf-4e91-9280-67448d7efd72",
"title": "Oil prices rise in choppy trade as Trump addresses the U.S. on Iran war",
"description": "Oil rose in volatile trading as Trump in his address to the nation on Iran war said that he expected the conflict to last another two to three weeks.",
"keywords": "Breaking News: Markets, Markets, Oil and Gas, Breaking News: Economy, Economy, United States, Donald Trump, @LCO26M, @LCO26U, United States Oil Fund, LP, United States Brent Oil Fund, LP, Exxon Mobil Corp, Chevron Corp, ConocoPhillips, Occidental Petroleum Equity Warrants Exp 3rd August 2027, Marathon Petroleum Corp, Valero Energy Corp, Iran, Phillips 66, Foreign policy, BP PLC, business news",
"snippet": "The Liberia-flagged crude oil tanker Shenlong Suezmax successfully docked at Mumbai Port after navigating the high-risk Strait of Hormuz amid the intensifying W...",
"url": "https://www.cnbc.com/2026/04/02/oil-prices-today-wti-brent-trump-speech-iran-war-.html",
"image_url": "https://image.cnbcfm.com/api/v1/image/108277789-1773408387563-gettyimages-2265640676-202600312-mum-rs-mn_shenlong_oil_tanker_004.jpeg?v=1775089394&w=1920&h=1080",
"language": "en",
"published_at": "2026-04-02T01:33:07.000000Z",
"source": "cnbc.com",
"categories": [
"general",
"business"
],
"locale": "us"
},
{
"uuid": "809d2207-ffb1-44c7-a7db-dd6875dae85a",
"title": "Trump says U.S. 'nearing completion' of its strategic objectives in Iran",
"description": "In his address to the nation, President Trump said that the U.S. is “nearing completion” of its strategic objectives in Iran, but did not offer specifics about when he would consider those objectives met.",
"keywords": "",
"snippet": "In his address to the nation, President Trump said that the U.S. is “nearing completion” of its strategic objectives in Iran, but did not offer specifics ab...",
"url": "https://www.nbcnews.com/video/trump-says-u-s-nearing-completion-of-its-strategic-objectives-in-iran-260554821820",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/mpx/2704722219/2026_04/1775093598556_nbc_spec_trump_nearing_completion_260401_S3_1920x1080-77w9l3.jpg",
"language": "en",
"published_at": "2026-04-02T01:33:24.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "6e51152c-77c5-46aa-8108-d6007df046f0",
"title": "Trump addresses U.S. on Iran war",
"description": "President Trump sought to assure Americans that the conflict with Iran would be brief compared to other wars in U.S. history and insisted that gas prices would go down quickly. Nancy Cordes reports.",
"keywords": "Iran, Donald Trump, Trump Administration, Middle East, Oil and Gas",
"snippet": "Trump addresses U.S. on Iran war President Trump sought to assure Americans that the conflict with Iran would be brief compared to other wars in U.S. history an...",
"url": "https://www.cbsnews.com/video/trump-addresses-us-iran-war/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/04/02/b284f9d3-b63c-4418-853c-dd35276542da/thumbnail/1200x630/2277cddb929aa822e1e16f5aff6f896a/cbsn-fusion-trump-addresses-us-iran-war-thumbnail.jpg",
"language": "en",
"published_at": "2026-04-02T01:40:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "482f665e-1bfe-45f8-8aeb-3c63b320b951",
"title": "Trump says Iran ‘no longer a threat’ after 32 days — outlines next phase of US war",
"description": "President Donald Trump declared Iran is no longer a threat after a 32-day U.S. military campaign, warning of additional strikes within two to three weeks.",
"keywords": "war with iran, white house, iran, donald trump",
"snippet": "NEW You can now listen to Fox News articles!\n\nPresident Donald Trump declared Iran is \"essentially really no longer a threat\" after a 32-day U.S. military campa...",
"url": "https://www.foxnews.com/politics/trump-says-iran-no-longer-threat-after-32-days-outlines-next-phase-us-war",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/04/trump-address-nation-iran.jpg",
"language": "en",
"published_at": "2026-04-02T01:45:06.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
}
],
"business": ...,
"sports": ...,
"tech": ...,
"science": ...,
"health": ...
}
}
Top Stories Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/top HTTP/1.1
Use this endpoint to find live and historical top stories around the world or filter to get only top stories for specific countries. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
locale |
false | Comma separated list of country codes to include in the result set. Default is all countries.
Click here for a list of supported countries.
Example: us,ca (US + Canada).
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-04-02T06:24:31 |
2026-04-02T06:24 |
2026-04-02T06 |
2026-04-02 |
2026-04 |
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-04-02T06:24:31 |
2026-04-02T06:24 |
2026-04-02T06 |
2026-04-02 |
2026-04 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-04-02
|
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": 1588926,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "28eafa0a-114e-4cac-8663-d132cbc081f6",
"title": "5 impressive ways to get up close and personal with elephants",
"description": "Take a magical safari in Botswana, visit a rehab facility in Sri Lanka and explore Elephant Valley at San Diego Zoo Safari Park.",
"keywords": "",
"snippet": "Elephants are among the planet’s most majestic creatures, gentle giants who walk steadfastly through the savannas, forests and deserts of Africa and Asia. The...",
"url": "https://theweek.com/culture-life/travel/where-to-see-elephants-africa-asia-san-diego-safari-park",
"image_url": "https://cdn.mos.cms.futurecdn.net/FmVw2wMAQ2Ngwts9QSEnJj-2000-80.jpg",
"language": "en",
"published_at": "2026-04-02T06:00:00.000000Z",
"source": "theweek.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "6fab1642-69f8-4799-95e1-a727df6bbff4",
"title": "Bay Area father accused of slashing throats of his wife, her mother charged in separate SoCal murder",
"description": "Howard Wang, 43, was charged in the September 2025 killings of his wife, Linlin Guo, 37, and her mother, Beimin Cheng, who were found were their throats slashed...",
"keywords": "Metro, US News, california, los angeles, murders, serial killers",
"snippet": "A Bay Area husband accused of brutally killing his wife and mother-in-law at their home while his young twin daughters were nearby is now facing a third murder ...",
"url": "https://nypost.com/2026/04/02/us-news/bay-area-father-howard-wang-accused-of-slashing-throats-of-his-wife-her-mother-charged-in-separate-socal-murder/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/04/comp-wang-murder.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-04-02T05:54:58.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "e4ccea57-f07e-4582-a336-5b1a774a7991",
"title": "Howie Mandel ‘Kinda’ Regrets Apologizing to Kelly Ripa After Awkward Interview",
"description": "Howie Mandel has admitted that he ‘kinda’ regrets publicly apologizing to Kelly Ripa following their awkward interview on ‘Live with Kelly and Mark’",
"keywords": "",
"snippet": "Howie Mandel has admitted that he has mixed feelings about apologizing to Kelly Ripa after their awkward interview on Live with Kelly and Mark.\n\n“If somebody ...",
"url": "https://www.usmagazine.com/celebrity-news/news/howie-mandel-kinda-regrets-apologizing-to-kelly-ripa/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/04/Howie-Mandel-Kinda-Regrets-Apologizing-to-Kelly-Ripa-e1775107697591.jpg?crop=0px%2C0px%2C2000px%2C1051px&resize=1200%2C630&quality=55&strip=all",
"language": "en",
"published_at": "2026-04-02T05:40:50.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "363308f9-17ee-4d00-9c5a-1ae87315e7bd",
"title": "World Cup ticket prices soar as FIFA reopens glitch-prone sales",
"description": "The top ticket price for the World Cup final hit $10,990 as FIFA reopened sales on Wednesday.",
"keywords": "",
"snippet": "Gab Marcotti reacts to Italy failing to qualify for a third straight World Cup after losing to Bosnia and Herzegovina on penalties. (1:37)\n\nOpen Extended Reacti...",
"url": "https://www.espn.com/soccer/story/_/id/48369993/world-cup-ticket-sales-fifa-website-last-minute-buy",
"image_url": "https://a2.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0401%2Fr1637249_1296x729_16%2D9.jpg",
"language": "en",
"published_at": "2026-04-02T05:38:33.000000Z",
"source": "espn.com",
"categories": [
"sports",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "f22a68f6-30f2-44e4-b7e3-ab6149055425",
"title": "SKK Holdings (SKK) Stock Surges 15% After Hours: Here's What You Should Know - SKK Holdings (NASDAQ:SKK)",
"description": "SKK Holdings surged 15% after hours to $0.22 after the board approved a 10-for-1 reverse stock split, which will automatically consolidate shares and keep the t...",
"keywords": "",
"snippet": "SKK Holdings (NASDAQ:SKK) shares surged 15.38% after hours to $0.22 Wednesday after the board approved a 10-for-1 reverse stock split, effective Apr. 6, aimed a...",
"url": "https://www.benzinga.com/markets/equities/26/04/51617575/skk-holdings-skk-stock-surges-15-after-hours-heres-what-you-should-know",
"image_url": "https://cdn.benzinga.com/files/images/story/2026/04/02/Productivity-Surge-May-Be-One-Answer.jpeg?width=1200&height=800&fit=crop",
"language": "en",
"published_at": "2026-04-02T05:38:04.000000Z",
"source": "benzinga.com",
"categories": [
"business"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "4e48d46d-38b9-4d34-98e9-b2cad1b7035b",
"title": "PMGC Holdings Dips 50% After Massive Rally: What's Going On With ELAB Stock - PMGC Holdings (NASDAQ:ELAB)",
"description": "PMGC Holdings (ELAB) spiked 133% to 14.00 then sank 50% after hours to 7.00 after a $4.55m ELOC draw, the fourth under its $20m line, raising dilution fears.",
"keywords": "",
"snippet": "Details On Deals, Agreements\n\nExecutive Quotes\n\nPMGC Holdings emphasizes its acquisition-focused strategy: \"At PMGC, we're buying, holding legacies. Our focus i...",
"url": "https://www.benzinga.com/markets/equities/26/04/51617563/pmgc-holdings-elab-stock-dips-50-percent-after-rally",
"image_url": "https://cdn.benzinga.com/files/images/story/2026/04/02/Red-Glowing-Candlestick-Chart-On-Dark-Ba.jpeg?width=1200&height=800&fit=crop",
"language": "en",
"published_at": "2026-04-02T05:34:35.000000Z",
"source": "benzinga.com",
"categories": [
"business"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "ebacaf60-fae3-48ed-855e-080c3258eafb",
"title": "Did ‘Chicago Med’ Kill Off a Beloved Main Character Ahead of Show’s Season Finale?",
"description": "'Chicago Med' is causing concern after putting a beloved character's future at risk — but did they officially get killed off?",
"keywords": "",
"snippet": "Chicago Med is causing concern after putting a beloved character’s future at risk — but did they officially get killed off?\n\nDuring the Wednesday, April 1, ...",
"url": "https://www.usmagazine.com/entertainment/news/did-chicago-med-kill-off-oliver-platts-dr-charles-before-finale/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/04/NUP_207012_02894.jpg?w=1000&h=630&crop=1&quality=86&strip=all",
"language": "en",
"published_at": "2026-04-02T05:30:51.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "3bc8b8eb-aea1-48a2-93b2-9fb120caad67",
"title": "Suspect appears to push man into oncoming train path",
"description": "Suspect appears to push man into oncoming train path",
"keywords": "",
"snippet": "IE 11 is not supported. For an optimal experience visit our site on another browser.",
"url": "https://www.nbcnews.com/video/shorts/suspect-appears-to-push-man-into-oncoming-train-path-260565061936",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/mpx/2704722219/2026_04/thumb-jnck97.jpg",
"language": "en",
"published_at": "2026-04-02T05:14:55.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "9cbe438d-b4e0-4e0e-8685-e194f7a5d39e",
"title": "Florida Democratic Party vice chair found dead in home, husband arrested",
"description": "Nancy Metayer Bowen, the vice chair of Florida's Democratic Party who was planning on running for Congress was found dead in her home Wednesday morning and her ...",
"keywords": "politics, US News, democrats, domestic violence, florida, politicians",
"snippet": "The vice chair of Florida’s Democratic Party who was reportedly planning a run for Congress was found dead in her home Wednesday morning and her husband was a...",
"url": "https://nypost.com/2026/04/02/us-news/florida-democratic-party-vice-chair-found-dead-in-home-husband-arrested/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/04/Untitled-1-59.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-04-02T05:12:15.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "0849430f-ed5c-43b2-af29-93e3e762b2b7",
"title": "Globus Maritime (GLBS) Stock Surges Over 15% After Hours: Here's Why - Globus Maritime (NASDAQ:GLBS)",
"description": "Globus Maritime shares surged over 15% after hours following an insider purchase by director Georgios Feidakis's affiliate.",
"keywords": "",
"snippet": "Firment Shipping is a Marshall Islands–incorporated shipping investment holding company.\n\nInsider Buying\n\nFeidakis purchased shares on Tuesday at a weighted-a...",
"url": "https://www.benzinga.com/markets/equities/26/04/51617506/globus-maritime-glbs-stock-surges-over-15-percent-after-hours-heres-why",
"image_url": "https://cdn.benzinga.com/files/images/story/2026/04/02/Stock-Market-Analysis-Shows-Trading-Patt.jpeg?width=1200&height=800&fit=crop",
"language": "en",
"published_at": "2026-04-02T05:08:37.000000Z",
"source": "benzinga.com",
"categories": [
"business"
],
"relevance_score": null,
"locale": "us"
}
]
}
All News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/all HTTP/1.1
Use this endpoint to find all live and historical articles we collect. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-04-02T06:24:31 |
2026-04-02T06:24 |
2026-04-02T06 |
2026-04-02 |
2026-04 |
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-04-02T06:24:31 |
2026-04-02T06:24 |
2026-04-02T06 |
2026-04-02 |
2026-04 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-04-02
|
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": 54290064,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "71bc83ca-5fe9-4798-b8e6-88de2427f08b",
"title": "微軟直接在 Copilot 使用條款裡面說 Copilot 是娛樂用途",
"description": "微軟直接在 Copilot 使用條款裡面說 Copilot 是娛樂用途,Computer Murmuring Network Recreation Service , IT社区推荐资讯",
"keywords": "Computer Murmuring Network Recreation Service, copilot copilot",
"snippet": "在「 Microsoft Copilot Terms of Use ( via)」這邊看到的，微軟直接在 Copilot 的使用條款裡面這樣寫 for entertainment purposes only：\n\nCopi...",
"url": "https://itindex.net/detail/63188-copilot-copilot",
"image_url": "",
"language": "zh",
"published_at": "2026-04-02T06:24:59.000000Z",
"source": "itindex.net",
"categories": [
"tech"
],
"relevance_score": null
},
{
"uuid": "0208330d-ad25-4923-909f-274c7501b3a2",
"title": "WTI '꺾이자'...국제 금값 '다시 활기', 은값도 '반등 가담'",
"description": "[초이스경제 최원석 기자] 1일(미국시간) 뉴욕시장에서 국제 유가와 천연가스 가격 하락 속에 미국달러가치도 떨어졌다. ...",
"keywords": "",
"snippet": "골드바와 실버바. /사진=뉴시스\n\n[초이스경제 최원석 기자] 1일(미국시간) 뉴욕시장에서 국제 유가와 천연가스 가격 하락 ...",
"url": "http://www.choicenews.co.kr/news/articleView.html?idxno=163178",
"image_url": "https://cdn.choicenews.co.kr/news/thumbnail/202604/163178_123368_2325_v150.jpg",
"language": "ko",
"published_at": "2026-04-02T06:24:04.000000Z",
"source": "choicenews.co.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "db588223-e845-46ef-aac0-9fa0efe2e9cd",
"title": "70억 개 썰물처럼 빠져나간 XRP, 54% 폭락 징크스 깰 수 있을까",
"description": "엑스알피(XRP)하락/챗GPT생성이미지 © 엑스알피(XRP,리플)가70억개라는기록적인거래소유출물량에도불구하고,과거최대54...",
"keywords": "",
"snippet": "",
"url": "https://www.coinreaders.com/228259",
"image_url": "https://www.coinreaders.com/imgdata/coinreaders_com/202601/800_800_2026011956441690.png",
"language": "ko",
"published_at": "2026-04-02T06:24:00.000000Z",
"source": "coinreaders.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "a416d9eb-2749-4f98-9d98-cf270b539f5c",
"title": "Artemis 2 erfolgreich gestartet: Ein Zeichen der Stärke",
"description": "In Florida sind vier Astronauten erfolgreich zum Mond gestartet. Es ist die erste Mission seit einem halben Jahrhundert.",
"keywords": "",
"snippet": "afp | Ein Flug „für die gesamte Menschheit“: Nach mehr als 50 Jahren haben sich mit der historischen Mission Artemis 2 wieder Astronauten auf den Weg zum M...",
"url": "https://taz.de/Artemis-2-erfolgreich-gestartet/!6167981//",
"image_url": "https://taz.de/picture/8358142/1200/40851667.jpeg",
"language": "de",
"published_at": "2026-04-02T06:23:00.000000Z",
"source": "taz.de",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "e5ef4e55-dddd-41e7-bd33-85a669c18b6e",
"title": "イラン情勢で重要演説へ トランプ氏、戦闘終結焦点",
"description": "【ワシントン共同】トランプ米大統領は米東部時間1日午後9時（日本時間2日午前10時）からイラン情勢について国民向?...",
"keywords": "西日本新聞me, 西日本新聞, ニュース, 九州, 福岡",
"snippet": "【ワシントン共同】トランプ米大統領は米東部時間1日午後9時（日本時間2日午前10時）からイラン情勢について国民向?...",
"url": "https://www.nishinippon.co.jp/item/1477195/",
"image_url": "https://www.nishinippon.co.jp/uploads/image/1885683/sns_PN2026040201000193.-.-.CI0003.jpg",
"language": "ja",
"published_at": "2026-04-02T06:21:43.000000Z",
"source": "nishinippon.co.jp",
"categories": [],
"relevance_score": null
},
{
"uuid": "19eeec1f-7bc8-4e0f-bd4d-1a5b536063b3",
"title": "Raptors fail test against Kings as DeRozan, Achiuwa burn former team",
"description": "A home game against the Kings was supposed to be an open-book test. The Raptors flunked it.\n\nAnd it was two former Raptors who played starring roles for the Kin...",
"keywords": "",
"snippet": "TORONTO — The downside of playing meaningful basketball in the late stage of the NBA season is that you can fail.\n\nOn Wednesday night, the Toronto Raptors fai...",
"url": "https://www.sportsnet.ca/nba/article/raptors-fail-test-against-kings-as-derozan-achiuwa-burn-former-team/",
"image_url": "https://www.sportsnet.ca/wp-content/uploads/2026/04/derozan_demar1280-1.jpg",
"language": "en",
"published_at": "2026-04-02T06:21:37.000000Z",
"source": "sportsnet.ca",
"categories": [
"sports"
],
"relevance_score": null
},
{
"uuid": "bf9563f3-d121-47d2-921c-70d805feb61b",
"title": "볼러틸리티쉐어스, ADA·XLM·LINK 2배 레버리지 ETF 출시",
"description": "미국펀드운용사볼러틸리티쉐어스(VolatilityShares)가카르다노(ADA),스텔라(XLM),체인링크(LINK)기반2배레버리지ETF3종을출시했?...",
"keywords": "",
"snippet": "",
"url": "https://www.coinreaders.com/228261",
"image_url": "http://www.coinreaders.com/data/coinreaders_com/banner/favicon.ico",
"language": "ko",
"published_at": "2026-04-02T06:21:27.000000Z",
"source": "coinreaders.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "86114177-4fcb-4f0e-938e-8a09d61528e1",
"title": "Trump: w ciągu następnych dwóch-trzech tygodni będziemy mocno atakować Iran",
"description": "W ciągu następnych dwóch-trzech tygodni będziemy mocno atakować Iran, ten kraj powróci do epoki kamienia - zapowiedział w orędziu do narodu prezydent US...",
"keywords": "",
"snippet": "Donald Trump powiedział, że Amerykanie są blisko zrealizowania głównych celów strategicznych operacji w Iranie. - Zakończymy to bardzo szybko. Jesteśmy ...",
"url": "https://www.pb.pl/trump-w-ciagu-nastepnych-dwoch-trzech-tygodni-bedziemy-mocno-atakowac-iran-1259007",
"image_url": "https://images.pb.pl/filtered/b6707c9c-5c4a-452d-bc00-6f771a517d7a/7f90b4f6-76bf-5b77-bfe8-e24f1e217975_og_1200_630.jpg",
"language": "pl",
"published_at": "2026-04-02T06:21:23.000000Z",
"source": "pb.pl",
"categories": [
"business"
],
"relevance_score": null
},
{
"uuid": "71d1fcf4-ae42-4a81-b77a-726d0ebd7a60",
"title": "이란 대통령, 미국민에 서한…",
"description": "이란 전쟁이 종전에 가까워졌다는 관측이 제기되는 가운데 마수드 페제시키안 이란 대통령이 1일(현지시간) 미국민을 대...",
"keywords": "",
"snippet": "마수드 페제시키안 이란 대통령.\n\n연합뉴스 자료사진.\n\n(서울=연합인포맥스) 김성진 기자 = 이란 전쟁이 종전에 가까워졌?...",
"url": "https://news.einfomax.co.kr/news/articleView.html?idxno=4407290",
"image_url": "https://cdn.news.einfomax.co.kr/news/thumbnail/202604/4407290_305026_223_v150.jpg",
"language": "ko",
"published_at": "2026-04-02T06:21:05.000000Z",
"source": "news.einfomax.co.kr",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "3cf24349-1644-4154-ae99-f1f65cb1a785",
"title": "\"비트코인 쟁여라\"...애리조나, 국가급 '코인 비축' 직전",
"description": "비트코인(BTC),미국/챗GPT생성이미지 애리조나주가비트코인과XRP를공식자산으로비축하는법안최종표결을눈앞에두며미...",
"keywords": "",
"snippet": "",
"url": "https://www.coinreaders.com/228258",
"image_url": "https://www.coinreaders.com/imgdata/coinreaders_com/202510/768_512_2025102930468045.jpg",
"language": "ko",
"published_at": "2026-04-02T06:20:00.000000Z",
"source": "coinreaders.com",
"categories": [],
"relevance_score": null
}
]
}
Similar News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/similar/uuid HTTP/1.1
Use this endpoint to find similar stories to a specific article based on its UUID.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-04-02T06:24:31 |
2026-04-02T06:24 |
2026-04-02T06 |
2026-04-02 |
2026-04 |
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-04-02T06:24:31 |
2026-04-02T06:24 |
2026-04-02T06 |
2026-04-02 |
2026-04 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-04-02
|
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-03-26
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();