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-14
|
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": "8ade24f4-c87c-4965-94fc-91518d3b4e11",
"title": "Clintons defy House GOP on Epstein subpoenas",
"description": "The House has already received what ‘little information we have,’ the Clintons said in a statement",
"keywords": "",
"snippet": "What happened\n\nFormer President Bill Clinton and former Secretary of State Hillary Clinton said Tuesday they have no intention to testify in the House Oversight...",
"url": "https://theweek.com/politics/clintons-house-gop-epstein-subpoenas",
"image_url": "https://cdn.mos.cms.futurecdn.net/vxu69SM9yCR6cQLQjTqNa-2000-80.jpg",
"language": "en",
"published_at": "2026-01-14T15:45:47.000000Z",
"source": "theweek.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "a5a2be49-936e-46e9-8f7a-c8c720b2efc4",
"title": "Hillary Clinton expected to defy Epstein probe subpoena, risking criminal charges",
"description": "Former Secretary of State Hillary Clinton faces a House Oversight Committee subpoena Wednesday as part of the ongoing Jeffrey Epstein investigation proceedings.",
"keywords": "",
"snippet": "NEW You can now listen to Fox News articles!\n\nFormer Secretary of State Hillary Clinton was subpoenaed to appear before the House Oversight Committee on Wednesd...",
"url": "https://www.foxnews.com/politics/hillary-clinton-expected-defy-epstein-probe-subpoena-risking-criminal-charges",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/01/hillary-clinton-speech.jpg",
"language": "en",
"published_at": "2026-01-14T10:30:25.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "62acc99f-b168-4361-8eae-0bd7e2f25ff1",
"title": "My Partner’s Kids Enjoy Unlimited TV and Video Games. They’re in for a Rude Awakening When They Move into My House.",
"description": "My house, my rules, right?",
"keywords": "family, kids, advice",
"snippet": "Care and Feeding is Slate’s parenting advice column. Have a question for Care and Feeding? Submit it here.\n\nDear Care and Feeding,\n\nMy partner and I have been...",
"url": "https://slate.com/advice/2026/01/parenting-advice-blending-households-rules.html?via=rss",
"image_url": "https://dot.cdnslate.com/static/media/sites/slate-com/icon.400x400.09ec623.png",
"language": "en",
"published_at": "2026-01-14T11:00:00.000000Z",
"source": "slate.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "e5e86d40-b13d-4dcf-b331-96a02100494a",
"title": "Japan’s Takaichi plans to dissolve lower house to set up an early snap election",
"description": "Japan's Prime Minister Sanae Takaichi plans to dissolve the lower house of Parliament soon for a snap election to seek the public's mandate for her policies.",
"keywords": "Sanae Takaichi, Elections, General news, AP Top News, Japan government, Japan, Politics, World news",
"snippet": "Add AP News as your preferred source to see more of our stories on Google.\n\nAdd AP News on Google Add AP News as your preferred source to see more of our storie...",
"url": "https://apnews.com/article/japan-takaichi-parliament-snap-election-537ee828baece9b9a262fc13a62e112c",
"image_url": "https://dims.apnews.com/dims4/default/dcac1a4/2147483647/strip/true/crop/700x394+0+28/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F90%2F29%2F4e3c1cc7446089a9101a7bdff4c8%2Fdefaultshareimage-copy.png",
"language": "en",
"published_at": "2026-01-14T11:53:02.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "cbad149d-3f9c-4f10-a7ae-517dde02715c",
"title": "Clintons Refuse to Testify in Epstein Inquiry Amid Contempt Threat",
"description": "House Republicans are moving to hold former President Bill Clinton in contempt of Congress after failing to appear for a closed-door deposition in the investigation into Jeffrey Epstein. Bill and Hillary Clinton were both subpoenaed to appear before the committee, but have declined arguing the request was legally “invalid” and that they have already made it clear they know nothing about Epstein’s criminal activity. NBC’s Ryan Nobles reports for TODAY.",
"keywords": "",
"snippet": "\n\nCopied\n\nHouse Republicans are moving to hold former President Bill Clinton in contempt of Congress after failing to appear for a closed-door deposition in the...",
"url": "https://www.today.com/video/clintons-refuse-to-testify-in-epstein-inquiry-amid-contempt-threat-255936581505",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_social_share_1200x630_center,f_auto,q_auto:best/mpx/2704722219/2026_01/1768394209451_tdy_news_7a_nobles_clintons_epstein_260114_1920x1080-g3uq8f.jpg",
"language": "en",
"published_at": "2026-01-14T12:36:55.000000Z",
"source": "nbcnews.com",
"categories": [
"politics",
"general"
],
"locale": "us"
},
{
"uuid": "8c532c4b-0fae-486f-99ae-ec3ff5acf6a1",
"title": "House Republicans plan to hold Hillary Clinton in contempt for refusing to testify in Epstein probe",
"description": "The House Oversight Committee will seek to hold former Secretary of State Hillary Clinton in contempt of Congress after she did not appear for a scheduled deposition as part of the Republican-led panel's investigation into Jeffrey Epstein, committee Chairman James Comer announced Wednesday",
"keywords": "",
"snippet": "The House Oversight Committee will seek to hold former Secretary of State Hillary Clinton in contempt of Congress after she did not appear for a scheduled depos...",
"url": "https://www.nbcnews.com/politics/congress/house-republicans-plan-hold-hillary-clinton-contempt-refusing-testify-rcna253920",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2025-07/250730-hillary-clinton-vl-1238p-05a8e6.jpg",
"language": "en",
"published_at": "2026-01-14T15:17:14.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
},
{
"uuid": "90038923-1202-4478-b015-86becd99e307",
"title": "Trump Issues Extreme Greenland Threat Ahead of White House Meeting",
"description": "The early morning threat came just hours before Trump officials are set to meet with leaders from Greenland and Denmark.",
"keywords": "",
"snippet": "“It is vital for the Golden Dome that we are building,” he added, referring to the massive boondoggle he seeks to build. “NATO should be leading the way f...",
"url": "https://newrepublic.com/post/205270/trump-greenland-threat-white-house-meeting",
"image_url": "https://images.newrepublic.com/a1e1e5e44fc41fcd6409e1fb57dfe04edb04a693.jpeg?w=1200&h=630&crop=faces&fit=crop&fm=jpg",
"language": "en",
"published_at": "2026-01-14T14:00:04.000000Z",
"source": "newrepublic.com",
"categories": [
"general",
"politics",
"entertainment"
],
"locale": "us",
"similar": [
{
"uuid": "05e6f142-f82b-4bd1-ab31-a7d391910043",
"title": "What's at stake as Greenland and Denmark prepare for a White House showdown",
"description": "The high-stakes meeting comes shortly after Greenland and Denmark's leaders portrayed a united front against Trump's takeover threats.",
"keywords": "Breaking News: Europe, Donald Trump, Marco Rubio, J.D. Vance, United States, Denmark, Greenland, Defense, Politics, Breaking News: Politics, business news",
"snippet": "U.S. President Donald Trump, Secretary of State Marco Rubio and Vice President JD Vance meet Democratic Republic of the Congo's Foreign Minister Therese Kayikwa...",
"url": "https://www.cnbc.com/2026/01/14/greenland-denmark-trump-white-house-meeting.html",
"image_url": "https://image.cnbcfm.com/api/v1/image/108252104-1768370794136-gettyimages-2255447818-AA_13012026_2600160.jpeg?v=1768370877&w=1920&h=1080",
"language": "en",
"published_at": "2026-01-14T06:41:23.000000Z",
"source": "cnbc.com",
"categories": [
"general",
"business"
],
"locale": "us"
},
{
"uuid": "a1c7d8aa-3698-40c0-a713-01e8fc782b57",
"title": "Greenland's future on the line at key White House meeting",
"description": "Hoping the United States will cool its Arctic ambitions, the top diplomats of Denmark and Greenland were set to hold high-stakes talks at the White House on Wednesday",
"keywords": "",
"snippet": "Hoping the United States will cool its Arctic ambitions, the top diplomats of Denmark and Greenland were set to hold high-stakes talks at the White House on Wed...",
"url": "https://www.nbcnews.com/world/greenland/greenland-denmark-trump-foreign-ministers-meet-rubio-vance-europe-rcna253953",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2025-03/250311-greenland-mb-0853-34b151.jpg",
"language": "en",
"published_at": "2026-01-14T10:50:57.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "bfabfbb1-8eaf-4e29-b4c4-c40ba601c662",
"title": "Trump eyes action on Greenland, setting up White House face-off with Denmark",
"description": "President Donald Trump claims Greenland 'vital' for Golden Dome defense, ahead of a White House meeting with Danish and Greenlandic leaders amid Arctic security concerns.",
"keywords": "",
"snippet": "NEW You can now listen to Fox News articles!\n\nLeaders from Greenland and Denmark are slated to meet with Vice President JD Vance and Secretary of State Marco Ru...",
"url": "https://www.foxnews.com/politics/trump-eyes-action-greenland-setting-up-white-house-face-off-denmark",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/08/trump-greenland-split.jpg",
"language": "en",
"published_at": "2026-01-14T14:39:50.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "80ecde46-dc1e-4a17-aea6-c92825de0ec7",
"title": "Trump offers new reason to acquire Greenland",
"description": "The Danish autonomous territory is crucial for building the Golden Dome missile defense shield, US President Donald Trump has said",
"keywords": "",
"snippet": "The island is crucial for building the Golden Dome missile defense system, the US president has said\n\nAmerica must take control of Greenland for the sake of nat...",
"url": "https://www.rt.com/news/630962-trump-greenland-golden-dome/",
"image_url": "https://mf.b37mrtl.ru/files/2026.01/article/6967b5302030276a6334cdf8.jpg",
"language": "en",
"published_at": "2026-01-14T15:24:43.000000Z",
"source": "rt.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-14T17:28:32 |
2026-01-14T17:28 |
2026-01-14T17 |
2026-01-14 |
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-14T17:28:32 |
2026-01-14T17:28 |
2026-01-14T17 |
2026-01-14 |
2026-01 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-01-14
|
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": 1522616,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "d01d52cd-a8e7-4d99-88da-2f9b3663bbd9",
"title": "Rob Reiner's Kids Reached Out to Death Row Inmate After Parents’ Death",
"description": "Two of Rob Reiner and Michele Singer Reiner’s children reached out to death row inmate Nanon Williams weeks after their parents were murdered",
"keywords": "",
"snippet": "Two of Rob Reiner and Michele Singer Reiner’s children reached out to a death row inmate weeks after their parents were murdered.\n\nAccording to Nanon Williams...",
"url": "https://www.usmagazine.com/celebrity-news/news/rob-reiners-kids-reached-out-to-death-row-inmate-after-parents-death/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/01/GettyImages-1936130014-rob-michele-romy-jake-reiner.jpg?crop=0px%2C49px%2C1800px%2C946px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2026-01-14T17:20:23.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "b735a95d-30e1-429e-869f-824c7c861340",
"title": "90 Day Fiance Veronica, Fiance Seth's Domestic Violence Charges Dropped",
"description": "'90 Day Fiance' alum Veronica Rodriguez and her fiance Seth Daryoushfer's domestic violence charges have been dropped",
"keywords": "",
"snippet": "The domestic violence charges against 90 Day Fiancé star Veronica Rodriguez and her fiancé, Seth Daryoushfar, have been dropped, Us Weekly can confirm.\n\nNorth...",
"url": "https://www.usmagazine.com/celebrity-news/news/90-day-fiance-veronica-fiance-seths-domestic-violence-charges-dropped/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/01/90-Day-Fiance-Veronica-and-Seth.jpg?crop=242px%2C377px%2C1029px%2C540px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2026-01-14T17:17:16.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "df87dd00-5efe-4272-8b24-4e62e8aed214",
"title": "Influencer Katelynn Ordone Returns to Instagram After 'Okay Baby' Death",
"description": "Katelynn Ordone returns to social media after a hiatus following the death of her 2-year-old son, Preston, and says she wants to help others grieving",
"keywords": "",
"snippet": "Influencer Katelynn Ordone has returned to social media following her self-imposed online hiatus to grieve the death of her 2-year-old son, Preston.\n\n“I decid...",
"url": "https://www.usmagazine.com/celebrity-news/news/influencer-katelynn-ordone-returns-to-instagram-after-okay-baby-death/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2026/01/Katelynn-Ordone-IG_1764281272_3775387405906436934_2520353198.jpg?crop=0px%2C594px%2C1500px%2C787px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2026-01-14T17:15:32.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "307bca2d-25e5-4027-be66-c1fb87defc32",
"title": "“A treaty violation”: Oglala Sioux president demands release of tribal members detained by ICE",
"description": "President Frank Star Comes Out called the tribe's sovereignty",
"keywords": "",
"snippet": "The president of the Oglala Sioux Tribe in South Dakota is demanding the release of three tribal members detained by ICE officers in Minneapolis, Minnesota last...",
"url": "https://www.salon.com/2026/01/14/a-treaty-violation-oglala-sioux-president-demands-release-of-tribal-members-detained-by-ice/",
"image_url": "https://www.salon.com/app/uploads/2026/01/ice-minneapolis-GettyImages-2256146757.jpg",
"language": "en",
"published_at": "2026-01-14T17:10:03.000000Z",
"source": "salon.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "e830d801-f0a5-4392-b874-e5da88bf35f0",
"title": "This portfolio stock may be on the chopping block if it doesn't deliver on earnings",
"description": "The Investing Club holds its \"Morning Meeting\" every weekday at 10:20 a.m. ET.",
"keywords": "Alphabet Class C, Alphabet Class A, Microsoft Corp, Broadcom Inc, NVIDIA Corp, Meta Platforms Inc, Amazon.com Inc, Wells Fargo & Co, Honeywell International Inc, BlackRock Inc, Breaking News: Markets, Markets, Investment strategy, Jim Cramer, Morning Meeting Recaps, Goldman Sachs Group Inc, Solstice Advanced Materials Inc, business news",
"snippet": "Every weekday the CNBC Investing Club with Jim Cramer holds a \"Morning Meeting\" livestream at 10:20 a.m. ET. Here's a recap of Wednesday's key moments. 1. Stock...",
"url": "https://www.cnbc.com/2026/01/14/this-portfolio-stock-may-be-on-the-chopping-block-if-it-doesnt-deliver-on-earnings.html",
"image_url": "https://image.cnbcfm.com/api/v1/image/108196912-1757519281221-gettyimages-2223423631-20090101250708-99-391116.jpeg?v=1768408550&w=1920&h=1080",
"language": "en",
"published_at": "2026-01-14T17:08:52.000000Z",
"source": "cnbc.com",
"categories": [
"general",
"business"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "0babd9fa-978e-494a-bf8e-04a2eacb2ace",
"title": "This Invasive, Irreversible Surgery Is the Cheat Code to Getting My Former Sex Life Back. I’m Actually Considering It.",
"description": "I've tried so much.",
"keywords": "advice, sex",
"snippet": "How to Do It is Slate’s sex advice column. Have a question? Send it to Stoya and Rich here. It’s anonymous!\n\nDear How to Do It,\n\nI’m a gay man in my late ...",
"url": "https://slate.com/advice/2026/01/sex-advice-surgery-penis-decision.html?via=rss",
"image_url": "https://compote.slate.com/images/458c890a-fdab-4e02-a287-c2f3788e8e57.gif?crop=1560%2C1040%2Cx0%2Cy0&width=1560",
"language": "en",
"published_at": "2026-01-14T17:07:10.000000Z",
"source": "slate.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "e2a97cd9-5fe6-44cc-bb3e-cac932878d90",
"title": "Why do top clubs fire managers? It's less about results than you think",
"description": "Why have three of the biggest soccer teams in the world fired their managers in the span of just 12 days? To clubs like Man United or Real Madrid, it's not abou...",
"keywords": "",
"snippet": "Open Extended Reactions\n\n... and Xabi Alonso makes three! In the space of 12 days, three clubs -- ranked first, fourth and 10th in the world by revenue -- dispa...",
"url": "https://www.espn.com/soccer/story/_/id/47608614/manchester-united-real-madrid-chelsea-firing-managers-ruben-amorim-enzo-maresca-xabi-alonso-gab-marcotti",
"image_url": "https://a3.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0114%2Fr1600528_2_1296x729_16%2D9.jpg",
"language": "en",
"published_at": "2026-01-14T17:04:18.000000Z",
"source": "espn.com",
"categories": [
"sports",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "f3be9447-ffa3-4da2-82d1-862e09cdfbfc",
"title": "Word game: Slate Pears 151 for January 14, 2026.",
"description": "Today's puzzle has six pears.",
"keywords": "slate-games, pears",
"snippet": "New Pears every day at noon! This is Pears Game 151. The longest words in Game 150 were BILLABLE, BIDDABLE, and BILABIAL.\n\nThe complete Pears archive is now ope...",
"url": "https://slate.com/life/2026/01/word-game-slate-pears-151-for-january-14-2026.html?via=rss",
"image_url": "https://compote.slate.com/images/61d47363-da12-4f08-a295-7bf3f3f4f236.png?width=1560",
"language": "en",
"published_at": "2026-01-14T17:00:00.000000Z",
"source": "slate.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "c2680b84-5ebc-4839-b438-c65d8041aa27",
"title": "Stanley's Adorable Valentine’s Day Cup Collection Just Dropped & the Vintage Designs Will Sell Out ASAP",
"description": "Are you obsessed with everything pink, red, cherries, and vintage sweetheart cakes? This limited-edition collection will have you falling in love with a new emo...",
"keywords": "",
"snippet": "Stanley's new Valentine's Day collection is sweet enough to eat. Take it from this shopping writer who's a little too addicted to anything pink, red, and hearts...",
"url": "https://www.eonline.com/news/1427291/stanley-limited-edition-valentines-day-collection-2026?cmpid=rss-syndicate-genericrss-us-top_stories",
"image_url": "https://akns-images.eonline.com/eol_images/Entire_Site/20260113/bee2b0e2-a492-49db-8614-251f6adc9506_1768342678.jpg?fit=around%7C1080:1080&output-quality=90&crop=1080:1080;center,top",
"language": "en",
"published_at": "2026-01-14T17:00:00.000000Z",
"source": "eonline.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "f84d2cb6-58e0-44a4-87a3-35ee4ad9de68",
"title": "RHOBH Season 15: Jennifer Tilly, Sutton Stracke Argue",
"description": "RHOBH stars and BFFs Jennifer Tilly and Sutton Stracke have found themselves at odds during season 15, as seen in an exclusive clip shared with E! News.",
"keywords": "",
"snippet": "Watch : Garcelle Beauvais Announces Shocking Exit From 'Real Housewives of Beverly Hills'\n\nTensions are climbing between Jennifer Tilly and Sutton Stracke.\n\nThe...",
"url": "https://www.eonline.com/news/1427321/rhobh-season-15-jennifer-tilly-sutton-stracke-argue?cmpid=rss-syndicate-genericrss-us-top_stories",
"image_url": "https://akns-images.eonline.com/eol_images/Entire_Site/20260114/6a90cafb-59c7-4284-a096-8afd6bfeb922_1768396611.jpg?fit=around%7C1080:1080&output-quality=90&crop=1080:1080;center,top",
"language": "en",
"published_at": "2026-01-14T17:00:00.000000Z",
"source": "eonline.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-01-14T17:28:32 |
2026-01-14T17:28 |
2026-01-14T17 |
2026-01-14 |
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-14T17:28:32 |
2026-01-14T17:28 |
2026-01-14T17 |
2026-01-14 |
2026-01 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-01-14
|
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": 54059247,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "2456c685-0f13-4878-85cb-af2d313c549f",
"title": "이 대통령, 한일 셔틀외교 완전 정착 성과",
"description": "위성락 국가안보실장은 14일, 일본 나라현에서 열린 한일 정상회담과 관련해 “지난해 8월 이재명 대통령의 방일로 재개?...",
"keywords": "",
"snippet": "CPTPP 가입 문제, 일본측 최상의 환대 거론\n\n이재명 대통령과 다카이치 사나에 일본 총리가 14일 일본 나라현 호류지에서 ?...",
"url": "http://www.domin.co.kr/news/articleView.html?idxno=1542362",
"image_url": "http://www.domin.co.kr/news/thumbnail/202601/1542362_744473_2227_v150.jpg",
"language": "ko",
"published_at": "2026-01-14T17:28:18.000000Z",
"source": "domin.co.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "e8bc6cd6-5e67-48c3-9973-ad451e9c0d40",
"title": "KT엠모바일, 알뜰폰 최초 가입자 190만 달성",
"description": "[데이터넷] KT엠모바일(대표 구강본)은 국내 알뜰폰 사업자 최초로 가입자 190만 명을 달성했다고 밝혔다. 이는 국내 알뜰?...",
"keywords": "",
"snippet": "혜택 강화·쉽고 빠른 개통·AI 상담 제공으로 고객 선택 이끌어\n\n[데이터넷] KT엠모바일(대표 구강본)은 국내 알뜰폰 사업?...",
"url": "https://www.datanet.co.kr/news/articleView.html?idxno=208516",
"image_url": "https://cdn.datanet.co.kr/news/thumbnail/202601/208516_132481_2755_v150.jpg",
"language": "ko",
"published_at": "2026-01-14T17:28:16.000000Z",
"source": "datanet.co.kr",
"categories": [
"tech"
],
"relevance_score": null
},
{
"uuid": "42d2693c-fe63-4802-ade5-10c00fd602b1",
"title": "삼성바이오로직스, 美 공장·제3캠퍼스 중심으로 3대축 확장 가속",
"description": "시사위크=제갈민 기자 삼성바이오로직스는 존 림 대표가 2026 JP모건 헬스케어 콘퍼런스(JPMHC)에서 글로벌 위탁개발생산(CD...",
"keywords": "",
"snippet": "존 림 삼성바이오로직스 대표가 2026 JP모건 헬스케어 콘퍼런스에서 성장 전략을 발표했다. / 삼성바이오로직스\n\n시사위크...",
"url": "https://www.sisaweek.com/news/articleView.html?idxno=232751",
"image_url": "https://cdn.sisaweek.com/news/thumbnail/202601/232751_246365_2135_v150.jpg",
"language": "ko",
"published_at": "2026-01-14T17:27:54.000000Z",
"source": "sisaweek.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "539b1ea7-2224-4ecf-9d85-740e1a21bdd9",
"title": "지난해 코레일 철도 이용객 ‘역대 최다’…가장 붐빈 날은 언제? - 강원도민일보",
"description": "",
"keywords": "",
"snippet": "이용객 최다 11월 15일 수능 후 첫 주말\n\n외국인 승객도 600만명 돌파\n\n▲ 서울역에 도착한 귀경객들이 열차에서 내려 이동?...",
"url": "https://www.kado.net/news/articleView.html?idxno=2028199",
"image_url": "https://cdn.kado.net/news/photo/202601/2028199_831126_2222.jpg",
"language": "ko",
"published_at": "2026-01-14T17:27:53.000000Z",
"source": "kado.net",
"categories": [],
"relevance_score": null
},
{
"uuid": "6c507717-a26f-4140-8fb5-b48e173a259a",
"title": "[단독] 홈플러스 1월 월급 못준다 : 클리앙",
"description": "홈플러스가 심각한 현금흐름 악화로 인해 1월 급여와 설 상여금 지급이 어려운 상황에 놓인 것으로 확인됐다. 회사는 재?...",
"keywords": "",
"snippet": "홈플러스가 심각한 현금흐름 악화로 인해 1월 급여와 설 상여금 지급이 어려운 상황에 놓인 것으로 확인됐다. 회사는 재?...",
"url": "https://www.clien.net/service/board/park/19125895",
"image_url": "https://www.clien.net/service/image/favicon.ico",
"language": "ko",
"published_at": "2026-01-14T17:27:45.000000Z",
"source": "clien.net",
"categories": [
"tech"
],
"relevance_score": null
},
{
"uuid": "9b2b4292-5980-438c-b962-b67ae84d7c9f",
"title": "[유통가Info.] GS25, 흑백요리사 인기 힘입어 신제품 선봬外",
"description": "시사위크=김지영 기자 ◇ GS25, 흑백요리사 인기 힘입어 신제품 출시GS25는 14일부터 17일까지 우리동네GS앱에서 흑백요리사...",
"keywords": "빙그레, 해태, bhc, 롯데웰푸드, GS25, 대상",
"snippet": "시사위크=김지영 기자 ◇ GS25, 흑백요리사 인기 힘입어 신제품 출시\n\nGS25는 14일부터 17일까지 우리동네GS앱에서 흑백요리?...",
"url": "https://www.sisaweek.com/news/articleView.html?idxno=232735",
"image_url": "https://cdn.sisaweek.com/news/thumbnail/202601/232735_246340_186_v150.jpg",
"language": "ko",
"published_at": "2026-01-14T17:27:36.000000Z",
"source": "sisaweek.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "7872306f-2d7c-403c-9ab4-239420fe66c5",
"title": "공소청·중수청 설치법 입법예고…중수청에 ‘사이버범죄’ 포함 9대 범죄 수사 부여 - 데일리시큐",
"description": "정부가 검찰의 직접 수사개시 권한을 폐지하고, 수사와 기소를 구조적으로 분리하는 내용을 담은 공소청법안·중대범죄?...",
"keywords": "",
"snippet": "윤창렬 국무조정실장(오른쪽 두번째)이 12일 서울 종로구 정부서울청사 창성동 별관에서 열린 공소청법안 및 중수청법안...",
"url": "https://www.dailysecu.com/news/articleView.html?idxno=204303",
"image_url": "https://cdn.dailysecu.com/news/photo/202601/204303_205000_2629.jpg",
"language": "ko",
"published_at": "2026-01-14T17:27:19.000000Z",
"source": "dailysecu.com",
"categories": [
"tech"
],
"relevance_score": null
},
{
"uuid": "02acd4d8-887e-4c82-bd8e-56b0fdb5863f",
"title": "우송대-대전 AI 스타트업 MOU 체결, 2026 청년 AI 창업 챔피언십 개최 < 교육 < 뉴스플러스 < 기사본문",
"description": "[굿모닝충청 이유나 기자] 우송대학교(총장 진고환) RISE 사업단은 지난 13일 대전 지역 AI 스타트업들과 AI 기술교류 및 협?...",
"keywords": "",
"snippet": "우송대학교(총장 진고환) RISE 사업단은 지난 13일 대전 지역 AI 스타트업들과 AI 기술교류 및 협력을 위한 업무협약(MOU)을 ?...",
"url": "https://www.goodmorningcc.com/news/articleView.html?idxno=438767",
"image_url": "https://cdn.goodmorningcc.com/news/thumbnail/202601/438767_448875_250_v150.jpg",
"language": "ko",
"published_at": "2026-01-14T17:27:19.000000Z",
"source": "goodmorningcc.com",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "ef047f97-50c8-474a-85b4-412ec143ba77",
"title": "이번주 금요일 테슬라 발표가 있으려나요? : 클리앙",
"description": "자동차 인플루언서 두 분이 ‘이번주 금요일’ 자동차 업계 중대 발표가 있다고 공통적으로 얘기하고 있는데 스치는 생?...",
"keywords": "",
"snippet": "자동차 인플루언서 두 분이 ‘이번주 금요일’ 자동차 업계 중대 발표가 있다고 공통적으로 얘기하고 있는데 스치는 생?...",
"url": "https://www.clien.net/service/board/cm_car/19125894",
"image_url": "https://www.clien.net/service/image/favicon.ico",
"language": "ko",
"published_at": "2026-01-14T17:27:16.000000Z",
"source": "clien.net",
"categories": [
"tech"
],
"relevance_score": null
},
{
"uuid": "5474c637-24b7-4c91-b67d-d9717defe819",
"title": "奔驰高管回应奔驰为何总被对标：这是作为标杆的必然结果",
"description": "奔驰高管回应奔驰为何总被对标：这是作为标杆的必然结果",
"keywords": ", 奔驰高管回应奔驰为何总被对标：这是作为标杆的必然结果, 快科技",
"snippet": "奔驰高管回应奔驰为何总被对标：这是作为标杆的必然结果\n\n快科技1月14日消息，近日，有网友发布一则奔驰2026新春茶叙?...",
"url": "https://news.mydrivers.com/1/1098/1098380.htm",
"image_url": "https://img1.mydrivers.com/img/20260114/97f766e4c18142df8a721e3d5e6be29d.png",
"language": "zh",
"published_at": "2026-01-14T17:27:13.000000Z",
"source": "news.mydrivers.com",
"categories": [
"tech",
"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-14T17:28:32 |
2026-01-14T17:28 |
2026-01-14T17 |
2026-01-14 |
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-14T17:28:32 |
2026-01-14T17:28 |
2026-01-14T17 |
2026-01-14 |
2026-01 |
2026
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-01-14
|
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-07
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();