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-01-28
|
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": "3e5112e6-76e7-4acc-91c9-7ba9c62b7539",
"title": "Alex Pretti was ‘known’ to feds, had rib broken in anti-ICE protest a week before he was killed by Border Patrol",
"description": "Alex Pretti was known to the feds and allegedly suffered a broken rib in a violent confrontation with agents a week before his death in Minneapolis, sources have said.",
"keywords": "US News, alex pretti, ice, minneapolis, Minneapolis ICE shooting 2026, protests, shootings",
"snippet": "Alex Pretti was known to the feds and suffered a broken rib in a violent confrontation with agents a week before Border Patrol agents killed him in Minneapolis,...",
"url": "https://nypost.com/2026/01/27/us-news/alex-pretti-known-to-feds-had-rib-broken-in-anti-ice-protest-a-week-before-he-was-killed-by-border-patrol/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/01/119806337.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-01-27T17:12:56.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"locale": "us",
"similar": [
{
"uuid": "01330883-6250-49e0-b153-5592dcd007bd",
"title": "Alex Pretti’s sister slams ‘disgusting lies’ about brother after he was killed during Minn. anti-ICE protests: ‘When does this end?’",
"description": "The sister of Alex Pretti, the ICU nurse shot dead during a weekend anti-ICE protest in Minnesota, has slammed the “disgusting lies” told about her brother, including that he was a “domestic terrorist.’’",
"keywords": "US News, deaths, ice, minneapolis, Minneapolis ICE shooting 2026, minnesota",
"snippet": "The sister of Alex Pretti, the ICU nurse shot dead during a weekend anti-ICE protest in Minnesota, has slammed the “disgusting lies” told about her brother,...",
"url": "https://nypost.com/2026/01/27/us-news/alex-prettis-sister-slams-disgusting-lies-about-brother/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/01/119796792.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-01-27T17:42:16.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "a07ff9c6-6aba-46ba-9fcf-8bbd90b2c622",
"title": "Woke officials in wealthy Bay Area enclave break down in tears, abruptly end meeting over ICE shootings of Alex Pretti, Renee Good",
"description": "A woke Bay Area city council is getting ripped online after wrapping up its Monday meeting in a flood of tears “in honor of Alex Pretti, Renee Good, and all the peaceful protesters of Minneapolis.”",
"keywords": "US News, california, ice, minneapolis, police shootings, us customs and border protection, woke culture",
"snippet": "A woke Bay Area city council is getting ripped online after wrapping up its Monday meeting in a flood of tears “in honor of Alex Pretti, Renee Good, and all t...",
"url": "https://nypost.com/2026/01/27/us-news/woke-bay-area-officials-break-down-end-meeting-over-ice-shootings/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/01/councillors-comp.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-01-27T18:34:58.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "4aae0c91-a121-4c1a-a2bf-82475eee1256",
"title": "Video President Trump calls fatal shooting of Alex Pretti 'a very sad situation'",
"description": "Trump told ABC News' Mary Bruce that the fatal shooting of 37-year-old Alex Pretti by a federal agent in Minneapolis is a",
"keywords": "",
"snippet": "President Trump calls fatal shooting of Alex Pretti 'a very sad situation' Trump told ABC News' Mary Bruce that the fatal shooting of 37-year-old Alex Pretti by...",
"url": "https://abcnews.go.com/US/video/president-trump-calls-fatal-shooting-alex-pretti-sad-129608259",
"image_url": "https://i.abcnewsfe.com/a/cc49d316-fdc3-4d9f-a2f3-d6674a02f92c/260127_abc_social_mary_bruce_trump_pretti_hpMain_9x16.jpg?w=992",
"language": "en",
"published_at": "2026-01-27T20:40:49.000000Z",
"source": "abcnews.go.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "a5973767-a066-411c-9e36-3c36a65b5a5a",
"title": "DOJ Won’t Properly Investigate Alex Pretti Killing in Minneapolis",
"description": "The Justice Department is following the same playbook after ICE killed Renee Good.",
"keywords": "",
"snippet": "Normally, the FBI would handle such an investigation, considering that it has the lab facilities and investigators experienced with shootings. In fact, Border P...",
"url": "https://newrepublic.com/post/205765/doj-wont-investigate-alex-pretti-killing-minneapolis",
"image_url": "https://images.newrepublic.com/6490015aae8cefc4cafa2cb33cfaba0803d32eba.jpeg?w=1200&h=630&crop=faces&fit=crop&fm=jpg",
"language": "en",
"published_at": "2026-01-27T19:47:00.000000Z",
"source": "newrepublic.com",
"categories": [
"general",
"politics",
"entertainment"
],
"locale": "us"
},
{
"uuid": "2b2c370e-10ec-4969-9f5c-9c282ae5e6bf",
"title": "Feds Knew Who Alex Pretti Was—and Broke His Rib in Earlier Fight",
"description": "A chilling report raises new questions about why federal agents killed Alex Pretti.",
"keywords": "",
"snippet": "“That day, he thought he was going to die,” CNN’s source said. CNN reviewed Pretti’s medication records that matched the story.\n\nIt’s not clear whethe...",
"url": "https://newrepublic.com/post/205769/feds-knew-who-alex-pretti-was-broke-rib-earlier-fight",
"image_url": "https://images.newrepublic.com/3a7b4234d403c2806059dbcc0e1ed4b66ea08c67.jpeg?w=1200&h=630&crop=faces&fit=crop&fm=jpg",
"language": "en",
"published_at": "2026-01-27T20:08:53.000000Z",
"source": "newrepublic.com",
"categories": [
"general",
"politics",
"entertainment"
],
"locale": "us"
}
]
},
{
"uuid": "9721a17c-7984-4cee-96e0-9d61d1f42537",
"title": "Border Patrol Commander and Some Agents to Leave Minneapolis, Source Says",
"description": "Amid ongoing tensions in Minneapolis, a Trump administration official tells NBC News that an unknown number of federal agents will leave the city and border czar Tom Homan will now take over operations and replace controversial border patrol commander Greg Bovino. The staffing change comes as fallout deepens over the death of Alex Pretti. The Department of Homeland Security confirms multiple body cameras worn by the agents involved captured the shooting which investigators are now reviewing. NBC’s Morgan Chesky reports for TODAY.",
"keywords": "",
"snippet": "\n\nCopied\n\nAmid ongoing tensions in Minneapolis, a Trump administration official tells NBC News that an unknown number of federal agents will leave the city and ...",
"url": "https://www.today.com/video/border-patrol-commander-and-some-agents-to-leave-minneapolis-source-says-256649797903",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_social_share_1200x630_center,f_auto,q_auto:best/mpx/2704722219/2026_01/1769519429676_tdy_news_7a_chesky_border_patrol_260127_1920x1080-6f5v0j.jpg",
"language": "en",
"published_at": "2026-01-27T13:10:35.000000Z",
"source": "nbcnews.com",
"categories": [
"politics",
"general"
],
"locale": "us",
"similar": [
{
"uuid": "70764e7c-35fe-4600-9cf8-cdc19f73c8cf",
"title": "Minneapolis police chief questions federal tactics as Border Patrol commander set to leave city",
"description": "Border Patrol commander Gregory Bovino has been reassigned and will be leaving his post in Minneapolis, sources say, with border czar Tom Homan taking over. The change comes after the death of VA nurse Alex Pretti, who was shot and killed by Border Patrol. Minneapolis Police Chief Brian O'Hara told CBS News the video of the killing shows questionable tactics by federal agents.",
"keywords": "Kristi Noem, Minnesota, United States Border Patrol, Gun Violence, United States Department of Homeland Security, Trump Administration, Protest, Minneapolis",
"snippet": "Minneapolis police chief questions federal tactics as Border Patrol commander set to leave city Border Patrol commander Gregory Bovino has been reassigned and w...",
"url": "https://www.cbsnews.com/video/minneapolis-police-chief-questions-federal-tactics-as-border-patrol-commander-set-to-leave-city/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/01/27/7f12c270-c761-4331-b372-52c7808912d4/thumbnail/1200x630/2eda164f2a4edc8ea001928de44e8e6c/cbsn-fusion-minneapolis-police-chief-questions-federal-tactics-as-border-patrol-commander-set-to-leave-city-thumbnail.jpg",
"language": "en",
"published_at": "2026-01-27T13:36:39.000000Z",
"source": "cbsnews.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "bbd068cc-3c11-4f71-b832-9f485090e33d",
"title": "Knicks players condemn deadly Border Patrol-involved shooting in Minnesota",
"description": "New York Knicks players Karl-Anthony Towns and Guerschon Yabusele spoke out about the deadly Border Patrol-involved shooting over the weekend.",
"keywords": "",
"snippet": "NEW You can now listen to Fox News articles!\n\nNew York Knicks players Karl-Anthony Towns and Guerschon Yabusele spoke out about the deadly Border Patrol-involve...",
"url": "https://www.foxnews.com/sports/knicks-players-condemn-deadly-border-patrol-involved-shooting-minnesota",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/01/nba-knicks-karl-anthony-towns-012726-1.jpg",
"language": "en",
"published_at": "2026-01-27T13:41:39.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "5a78f217-eb13-445a-8ef1-be096953460c",
"title": "Southern California city on edge over viral video of cops helping Border Patrol agents, locals says",
"description": "A viral video appearing to show police in a Los Angeles-area city assisting federal Border Patrol agents has sparked widespread fear and anger among locals.",
"keywords": "US News, california, ice, illegal immigrants, los angeles, us customs and border protection, viral videos",
"snippet": "A viral video appearing to show police in a Los Angeles-area city assisting federal Border Patrol agents has sparked widespread fear and anger among locals\n\nIn ...",
"url": "https://nypost.com/2026/01/27/us-news/socal-city-on-edge-over-viral-video-of-cops-helping-ice-agents/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/01/119799076.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-01-27T14:56:09.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "6f825fcb-6939-4346-b81c-8e4617a88464",
"title": "How a collision with Border Patrol escalated to arrest",
"description": "In her first on-camera interview, Dayanne Figueroa, a U.S. citizen, described what happened when her car collided with a Border Patrol vehicle in October. The situation escalated: agents drew their guns, pulled her out of her car and arrested her. She said it was an",
"keywords": "",
"snippet": "How a collision with Border Patrol escalated to arrest In her first on-camera interview, Dayanne Figueroa, a U.S. citizen, described what happened when her car ...",
"url": "https://www.cbsnews.com/video/how-a-collision-with-border-patrol-escalated-to-arrest-60-minutes/",
"image_url": "https://assets2.cbsnewsstatic.com/hub/i/r/2026/01/27/4ff147e4-342d-4e11-b798-4b15ee5508e7/thumbnail/1200x630/936f8275339b348f1f37fdbbdef70224/ot-icefigueroa.jpg",
"language": "en",
"published_at": "2026-01-27T15:02:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "e37d5062-559d-487e-8fcf-f0b790096547",
"title": "How a collision with Border Patrol led to a Chicago woman's arrest",
"description": "In her first on-camera interview, Dayanne Figueroa, a U.S. citizen, described what happened when her car collided with a Border Patrol vehicle in October. The situation escalated: agents drew their guns, pulled her out of her car and arrested her. She said it was an",
"keywords": "",
"snippet": "Just over a week ago, 60 Minutes reported from Minneapolis, Minnesota, about the Trump administration's immigration crackdown in the city, Operation Metro Surge...",
"url": "https://www.cbsnews.com/news/how-a-collision-with-border-patrol-led-to-a-chicago-womans-arrest-60-minutes/",
"image_url": "https://assets2.cbsnewsstatic.com/hub/i/r/2026/01/27/1d6a96bb-792c-40f9-a8e2-190205c479c3/thumbnail/1200x630/be2ba3dd7fb4248346f3c5cd06d71e20/ot-icefigueroa.jpg",
"language": "en",
"published_at": "2026-01-27T15:03:10.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-01-28T00:49:06 |
2026-01-28T00:49 |
2026-01-28T00 |
2026-01-28 |
2026-01 |
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-01-28T00:49:06 |
2026-01-28T00:49 |
2026-01-28T00 |
2026-01-28 |
2026-01 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-01-28
|
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": 1534080,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "ec212b57-531b-4f5f-a09c-ba41594386f6",
"title": "Chiefs Owner Clark Hunt Says If He Wants Travis Kelce 1 More Season",
"description": "Clark Hunt says the Kansas City Chiefs are giving Travis Kelce space as he decides about his NFL future, possible retirment",
"keywords": "",
"snippet": "Clark Hunt is just like every NFL fan, waiting to see what Travis Kelce will decide about his possible retirement — but the Kansas City Chiefs owner does have...",
"url": "https://www.usmagazine.com/entertainment/news/chiefs-owner-clark-hunt-says-if-he-wants-travis-kelce-1-more-season/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/01/Kansas-City-Chiefs-Owner-Clark-Hunt-Reveals-If-He-Wants-Travis-Kelce-to-Return-for-Another-NFL-Season.jpg?crop=0px%2C0px%2C2000px%2C1051px&resize=1200%2C630&quality=40&strip=all",
"language": "en",
"published_at": "2026-01-28T00:23:21.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "a39b6307-8674-4928-b0ea-d62639bffadf",
"title": "Russian tourists accused of trespassing on US military base – embassy",
"description": "Two Russian women are facing deportation after they accidentally drove onto the territory of Marine Corps Base Camp Pendleton in California",
"keywords": "",
"snippet": "Two women were looking for McDonald’s but ended up at Camp Pendleton, according to media reports\n\nTwo Russian women are facing deportation from the US after t...",
"url": "https://www.rt.com/news/631623-russian-tourists-us-base/",
"image_url": "https://mf.b37mrtl.ru/files/2026.01/article/697953d42030272d5c0cadad.jpg",
"language": "en",
"published_at": "2026-01-28T00:13:30.000000Z",
"source": "rt.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "bf082889-cce9-418f-a19c-e297aad83275",
"title": "Tillis becomes first GOP senator to call for \"incompetent\" Noem to step down",
"description": "Republican Sen. Lisa Murkowski later echoed the sentiments shared by her colleague, Sen. Thom Tillis.",
"keywords": "",
"snippet": "Washington — Republican Sen. Thom Tillis of North Carolina said Tuesday he has lost all confidence in \"incompetent\" Homeland Security Secretary Kristi Noem, w...",
"url": "https://www.cbsnews.com/news/tillis-murkowski-kristi-noem-step-down-dhs/",
"image_url": "https://assets2.cbsnewsstatic.com/hub/i/r/2026/01/27/2ace856d-5179-4e8b-af03-97931d0df6cf/thumbnail/1200x630/e43a4fb6662ae72a68f7a28e3b8f3bcb/gettyimages-2258564789.jpg",
"language": "en",
"published_at": "2026-01-28T00:13:10.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "01624695-60ec-447b-8401-f315465dc0fc",
"title": "Man accused of murdering ex-wife, her husband, was on their property weeks before, docs show",
"description": "Court documents in the murder of a Columbus, Ohio, woman and her dentist husband were made public on Tuesday. The woman's ex-husband has been charged with murde...",
"keywords": "Murder, Ohio, Crime",
"snippet": "Man accused of murdering ex-wife, her husband, was on their property weeks before, docs show Court documents in the murder of a Columbus, Ohio, woman and her de...",
"url": "https://www.cbsnews.com/video/man-accused-murdering-ex-wife-her-husband-was-their-property-weeks-before-docs-show/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/01/28/5f557791-c91b-41af-bef5-1af0d9a6d450/thumbnail/1200x630/d0e4d61703ac465e5000b7f6b29e76fe/cbsn-fusion-man-accused-murdering-ex-wife-her-husband-was-their-property-weeks-before-docs-show-thumbnail.jpg",
"language": "en",
"published_at": "2026-01-28T00:13:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "d36a1fff-11c6-4fc8-803c-7c21ecabb52c",
"title": "Notorious NYC pedo nearly walks free — till he ‘forgets’ details of his crimes at hearing, infuriating ADA",
"description": "Notorious Brooklyn Hasidic pedophile Nechemya Weberman nearly walked free during a resentencing Tuesday — till he pretended to forget details of his crimes an...",
"keywords": "Metro, US News, brooklyn supreme court, eric gonzalez, hasidic judaism, nechemya weberman",
"snippet": "A notorious Brooklyn Hasidic pedophile nearly walked free during a resentencing Tuesday — till he pretended to forget details of his crimes and the furious pr...",
"url": "https://nypost.com/2026/01/27/us-news/notorious-nyc-pedo-nearly-walks-free-till-he-forgets-details-of-his-crimes-at-hearing-infuriating-ada/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/01/119817733.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-01-28T00:10:28.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "f32343a7-62e6-472a-863a-726abd0cc705",
"title": "Antonio Banderas Joins Rosario Dawson, Scott Eastwood & Susan Sarandon In ‘Unmerciful Good Fortune’",
"description": "Unmerciful Good Fortune has set Oscar nominee Antonio Banderas opposite Rosario Dawson, Scott Eastwood and Susan Sarandon in the Tirsa Hackshaw written and dire...",
"keywords": "",
"snippet": "EXCLUSIVE: 308 Entertainment’s supernatural thriller Unmerciful Good Fortune has set Oscar nominee Antonio Banderas opposite Rosario Dawson, Scott Eastwood an...",
"url": "https://deadline.com/2026/01/antonio-banderas-unmerciful-good-fortune-1236699245/",
"image_url": "https://deadline.com/wp-content/uploads/2026/01/GettyImages-2214762018-e1769557028989.jpg?w=1024",
"language": "en",
"published_at": "2026-01-28T00:10:15.000000Z",
"source": "deadline.com",
"categories": [
"entertainment"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "b0765148-ca73-4596-8351-493899cc3cdd",
"title": "NTSB animation shows lead-up to deadly mid-air crash near D.C. airport",
"description": "Federal investigators on Tuesday detailed a series of issues they say contributed to the January 2025 mid-air collision near Reagan Airport which killed 67 peop...",
"keywords": "Plane Crash, Helicopter Crash, National Transportation Safety Board",
"snippet": "NTSB animation shows lead-up to deadly mid-air crash near D.C. airport Federal investigators on Tuesday detailed a series of issues they say contributed to the ...",
"url": "https://www.cbsnews.com/video/ntsb-animation-shows-lead-up-deadly-mid-air-crash-near-dc-airport/",
"image_url": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/01/28/844b77fe-7867-49df-8d03-e14e182d6489/thumbnail/1200x630/f8b85a204a4eaa0774a9b1dfa3c0ebb6/cbsn-fusion-ntsb-animation-shows-lead-up-deadly-mid-air-crash-near-dc-airport-thumbnail.jpg",
"language": "en",
"published_at": "2026-01-28T00:07:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "e0e8a61f-d0c6-4827-babb-5c4c6e6c1a0e",
"title": "NYC could remain below freezing for 12 straight days thanks to polar vortex—most since 2003",
"description": "NYC could continue a streak of below-freezing temperatures for 12 straight days — the most bone-chilling stretch in the Big Apple since 2003, according to for...",
"keywords": "Metro, US News, accuweather, extreme weather, new york city, snow, winter storm",
"snippet": "Welcome to the Frozen Apple.\n\nTemperatures in New York City have remained below freezing since Friday — and they’re expected to stay that way until at least...",
"url": "https://nypost.com/2026/01/27/us-news/nyc-could-remain-below-freezing-for-12-straight-days-thanks-to-polar-vortex/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/01/nyc-cold-comp.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2026-01-28T00:06:16.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "746b785f-4f99-4024-bd77-7c2433cff5f4",
"title": "New video shows moments before Pretti shooting",
"description": "A newly released video shows Alex Pretti in a confrontation with federal officers in the minutes before he was shot. NBC News’ Camila Bernal reports.",
"keywords": "",
"snippet": "Thousands of flights are cancelled in the U.S. as dangerous winter storm barrels up the east coast 01:54",
"url": "https://www.nbcnews.com/nightly-news/video/new-video-shows-moments-before-pretti-shooting-256695365829",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/mpx/2704722219/2026_01/1769558651505_nn_cbe_alex_pretti_death_ice_outrage_260127_1920x1080-ald3ya.jpg",
"language": "en",
"published_at": "2026-01-28T00:04:16.000000Z",
"source": "nbcnews.com",
"categories": [
"politics",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "2bf62f16-a578-469d-88a8-dbabacfc25c6",
"title": "Glasgow Film Festival’s Industry Focus Strand Expands To Five Days; Speakers Include Execs From BBC, Bankside, Curzon, The Match Factory & More",
"description": "The event, which takes place March 2-6, 2026, will include speakers from the BBC, Curzon, Bankside Films, The Match Factory & More.",
"keywords": "",
"snippet": "The Glasgow Film Festival’s Industry Focus strand has unveiled its full line-up for its 11th edition, with the event expanding an extra day to five days acros...",
"url": "https://deadline.com/2026/01/glasgow-film-festival-industry-focus-bbc-curzon-bankside-1236698585/",
"image_url": "https://deadline.com/wp-content/uploads/2026/01/MixCollage-27-Jan-2026-06-17-PM-8278.jpg?w=1024",
"language": "en",
"published_at": "2026-01-28T00:01:00.000000Z",
"source": "deadline.com",
"categories": [
"entertainment"
],
"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-01-28T00:49:06 |
2026-01-28T00:49 |
2026-01-28T00 |
2026-01-28 |
2026-01 |
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-01-28T00:49:06 |
2026-01-28T00:49 |
2026-01-28T00 |
2026-01-28 |
2026-01 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-01-28
|
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": 54037115,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "feefcd56-c827-46b2-a8fa-b870b6d4584e",
"title": "Gato perdido que percorreu 250 km e reencontrou tutores intriga franceses",
"description": "Veja as principais notícias e manchetes do dia no Brasil e no Mundo. Leia textos e assista a vídeos de Política, Cotidiano, Crimes e mais.",
"keywords": "",
"snippet": "Durante a consulta, o veterinário identificou o microchip implantado no gato, o que permitiu confirmar que se tratava, de fato, de Filou e localizar seus tutor...",
"url": "https://noticias.uol.com.br/internacional/ultimas-noticias/2026/01/27/gato-desaparecido-na-espanha-percorre-250-km-e-reencontra-tutores-na-franca.htm",
"image_url": "https://conteudo.imguol.com.br/c/noticias/79/2026/01/26/gatinho-percorreu-cerca-de-250-km-para-reencontrar-os-tutores-1769453171050_v2_615x300.png",
"language": "pt",
"published_at": "2026-01-28T00:48:27.000000Z",
"source": "uol.com.br",
"categories": [
"tech",
"science"
],
"relevance_score": null
},
{
"uuid": "b9ef4b82-82ec-4a37-a8da-cb074551684d",
"title": "Le PSG se fait plomber son mercato par… Lionel Messi ?",
"description": "Le PSG veut recruter Julian Alvarez (Atlético Madrid). Le buteur argentin envisage un départ de son club. Cependant, un autre Argentin aurait déconseillé le...",
"keywords": "",
"snippet": "Julian ALVAREZ, Crédit photo : Icon Sport\n\nLe PSG veut recruter Julian Alvarez (Atlético Madrid). Le buteur argentin envisage un départ de son club. Cependan...",
"url": "https://www.footparisien.com/actualite/le-psg-se-fait-plomber-son-mercato-par-lionel-messi.html",
"image_url": "https://www.footparisien.com/images/alvarez-julian_ICONSPORT_243831_0007.jpg",
"language": "fr",
"published_at": "2026-01-28T00:45:59.000000Z",
"source": "livefoot.fr",
"categories": [
"sports"
],
"relevance_score": null
},
{
"uuid": "5dd57f97-065e-459d-947d-ca342aadb36e",
"title": "美 디지털 자산 자문위원회 총괄 \"트럼프, 다보스포럼서 '암호화폐 수도' 약속 재확인\"",
"description": "미국백악관암호화폐자문위원회사무총장(총괄)패트릭위트(PatrickWitt)가최근다보스에서열린세계경제포럼(WEF)은글로벌암?...",
"keywords": "",
"snippet": "",
"url": "https://www.coinreaders.com/211599",
"image_url": "http://www.coinreaders.com/data/coinreaders_com/banner/favicon.ico",
"language": "ko",
"published_at": "2026-01-28T00:45:40.000000Z",
"source": "coinreaders.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "7e41e876-7834-4170-945d-9627fb2be1d8",
"title": "福岡・福津市の元学習塾長を逮捕 自宅兼塾で中学生の教え子を盗撮した疑い",
"description": "西日本新聞meは、九州のニュースを中心に最新情報を伝えるニュースサイトです。九州・福岡の社会、政治、経済など?...",
"keywords": "西日本新聞me, 西日本新聞, ニュース, 九州, 福岡",
"snippet": "福岡・福津市の元学習塾長を逮捕 自宅兼塾で中学生の教え子を盗撮した疑い",
"url": "https://www.nishinippon.co.jp/item/1451202/",
"image_url": "https://www.nishinippon.co.jp/uploads/image/1051106/sns_edd866438f.jpg",
"language": "ja",
"published_at": "2026-01-28T00:43:00.000000Z",
"source": "nishinippon.co.jp",
"categories": [],
"relevance_score": null
},
{
"uuid": "22b0878a-e8a5-498f-b2ee-57b9e12c7009",
"title": "自由に感謝する、47歳の誕生日",
"description": "※激戦の社長ランキングの中で、藤沢涼が、光栄なことに、◯位です！！↓↓↓↓↓↓↓↓社長ブログランキングへ ...",
"keywords": "家族, 自由, 47歳, DIE WITH ZERO, FIRE, NARUKAMI, 不自由な人, 感謝, 日本酒, 松坂牛, 自由, 自由な人, 誕生日, ",
"snippet": "※激戦の社長ランキングの中で、\n\n藤沢涼が、光栄なことに、◯位です！！\n\n↓↓↓↓↓↓↓↓\n\n社長ブログランキング?...",
"url": "http://fujisawa-ryo.com/%e5%ae%b6%e6%97%8f/%e8%87%aa%e7%94%b1%e3%81%ab%e6%84%9f%e8%ac%9d%e3%81%99%e3%82%8b%e3%80%8147%e6%ad%b3%e3%81%ae%e8%aa%95%e7%94%9f%e6%97%a5.html",
"image_url": "http://fujisawa-ryo.com/wp-content/uploads/2026/01/623300286_25494605950238543_6606890072005824863_n-1024x891.jpg",
"language": "ja",
"published_at": "2026-01-28T00:42:43.000000Z",
"source": "fujisawa-ryo.com",
"categories": [
"business"
],
"relevance_score": null
},
{
"uuid": "65b7b699-b2a4-45c7-9d0a-4368276811f7",
"title": "Dos asteroides descubiertos por el Vaticano reciben los nombres de santas polacas",
"description": "Cinco siglos de tradición astronómica vaticana se reflejan en el firmamento con nuevos hallazgos",
"keywords": "",
"snippet": "(ACI/InfoCatólica) El Observatorio Vaticano ha logrado que dos nuevos asteroides descubiertos por sus astrónomos sean oficialmente bautizados con los nomb...",
"url": "https://www.infocatolica.com/?t=noticia&cod=54329&utm_medium=RSS&utm_source=atom&utm_campaign=home",
"image_url": "https://www.infocatolica.com/files/26/01/leon-observatorio-vaticano.jpg",
"language": "es",
"published_at": "2026-01-28T00:42:05.000000Z",
"source": "infocatolica.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "dc40c914-fb29-44f1-abd5-63ea03946bfa",
"title": "Más de 100 personas se preparan para ingresar en la Iglesia católica en la Universidad Estatal de Kansas",
"description": "Una universidad de Kansas casi triplica sus conversiones al catolicismo mientras las parroquias rurales registran cifras récord. La Generación Z busca lo ...",
"keywords": "",
"snippet": "Una universidad de Kansas casi triplica sus conversiones al catolicismo mientras las parroquias rurales registran cifras récord. La Generación Z busca lo ...",
"url": "https://www.infocatolica.com/?t=noticia&cod=54330&utm_medium=RSS&utm_source=atom&utm_campaign=home",
"image_url": "https://www.infocatolica.com/files/26/01/ksu-campus.jpg",
"language": "es",
"published_at": "2026-01-28T00:42:05.000000Z",
"source": "infocatolica.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "19eb9389-aa8b-454b-bcdb-e1d48726250b",
"title": "U of A partners with City of Edmonton to study hydrogen-powered vehicles",
"description": "The partnership is the latest turn in a long saga of Edmonton attempting to green its fleets.",
"keywords": "alberta, cleantech, edmonton, govt, prairies, tech",
"snippet": "The partnership is the latest turn in a long saga of Edmonton attempting to green its fleets.\n\nThe University of Alberta is the latest entity to join the City o...",
"url": "https://betakit.com/u-of-a-partners-with-city-of-edmonton-to-study-hydrogen-powered-vehicles/",
"image_url": "https://cdn.betakit.com/wp-content/uploads/2026/01/Public_Transportation.jpg",
"language": "en",
"published_at": "2026-01-28T00:41:57.000000Z",
"source": "betakit.com",
"categories": [
"tech",
"business"
],
"relevance_score": null
},
{
"uuid": "84bbb3a4-5612-4fb1-8b63-2e9472ca8643",
"title": "58岁王祖贤入驻抖音 首发视频打招呼 安徽网友齐晒“祖贤路”照片",
"description": "58岁王祖贤入驻抖音 首发视频打招呼 安徽网友齐晒“祖贤路”照片",
"keywords": ", 58岁王祖贤入驻抖音 首发视频打招呼 安徽网友齐晒“祖贤路”照片, 快科技",
"snippet": "58岁王祖贤入驻抖音 首发视频打招呼 安徽网友齐晒“祖贤路”照片\n\n快科技1月28日消息，日前，知名演员王祖贤入驻抖音?...",
"url": "https://news.mydrivers.com/1/1100/1100875.htm",
"image_url": "https://img1.mydrivers.com/img/20260128/2bb89fd0cae44968b2a42bead4e28740.png",
"language": "zh",
"published_at": "2026-01-28T00:41:54.000000Z",
"source": "news.mydrivers.com",
"categories": [
"tech",
"general"
],
"relevance_score": null
},
{
"uuid": "8a035639-fecb-4e5b-8f56-dc11489f7ba8",
"title": "Serie REDMI Note marca un récord histórico con más de 460 millones de envíos y fortalece el posicionamiento global de Xiaomi",
"description": "",
"keywords": "periodismo, noticias, Costa Rica, independiente, análisis, reportajes",
"snippet": "En colaboración con:\n\nLo que empezó como una apuesta accesible, hoy es una línea global que ha redefinido las expectativas del consumidor en más de 100 paí...",
"url": "https://delfino.cr/2026/01/serie-redmi-note-marca-un-rcord-histrico-con-ms-de-460-millones-de-envos-y-fortalece-el-posicionamiento-global-de-xiaomi",
"image_url": "https://d1qqtien6gys07.cloudfront.net/wp-content/uploads/2026/01/Redmi-Note-14-Pro-Azul-Oceano-1-e1769539268797-1024x412.jpg",
"language": "es",
"published_at": "2026-01-28T00:41:37.000000Z",
"source": "delfino.cr",
"categories": [
"general"
],
"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-01-28T00:49:06 |
2026-01-28T00:49 |
2026-01-28T00 |
2026-01-28 |
2026-01 |
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-01-28T00:49:06 |
2026-01-28T00:49 |
2026-01-28T00 |
2026-01-28 |
2026-01 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-01-28
|
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-01-21
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();