Documentation
Sign up for free!
Get instant access to the API with your free API token. No billing details required!
Getting Started
Introduction
Our API was developed to provide global news from thousands of sources with exceptional response times. On average we add over 1 million articles weekly, so you will never be short of content. Even better, it is completely free!
To get started simply sign up and use your API token in any of the available API endpoints documented below for instant access.
If you have any questions or concerns, feel free to contact us.
Authentication
As mentioned above, when you sign up for free you will find your API token on your dashboard. Simply add this to any of our API endpoints as a GET parameter to gain access. Examples of how this is done can be found below.
API Endpoints
Headlines Available on: Standard plan and above
Endpoint
GET https://api.thenewsapi.com/v1/news/headlines HTTP/1.1
Use this endpoint to find get the latest headlines by category along with similar articles, allowing you to create the perfect news aggregation page similar to Google News .
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
locale |
false | Comma separated list of country codes to include in the result set. Default is all countries.
Click here for a list of supported countries.
Example: us,ca (US + Canada).
|
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_on |
false | Find headlines for articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-07-16
|
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": "bf187ddc-62db-48f8-9687-1f8453509d82",
"title": "Inglaterra ha llegado a Atlanta para encarar el duelo ante Argentina en semifinales",
"description": "Los Tres Leones se hacen presentes en Atlanta para el reto que presenta Argentina y Lionel Messi, que defenderán su pase a una final más y buscarán el bicampeonato. Bellingham y compañía quieren romper la sequía y conseguir el boleto a la gran final.",
"keywords": "",
"snippet": "Los Tres Leones se hacen presentes en Atlanta para el reto que presenta Argentina y Lionel Messi, que defenderán su pase a una final más y buscarán el bicamp...",
"url": "https://www.telemundo.com/deportes/copa-mundial-de-la-fifa-2026/video/inglaterra-ha-llegado-a-atlanta-para-encarar-el-duelo-ante-argentina-en-semifinales-tmvo13204117",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/telemundocms/MPX/image/NBCU_Telemundo/500/707/47181436300-1080pnbcstations.jpg",
"language": "en",
"published_at": "2026-07-15T17:55:18.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "5bcbcb0f-6193-4a68-b1f9-3a8373e57985",
"title": "¿Quién se llevará la victoria en el sexto choque mundialista entre Argentina e Inglaterra?",
"description": "El actual campeón del mundo llega al Estadio Atlanta para lograr conseguir el último boleto del Mundial 2026. Argentina e Inglaterra se han enfrentado 5 veces en mundiales: 3 victorias se las ha llevado el equipo inglés y dos han sido para Argentina.",
"keywords": "",
"snippet": "¿Quién se llevará la victoria en el sexto choque mundialista entre Argentina e Inglaterra?\n\nEl actual campeón del mundo llega al Estadio Atlanta para lograr...",
"url": "https://www.telemundo.com/deportes/copa-mundial-de-la-fifa-2026/video/quien-se-llevara-la-victoria-en-el-sexto-choque-mundialista-entre-argentina-e-inglaterra-tmvo13204119",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/telemundocms/MPX/image/NBCU_Telemundo/503/634/47181541729-1080pnbcstations.jpg",
"language": "en",
"published_at": "2026-07-15T17:56:31.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "c3bb15f1-9bb8-4fe8-9e95-c3440b792334",
"title": "Scaloni celebra el pase de Argentina a la final: “Somos únicos”",
"description": "Argentina venció 2-1 a Inglaterra en una histórica semifinal donde remontaron el partido. Al finalizar las acciones, Scaloni se deshizo en elogios para sus jugadores y su afición, destacando el enorme trabajo que han tenido todos para volver a la final.",
"keywords": "",
"snippet": "Argentina venció 2-1 a Inglaterra en una histórica semifinal donde remontaron el partido. Al finalizar las acciones, Scaloni se deshizo en elogios para sus ju...",
"url": "https://www.telemundo.com/deportes/copa-mundial-de-la-fifa-2026/video/scaloni-celebra-el-pase-de-argentina-a-la-final-somos-unicos-tmvo13204157",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/telemundocms/MPX/image/NBCU_Telemundo/520/227/47184637386-1080pnbcstations.jpg",
"language": "en",
"published_at": "2026-07-15T21:16:53.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "1db950b1-9639-4f66-b8a5-f9466a420465",
"title": "Argentina sobrevive a Inglaterra y Messi disputará otra Final del Mundial",
"description": "La Final del Mundial 2026 tendrá sabor a Finalissima tras la remontada de Argentina sobre Inglaterra con goles de Enzo Fernández y Lautaro Martínez.",
"keywords": "",
"snippet": "España celebra su pase a la final y Francia admite sus errores | Voces del Mundial 07:56",
"url": "https://www.telemundo.com/deportes/copa-mundial-de-la-fifa-2026/video/argentina-sobrevive-a-inglaterra-y-messi-disputara-otra-final-del-mundial-tmvo13204163",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/telemundocms/MPX/image/NBCU_Telemundo/523/155/47185136301-1080pnbcstations.jpg",
"language": "en",
"published_at": "2026-07-15T21:52:00.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "51919a96-1a67-4ee8-a07a-067f3ee3e327",
"title": "Locura argentina en las gradas tras una remontada histórica ante Inglaterra por el pase a la final",
"description": "Los fanáticos ingleses dominaban el partido, pero una reacción agónica de Argentina y un gol de Lautaro Martínez al final desataron la locura albiceleste, dejando devastada a la afición de Inglaterra a un paso de la gran final.",
"keywords": "",
"snippet": "Locura argentina en las gradas tras una remontada histórica ante Inglaterra por el pase a la final\n\nLos fanáticos ingleses dominaban el partido, pero una reac...",
"url": "https://www.telemundo.com/deportes/copa-mundial-de-la-fifa-2026/video/locura-argentina-en-las-gradas-tras-una-remontada-historica-ante-inglaterra-por-el-pase-a-la-final-tmvo13204171",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/telemundocms/MPX/image/NBCU_Telemundo/529/10/47185427432-1080pnbcstations.jpg",
"language": "en",
"published_at": "2026-07-15T22:12:24.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "0ebcb1c6-b1db-437c-bf65-7044f2ee2c60",
"title": "Argentina remonta a Inglaterra y ya está en la gran final del Mundial | Todo el Mundial",
"description": "Maxi Rodríguez y José Néstor Pekerman analizaron la remontada de Argentina sobre Inglaterra para clasificar a la final de la Copa Mundial de la FIFA 2026. Destacaron que tras el primer gol inglés, tomó el control absoluto del encuentro.",
"keywords": "",
"snippet": "Argentina remonta a Inglaterra y ya está en la gran final del Mundial | Todo el Mundial\n\nMaxi Rodríguez y José Néstor Pekerman analizaron la remontada de Ar...",
"url": "https://www.telemundo.com/deportes/copa-mundial-de-la-fifa-2026/video/argentina-remonta-a-inglaterra-y-ya-esta-en-la-gran-final-del-mundial-todo-el-mundial-tmvo13204181",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/telemundocms/MPX/image/NBCU_Telemundo/526/83/47185607903-1080pnbcstations.jpg",
"language": "en",
"published_at": "2026-07-15T22:25:53.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
},
{
"uuid": "414e6c7f-1de9-4e5d-89b5-df951254affd",
"title": "Argentina advances to the World Cup final with 2-1 win over England",
"description": "Argentina will face Spain in the World Cup final on Sunday, July 19.",
"keywords": "",
"snippet": "Argentina will advance to the 2026 World Cup final after defeating England 2-1 on Wednesday.\n\nSpain and Argentina will now face each other to determine the winn...",
"url": "https://abcnews.com/GMA/Culture/argentina-advances-world-cup-final-2-1-win/story?id=134680234",
"image_url": "https://i.abcnewsfe.com/a/fa437178-f26d-4a69-9f5a-50091c72da88/wc-11-gty-gmh-260715_1784149262848_hpMain_16x9.jpg?w=1600",
"language": "en",
"published_at": "2026-07-15T21:21:19.000000Z",
"source": "abcnews.go.com",
"categories": [
"general"
],
"locale": "us",
"similar": [
{
"uuid": "be088484-55cd-4e9a-bd92-0131ac0c9d36",
"title": "Timothée Chalamet has priceless reaction after meeting Cowboys cheerleaders at World Cup",
"description": "Timothée Chalamet attended the World Cup semifinal between Spain and France at AT&T Stadium, and was left starstruck by the Dallas Cowboys cheerleaders.",
"keywords": "sports, the world cup, dallas cowboys, nfl, soccer",
"snippet": "NEW You can now listen to Fox News articles!\n\nIt’s not often that actor Timothée Chalamet is starstruck, but that’s what the Dallas Cowboys cheerleaders ca...",
"url": "https://www.foxnews.com/sports/timothee-chalamet-priceless-reaction-meeting-cowboys-cheerleaders-world-cup",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/07/Timothee_Chalamet_looks_on_World_Cup.jpg",
"language": "en",
"published_at": "2026-07-15T18:29:13.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "4b76e6f9-6063-49cd-8fcc-3ba116ae34f7",
"title": "Argentina rallies past bitter rival England to book spot in World Cup final",
"description": "Defending World Cup champion Argentina rallied to edge England 2-1 to advance to Sunday's final at MetLife Stadium, where they will face Spain.",
"keywords": "Lionel Messi, Argentina, World Cup, England",
"snippet": "One of the most bitter rivalries in international soccer wrote a new chapter in its contentious series Wednesday, when defending World Cup champions Argentina r...",
"url": "https://www.cbsnews.com/news/argentina-beats-england-world-cup-final/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/07/15/411c51fc-4cdf-4257-a45d-be0a40fe2916/thumbnail/1200x630/e34ce6adb06f231072e76286f2fab2b0/gettyimages-2285640053.jpg",
"language": "en",
"published_at": "2026-07-15T21:08:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "1f389d83-1a17-455a-a7cc-53d09ae5c4aa",
"title": "Argentina stuns England with thrilling comeback to advance to World Cup final against Spain",
"description": "Argentina stunned England 2-1 in the World Cup semifinal as Lionel Messi assisted goals by Enzo Fernandez and Lautaro Martinez to complete a dramatic comeback.",
"keywords": "the world cup, soccer, sports",
"snippet": "NEW You can now listen to Fox News articles!\n\nArgentina, never say die.\n\nOnce again, the Argentines came from behind, this time against England, to win 2-1 in t...",
"url": "https://www.foxnews.com/sports/argentina-stuns-england-thrilling-comeback-advance-world-cup-final-against-spain",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/07/Argentina_celebrates_win.jpg",
"language": "en",
"published_at": "2026-07-15T21:51:03.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "87096f3d-b357-4cab-aaba-e1b78330dbbd",
"title": "Argentina stuns England in World Cup semifinal with late comeback",
"description": "One of the World Cup's great rivalries ended with one of the World Cup's best comebacks. Argentina scored two goals in seven minutes, stunning England 2-1 in Wednesday's semifinal. Lionel Messi had two assists, including on the winning goal in the final minutes. Nicole Valdes reports.",
"keywords": "Argentina, World Cup, England",
"snippet": "Argentina stuns England in World Cup semifinal with late comeback One of the World Cup's great rivalries ended with one of the World Cup's best comebacks. Argen...",
"url": "https://www.cbsnews.com/video/argentina-stuns-england-world-cup-semifinal-late-comeback/",
"image_url": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/07/16/bf9c4152-348c-470a-a620-de293b8e5974/thumbnail/1200x630/d66b9768b10beddfef0b4d2f5badf774/gettyimages-2285640352.jpg",
"language": "en",
"published_at": "2026-07-15T22:40:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
}
],
"business": ...,
"sports": ...,
"tech": ...,
"science": ...,
"health": ...
}
}
Top Stories Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/top HTTP/1.1
Use this endpoint to find live and historical top stories around the world or filter to get only top stories for specific countries. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
locale |
false | Comma separated list of country codes to include in the result set. Default is all countries.
Click here for a list of supported countries.
Example: us,ca (US + Canada).
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-07-16T05:10:01 |
2026-07-16T05:10 |
2026-07-16T05 |
2026-07-16 |
2026-07 |
2026
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-07-16T05:10:01 |
2026-07-16T05:10 |
2026-07-16T05 |
2026-07-16 |
2026-07 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-07-16
|
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": 1666085,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "e4cf0509-0d9f-4b4f-924b-791904fd0a8e",
"title": "Search ends for 3 missing after deadly San Francisco Bay boat accident",
"description": "The boat was carrying 20 family members and friends from Stockton who had gathered to scatter a loved one's ashes during a memorial service.",
"keywords": "Metro, US News, boat crashes, california, san francisco",
"snippet": "See more of our coverage in your search results.\n\nThe search for three people missing after a memorial trip on San Francisco Bay turned deadly came to an end We...",
"url": "https://nypost.com/2026/07/16/us-news/search-ends-for-3-missing-after-san-francisco-bay-memorial-boat-capsizes-leaving-1-dead/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/07/AP_Boat_Accident_San_Francisco_31587-de75b-0.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-07-16T04:51:16.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "4277e1eb-28bd-415b-b693-f5f4af06d789",
"title": "Scaloni: \"Ojalá los españoles estén contentos de que Argentina esté en la Final por Messi\"",
"description": "El DT campeón del mundo elogió a sus jugadores tras vencer a Inglaterra, defendió a su capitán como el mejor de todos los tiempos y advirtió que aunque tie...",
"keywords": "",
"snippet": "Scaloni: \"Ojalá los españoles estén contentos de que Argentina esté en la Final por Messi\"\n\nEl DT campeón del mundo elogió a sus jugadores tras vencer a I...",
"url": "https://www.telemundo.com/deportes/copa-mundial-de-la-fifa-2026/video/scaloni-ojala-los-espanoles-esten-contentos-de-que-argentina-este-en-la-final-por-messi-tmvo13204359",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/telemundocms/MPX/image/NBCU_Telemundo/561/243/47190697536-1080pnbcstations.jpg",
"language": "en",
"published_at": "2026-07-16T04:13:54.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "b4426153-e450-4ae3-aba0-f64d89fe43b6",
"title": "Marcello Hernández roasts Jake Paul, Tiger Woods and Bill Belichick in ESPYS monologue",
"description": "The 2026 ESPYS, hosted by Marcello Hernandez, also honored Jason Collins posthumously with the Arthur Ashe Award and Jim Abbott with the Jimmy V Award.",
"keywords": "sports, events, entertainment, trending news, saturday night live",
"snippet": "NEW You can now listen to Fox News articles!\n\nThe ESPYS brought some of the biggest names in sports and entertainment to New York City on Wednesday night, a day...",
"url": "https://www.foxnews.com/sports/marcello-hernandez-roasts-jake-paul-tiger-woods-bill-belichick-espys-monologue",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/07/Marcello-Hernandez-ESPY-Awards-stage.jpg",
"language": "en",
"published_at": "2026-07-16T04:06:41.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "474ab1bd-e4c4-490d-b36a-a9ece547ae9d",
"title": "Katie Porter says she’s done with politics after failed governor bid as she teases next chapter",
"description": "Katie Porter is leaving politics to return to teaching following a fifth-place finish in the 2026 California gubernatorial primary election.",
"keywords": "Metro, US News, california, california governor election 2026, democrats, government, Katie Porter",
"snippet": "See more of our coverage in your search results.\n\nKatie Porter is turning the page on politics after a bruising California governor campaign that ended in defea...",
"url": "https://nypost.com/2026/07/16/us-news/katie-porter-quits-politics-after-failed-california-governor-bid/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/07/134545915.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-07-16T04:05:28.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "14ac6f98-d0a0-46a2-abb1-e59078514a03",
"title": "Lindsey Graham’s final act reverberates in Senate as sister is urged to “keep pedaling\"",
"description": "Darline Graham was appointed to the South Carolina Senate seat held by her late brother Lindsey Graham. Gov. Henry McMaster called it an honor to ask her to ser...",
"keywords": "lindsey graham, mitch mcconnell, senate elections, politics, south carolina",
"snippet": "NEW You can now listen to Fox News articles!\n\nIt was 2:35 am et Sunday.\n\nThe phone rang, yanking me out of deep slumber.\n\nCalls like these are never good.\n\nIn t...",
"url": "https://www.foxnews.com/politics/lindsey-grahams-final-act-reverberates-senate-sister-urged-keep-pedaling",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/07/Darline_Lindsey_Graham.jpg",
"language": "en",
"published_at": "2026-07-16T04:00:46.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "86643128-a31c-4148-9795-613edbabda93",
"title": "What credit score do you need for the lowest mortgage rates right now? Experts weigh in",
"description": "Having a high credit score can translate into big savings on your mortgage loan, but how high does it need to be?",
"keywords": "",
"snippet": "We may receive commissions from some links to products on this page. Promotions are subject to availability and retailer terms.\n\nMortgage rates aren't set in st...",
"url": "https://www.cbsnews.com/news/credit-score-required-lowest-mortgage-rates-experts-weigh-in/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/07/15/07c64f33-7791-4e0a-a804-662baff4fd11/thumbnail/1200x630/6c5ec43aaa9e36caae38f830f68d9322/gettyimages-1266971215.jpg",
"language": "en",
"published_at": "2026-07-16T04:00:17.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "ed65bd1f-5eae-4bc8-b1e9-8469aceccefe",
"title": "Family of dead SF cyclist wants millions after he was car-doored by city worker",
"description": "The family of a cyclist who died after being struck by a city worker's car door in Northern California is on the verge of winning a massive settlement of $2 mil...",
"keywords": "Metro, US News, Bay Area, biking, california, cyclists, deaths, Northern California, san francisco, settlements",
"snippet": "See more of our coverage in your search results.\n\nThe family of a cyclist who died after being struck by a city worker’s car door in Northern California is on...",
"url": "https://nypost.com/2026/07/15/us-news/family-of-dead-sf-cyclist-nears-2m-settlement-after-his-death/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/07/134541467.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-07-16T03:43:15.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "3d02c74f-cf73-4c1d-94d7-32367f8dda85",
"title": "US strikes targets in northern Iran as it also disables ship trying to run the blockade",
"description": "The United States intensified its strikes targeting Iran early Thursday, hitting targets further north as American forces also fired into a ship it accused of t...",
"keywords": "Iran, President Donald Trump, naval blockade, Strait of Hormuz, Tehran",
"snippet": "DUBAI, United Arab Emirates (AP) — The United States intensified its strikes targeting Iran early Thursday, hitting targets further north as American forces a...",
"url": "https://www.yahoo.com/news/world/articles/jordan-says-shot-down-iranian-034143816.html",
"image_url": "https://s.yimg.com/lo/mysterio/api/a44d55e6e387fab99888181adcdc96e3c973ae60455ecd052cd7ea19b2f10f1d/lightyear_networkapi/resizefill_w1200;quality_80;format_webp/https:%2F%2Fmedia.zenfs.com%2Fen%2Fap.org%2Fce578e30f9d4709483934b0060579030",
"language": "en",
"published_at": "2026-07-16T03:41:43.000000Z",
"source": "yahoo.com",
"categories": [
"general",
"business",
"sports",
"entertainment"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "6e76b40f-b505-4037-b692-265b18181f03",
"title": "Sam Neill’s Cause of Death Revealed After ‘Jurassic Park’ Actor Died at Age 78",
"description": "Sam Neill's official cause of death has been revealed after the 'Jurassic Park' actor died at 87 following his cancer-free diagnosis in April",
"keywords": "",
"snippet": "Sam Neill‘s official cause of death has been revealed.\n\n“Since Sam Neill’s passing, several stories have appeared in the media which contain inaccuracies ...",
"url": "https://www.usmagazine.com/celebrity-news/news/sam-neills-cause-of-death-revealed-after-jurassic-park-actor-died-at-age-78/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/07/sam-neill-cause-of-death-feature.jpg?crop=0px%2C109px%2C1333px%2C700px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2026-07-16T03:17:13.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "9bde7d6a-afde-4d5c-8bbf-e86b250fc2dc",
"title": "Taylor Frankie Paul Granted Restraining Order Against Dakota Mortensen’s Friend",
"description": "Taylor Frankie Paul was granted a three-year ‘civil stalking’ restraining order against Dakota Mortensen's friend Cru Eaton",
"keywords": "",
"snippet": "Taylor Frankie Paul was granted a restraining order against ex-boyfriend Dakota Mortensen‘s friend Cru Eaton.\n\nCourt documents obtained by Us Weekly indicate ...",
"url": "https://www.usmagazine.com/celebrity-news/news/taylor-frankie-paul-gets-restraining-order-against-dakota-pal/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/07/181490SB206466-Taylor-Frankie-Paul-Granted-Restraining-Order-Against-Dakota-Mortensens-Friend--e1784167737182.jpg?crop=0px%2C190px%2C1333px%2C699px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2026-07-16T02:48:12.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
}
]
}
All News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/all HTTP/1.1
Use this endpoint to find all live and historical articles we collect. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-07-16T05:10:01 |
2026-07-16T05:10 |
2026-07-16T05 |
2026-07-16 |
2026-07 |
2026
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-07-16T05:10:01 |
2026-07-16T05:10 |
2026-07-16T05 |
2026-07-16 |
2026-07 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-07-16
|
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": 54585438,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "d138ebba-1037-401c-89d1-30a3e0bf5c18",
"title": "Nawet 5976 zł zamiast 13. i 14. emerytury. Trzeba spełnić jeden warunek",
"description": "Coraz więcej osób decyduje się pozostać na rynku pracy mimo osiągnięcia wieku emerytalnego. Zamiast przechodzić na emeryturę, korzystają z ulgi PIT-0...",
"keywords": "",
"snippet": "W związku z bezpłatną subskrypcją zgadzam się na otrzymywanie na podany adres email informacji handlowych.\n\nInformujemy, że dane przekazane w związku z z...",
"url": "https://www.pulshr.pl/wynagrodzenia/nawet-5976-zl-zamiast-13-i-14-emerytury-trzeba-spelnic-jeden-warunek,120491.html",
"image_url": "https://pliki.pulshr.pl/i/13/78/33/137833_1920.jpg",
"language": "pl",
"published_at": "2026-07-16T05:09:00.000000Z",
"source": "pulshr.pl",
"categories": [
"business"
],
"relevance_score": null
},
{
"uuid": "e38d301f-dcce-4671-a074-8cd27e5e5ad9",
"title": "Bob Dylan Hires Third New Guitarist in Three Weeks as His Touring Lineup Keeps Changing",
"description": "The latest addition features Jad Tariq, the Memphis-based guitarist known for combining swinging jazz with '50s rhythm and blues.",
"keywords": "Bob Dylan, Bob Dylan new guitarist, Jad Tariq, Julian Lage, Bob Britt, Joel Paterson, Doug Lancio",
"snippet": "Bob Dylan apparently added a third new guitarist to his touring ensemble in three weeks, as the Memphis-based jazz guitarist Jad Tariq stood in for another rece...",
"url": "https://www.ultimate-guitar.com/news/general_music_news/bob-dylan-hires-third-new-guitarist-in-three-weeks-as-his-touring-lineup-keeps-changing",
"image_url": "https://www.ultimate-guitar.com/static/article/news/2/187532_0_meta_ver1784164124.jpg",
"language": "en",
"published_at": "2026-07-16T05:08:44.000000Z",
"source": "ultimate-guitar.com",
"categories": [
"entertainment"
],
"relevance_score": null
},
{
"uuid": "27abcda4-78d0-4bed-b19c-1a7a0190f1e9",
"title": "Головний інженер Запорізької АЕС загинув внаслідок атаки дрона: що каже МАГАТЕ",
"description": "Призначений Росією головний інженер окупованої Запорізької атомної електростанції Ол...",
"keywords": "",
"snippet": "Призначений Росією головний інженер окупованої Запорізької атомної електростанції Ол...",
"url": "https://delo.ua/news/priznacenii-rosijeyu-golovnii-inzener-zaporizkoyi-aes-zaginuv-vnaslidok-ataki-drona-shho-kaze-magate-469188/",
"image_url": "https://delo.ua/static/content/thumbs/1200x630/e/0a/6z7flx---c1200x630x50px50p--c7e34d3ad6a9eb5952c58b94665eb0ae.jpg",
"language": "ru",
"published_at": "2026-07-16T05:07:37.000000Z",
"source": "delo.ua",
"categories": [],
"relevance_score": null
},
{
"uuid": "724ef886-45c9-4740-b1c7-504a59f186bc",
"title": "Агроекспорт просів майже на 40%: що сталося з зерном України у сезоні 2025",
"description": "Агроекспорт України у сезоні 2025/26 зазнав суттєвого скорочення: поставки зернових та ол?...",
"keywords": "",
"snippet": "Україна завершила маркетинговий сезон 2025/26 зі скороченням фізичних обсягів експорту з?...",
"url": "https://delo.ua/agro/sezon-zaverseno-agroeksport-skorotivsya-na-40-naibilse-padinnya-u-postavkax-psenici-469174/",
"image_url": "https://delo.ua/static/content/thumbs/1200x630/0/46/4zynve---c1200x630x50px50p--ebebabda1021b9974a8185a96f798460.jpg",
"language": "ru",
"published_at": "2026-07-16T05:07:33.000000Z",
"source": "delo.ua",
"categories": [],
"relevance_score": null
},
{
"uuid": "79fb2ecb-bbec-4dc6-9e88-f5bbabe95ce1",
"title": "Reform der Regionalliga: Bundesliga-Kulttorwart Piplica schimpft auf DFB-Bosse",
"description": "Lok Leipzig scheitert erneut in der Relegation. Tomislav Piplica kritisiert das Festhalten an alter Aufstiegsregel und fordert Reform.",
"keywords": "Lok Leipzig, Regionalliga Nordost, Regionalliga, Leipzig, Fußball, Sport-Tag im Ticker, Sport - Leuchtturm Berlin, DFB, aufstieg, dritte Liga, Sport - Leuchtturm Leipzig, Piplica Tomislav, Lok Leipzig, Regionalliga Nordost, Regionalliga, Leipzig, Fußball, Sport-Tag im Ticker, Sport - Leuchtturm Berlin, DFB, aufstieg, dritte Liga, Sport - Leuchtturm Leipzig, Piplica Tomislav",
"snippet": "TTS-Player überspringen\n\n↵\n\nDer Frust sitzt tief! Als Meister der Regionalliga Nordost scheiterte Lok Leipzig in der Aufstiegs-Relegation an den Würzburger ...",
"url": "https://www.bild.de/sport/fussball/reform-der-regionalliga-bundesliga-kulttorwart-piplica-schimpft-auf-dfb-bosse-6a511d001aef3ee586480bcd",
"image_url": "https://images.bild.de/6a511d001aef3ee586480bcd/a8fa17bb7cbdf72e2f0732d9825ab4f1,867005bf?w=1280",
"language": "de",
"published_at": "2026-07-16T05:06:00.000000Z",
"source": "bild.de",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "3d6de04a-bba5-4107-93b9-ce6a4a78e289",
"title": "PayPal Übernahme: Stripe und Advent bieten 53 Milliarden",
"description": "PayPal Übernahme wird konkreter: Stripe und Advent bieten laut Bericht 60,50 Dollar je Aktie. PayPal hat bislang nicht reagiert.",
"keywords": "",
"snippet": "Aus den bereits im Frühjahr kursierenden Spekulationen über eine PayPal Übernahme ist offenbar ein konkreter Vorstoß geworden. Stripe und Advent Internation...",
"url": "https://onlinemarktplatz.de/268870/paypal-uebernahme/",
"image_url": "https://onlinemarktplatz.de/wp-content/mediathek/2026/07/PayPal-Uebernahme.jpg",
"language": "de",
"published_at": "2026-07-16T05:03:11.000000Z",
"source": "onlinemarktplatz.de",
"categories": [],
"relevance_score": null
},
{
"uuid": "13f51160-382d-4dcf-a074-0bb8678b44be",
"title": "Tenente da Rota baleado segue na UTI, mas apresenta 'importantes avanços'",
"description": "O primeiro-tenente da Rota (Rondas Ostensivas Tobias de Aguiar) Ronickson Pimentel dos Santos, vítima de um atentado no final de junho em São Paulo, segue int...",
"keywords": "",
"snippet": "Policial não teve febre, apresenta pressão intracraniana estável em níveis baixos e boa resposta ao tratamento antibiótico. A função renal também está ...",
"url": "https://noticias.uol.com.br/cotidiano/ultimas-noticias/2026/07/15/tenente-rota-julho-2026-estado-de-saude.ghtm",
"image_url": "https://conteudo.imguol.com.br/c/noticias/db/2026/06/27/ronickson-pimentel-da-rota-da-policia-militar-de-sao-paulo-1782577374858_v2_615x300.png",
"language": "pt",
"published_at": "2026-07-16T05:02:41.000000Z",
"source": "uol.com.br",
"categories": [
"tech",
"science"
],
"relevance_score": null
},
{
"uuid": "e5ddacff-ec82-4926-ae1c-f34f9159b441",
"title": "미 증시 3대 지수 상승 마감",
"description": "미국증시3대지수가상승마감했다.S&P500:+0.38%나스닥:+0.62%다우:+0.29%",
"keywords": "",
"snippet": "",
"url": "https://www.coinreaders.com/247969",
"image_url": "http://www.coinreaders.com/data/coinreaders_com/banner/favicon.ico",
"language": "ko",
"published_at": "2026-07-16T05:02:17.000000Z",
"source": "coinreaders.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "538eb70d-0fc4-409d-b862-79a92d040917",
"title": "董達達3C私塾",
"description": "",
"keywords": "",
"snippet": "",
"url": "https://www.dada3c.tw/feeds/759215510145105432/comments/default",
"image_url": "",
"language": "zh",
"published_at": "2026-07-16T05:02:07.000000Z",
"source": "dada3c.tw",
"categories": [
"tech"
],
"relevance_score": null
},
{
"uuid": "4be08ba2-92fe-4d25-b42a-ac9a50d238f6",
"title": "董達達3C私塾",
"description": "",
"keywords": "",
"snippet": "",
"url": "https://www.dada3c.tw/feeds/6545369447344921602/comments/default",
"image_url": "",
"language": "zh",
"published_at": "2026-07-16T05:02:07.000000Z",
"source": "dada3c.tw",
"categories": [
"tech"
],
"relevance_score": null
}
]
}
Similar News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/similar/uuid HTTP/1.1
Use this endpoint to find similar stories to a specific article based on its UUID.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-07-16T05:10:01 |
2026-07-16T05:10 |
2026-07-16T05 |
2026-07-16 |
2026-07 |
2026
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-07-16T05:10:01 |
2026-07-16T05:10 |
2026-07-16T05 |
2026-07-16 |
2026-07 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-07-16
|
limit |
false | Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan. |
page |
false | Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of articles found for the request. |
meta > returned |
The number of articles returned on the page.
This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page. |
meta > limit |
The limit based on the limit parameter. |
meta > page |
The page number based on the page parameter. |
data > uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
data > title |
The article title. |
data > description |
The article meta description. |
data > keywords |
The article meta keywords. |
data > snippet |
The first 60 characters of the article body. |
data > url |
The URL to the article. |
data > image_url |
The URL to the article image. |
data > language |
The language of the source. |
data > published_at |
The datetime the article was published. |
data > source |
The domain of the source. |
data > categories |
Array of strings which the source is categorized as. |
data > relevance_score |
Relevance score based on the article provided. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/similar/cc11e3ab-ced0-4a42-9146-e426505e2e67?api_token=YOUR_API_TOKEN&language=en&published_on=2020-12-01
Example Response
{
"meta": {
"found": 3571,
"returned": 3,
"limit": 3,
"page": 1
},
"data": [
{
"uuid": "df4ad427-a672-4c67-b6c6-6f81aa00e164",
"title": "Tesla stock jumps after announcement it will join S&P 500 in one go",
"description": "Tesla's stock price surged early Tuesday after the company b...",
"keywords": "Business, s&p 500, stocks, tesla",
"snippet": "Tesla’s stock price surged early Tuesday after the company...",
"url": "https://nypost.com/2020/12/01/tesla-stock-jumps-on-news-it-will-join-sp-500-in-one-shot/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2020/12/tesla-52.jpg?quality=90&strip=all&w=1200",
"language": "en",
"published_at": "2020-12-01T14:35:46.000000Z",
"source": "nypost.com",
"categories": [
"business"
],
"relevance_score": 153.61266
},
{
"uuid": "c9a23881-12dd-4005-8982-7b6552a2eb50",
"title": "Tesla To Join S&P 500 With Full Market Cap On December 21",
"description": "Tesla will be added to the S&P 500 index all at once at its ...",
"keywords": "Tesla, S&P500, EV, Automotive, Stocks, Investing",
"snippet": "Tesla (NASDAQ: TSLA) will be added to the S&P 500 index all ...",
"url": "https://oilprice.com/Latest-Energy-News/World-News/Tesla-To-Join-SP-500-With-Full-Market-Cap-On-December-21.html",
"image_url": "https://d32r1sh890xpii.cloudfront.net/news/718x300/2020-12-01_xwjdajwctl.jpg",
"language": "en",
"published_at": "2020-12-01T16:30:00.000000Z",
"source": "oilprice.com",
"categories": [
"general",
"business"
],
"relevance_score": 146.92773
},
{
"uuid": "18afdb1c-7742-4016-bf8c-a2f114e11199",
"title": "Tesla to Enter S&P 500 at Full Weight in December",
"description": "The electric-vehicle maker will be added to the broad stock-...",
"keywords": "Motor Vehicles, Alternative Fuel Vehicles, Trusts Funds Financial Vehicles, Diversified Holding Companies, Automotive",
"snippet": "S&P Dow Jones Indices said it will add Tesla Inc.’s full w...",
"url": "https://www.wsj.com/articles/tesla-to-enter-s-p-500-at-full-weight-in-december-11606780897?mod=pls_whats_news_us_business_f",
"image_url": "https://images.wsj.net/im-265933/social",
"language": "en",
"published_at": "2020-12-01T00:01:00.000000Z",
"source": "online.wsj.com",
"categories": [
"business"
],
"relevance_score": 128.22346
}
]
}
News by UUID Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/uuid/uuid HTTP/1.1
Use this endpoint to find specific articles by the UUID which is returned on our search endpoints. This is useful if you wish to store the UUID to return the article later.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
Response Objects
| name | description |
|---|---|
uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
title |
The article title. |
description |
The article meta description. |
keywords |
The article meta keywords. |
snippet |
The first 60 characters of the article body. |
url |
The URL to the article. |
image_url |
The URL to the article image. |
language |
The language of the source. |
published_at |
The datetime the article was published. |
source |
The domain of the source. |
categories |
Array of strings which the source is categorized as. |
If no results are found, a resource_not_found error will be returned.
Example Request
GET https://api.thenewsapi.com/v1/news/uuid/147013d8-6c2c-4d50-8bad-eb3c8b7f5740?api_token=YOUR_API_TOKEN
Example Response
{
"uuid": "147013d8-6c2c-4d50-8bad-eb3c8b7f5740",
"title": "These Are The Four American Companies Worth Over $1 Trillion Each – 24",
"description": "America’s major market indexes set records in the early pa...",
"keywords": "",
"snippet": "These Are The Four American Companies Worth Over $1 Trillion...",
"url": "https://247wallst.com/investing/2020/10/17/these-are-the-four-american-companies-worth-over-1-trillion-each/",
"image_url": "https://247wallst.com/wp-content/uploads/2020/08/imageForEntry2-Qrj.jpg",
"language": "en",
"published_at": "2020-10-17T11:16:20.000000Z",
"source": "247wallst.com",
"categories": [
"business"
]
}
Sources Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/sources HTTP/1.1
Use this endpoint to sources to use in your news API requests. Note that the limit is 50 for all requests.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
HTTP GET Parameters
| name | required | description |
|---|---|---|
categories |
false | Comma separated list of categories to include
Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
page |
false | Use this to paginate through the result set. Default is 1.
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of sources found for the request. |
meta > returned |
The number of sources returned on the page. |
meta > limit |
The limit is 50. This currently can not be changed. |
meta > page |
The page number based on the page parameter. |
data > source_id |
The unique ID of the source feed. Use this for the source_ids or exclude_source_ids parameters in the news endpoints.
There may be many source_ids for each domain, therefore we would generally suggest using the domains filter instead the source_ids filter. |
data > domain |
The domain of the source. You can use this for the domains or exclude_domains parameters in the news endpoints. |
data > language |
The source language. |
data > locale |
The source locale. Note that only select sources have locales. |
data > categories |
Array of strings which the source is categorized as. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/sources?api_token=YOUR_API_TOKEN&language=en
Example Response
{
"meta": {
"found": 15453,
"returned": 50,
"limit": 50,
"page": 1
},
"data": [
{
"source_id": "arstechnica.com-1",
"domain": "arstechnica.com",
"language": "en",
"locale": null,
"categories": [
"tech"
]
},
{
"source_id": "adweek.com-1",
"domain": "adweek.com",
"language": "en",
"locale": null,
"categories": [
"business"
]
},
...
Errors
Errors
If your request was unsuccessful, you will receive a JSON formatted error. Below you will find the potential errors you may encounter when using the API.
Errors
| error code | HTTP status | description |
|---|---|---|
malformed_parameters |
400 |
Validation of parameters failed. The failed parameters are usually shown in the error message. |
invalid_api_token |
401 |
Invalid API token. |
usage_limit_reached |
402 |
Usage limit of your plan has been reached. Usage limit and remaining requests can be found on the X-UsageLimit-Limit header. |
endpoint_access_restricted |
403 |
Access to the endpoint is not available on your current subscription plan. |
resource_not_found |
404 |
Resource could not be found. |
invalid_api_endpoint |
404 |
API route does not exist. |
rate_limit_reached |
429 |
Too many requests in the past 60 seconds. Rate limit and remaining requests can be found on the X-RateLimit-Limit header. |
server_error |
500 |
A server error occured. |
maintenance_mode |
503 |
The service is currently under maintenance. |
Example Error Response
{
"error": {
"code": "malformed_parameters",
"message": "The published_before parameter(s) are incorrectly formatted."
}
}
Examples
API Examples
Our endpoints are very useful for filtering to find only specific resources you need. Follow each example request below to see how you can build dynamic queries.
Example Request 1
This is a basic request which will return all articles which match the search term "usd" within the title or body of the article:
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd
Example Request 2
This will return all articles which match the search term "usd" OR "gbp":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%7C%20gbp
Example Request 3
This will return all articles which match the search term "usd" AND "gbp":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%2B%20gbp
Example Request 4
This will return all articles which match the search term "usd" AND "gbp" but removes any articles which mentions "cad":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%2B%20gbp%20-cad
Example Request 5
This will return all articles which match the search term "forex" AND "usd" OR "gbp" but removes any articles which mentions "cad":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=forex%20%2B%20%28usd%20%7C%20gbp%29%20-cad
Example Request 6
This is the same as Example Request 5 but will also ensure the articles returned are in English and categorized by business or tech but not travel, and are published within the last week:
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=forex%20%2B%20%28usd%20%7C%20gbp%29%20-cad&language=en&categories=business%2Ctech&exclude_categories=travel&published_after=2026-07-09
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();