Documentation
Sign up for free!
Get instant access to the API with your free API token. No billing details required!
Getting Started
Introduction
Our API was developed to provide global news from thousands of sources with exceptional response times. On average we add over 1 million articles weekly, so you will never be short of content. Even better, it is completely free!
To get started simply sign up and use your API token in any of the available API endpoints documented below for instant access.
If you have any questions or concerns, feel free to contact us.
Authentication
As mentioned above, when you sign up for free you will find your API token on your dashboard. Simply add this to any of our API endpoints as a GET parameter to gain access. Examples of how this is done can be found below.
API Endpoints
Headlines Available on: Standard plan and above
Endpoint
GET https://api.thenewsapi.com/v1/news/headlines HTTP/1.1
Use this endpoint to find get the latest headlines by category along with similar articles, allowing you to create the perfect news aggregation page similar to Google News .
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
locale |
false | Comma separated list of country codes to include in the result set. Default is all countries.
Click here for a list of supported countries.
Example: us,ca (US + Canada).
|
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_on |
false | Find headlines for articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-12-05
|
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": "b98dcdcb-fe0d-474b-8a72-30202453c7cd",
"title": "Supreme Court allows Texas to use newly drawn congressional district map for 2026 midterm elections",
"description": "The Supreme Court on Thursday came to the rescue of Texas Republicans, allowing next year’s elections to be held under the state’s congressional redistricting plan.",
"keywords": "Politics, US News, supreme court, texas",
"snippet": "WASHINGTON — The Supreme Court on Thursday came to the rescue of Texas Republicans, allowing next year’s elections to be held under the state’s congressio...",
"url": "https://nypost.com/2025/12/04/us-news/supreme-court-allows-texas-to-use-newly-drawn-congressional-district-map-for-2026-midterm-elections/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2025/12/newspress-collage-hcy7fq2o5-1764890957381.jpg?quality=75&strip=all&1764872963&w=1200",
"language": "en",
"published_at": "2025-12-04T23:30:36.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"locale": "us",
"similar": [
{
"uuid": "17604475-e13e-47cb-9845-ff4bcb463542",
"title": "Supreme Court allows Texas to use new congressional district map drawn to favor Republicans",
"description": "WASHINGTON — The Supreme Court on Thursday allowed Texas to use a new congressional district map in next year’s midterm elections that was drawn to maximize Republican political power",
"keywords": "",
"snippet": "WASHINGTON — The Supreme Court on Thursday allowed Texas to use a new congressional district map in next year’s midterm elections that was drawn to maximize...",
"url": "https://www.nbcnews.com/politics/supreme-court/supreme-court-allows-texas-use-new-congressional-district-map-drawn-fa-rcna244696",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2025-11/251118-Greg-Abbott-ew-338p-cdd610.jpg",
"language": "en",
"published_at": "2025-12-04T23:04:44.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "15a1640f-2cf7-4d00-abd0-b35f681bda16",
"title": "Supreme Court allows Texas to use a congressional map favorable to Republicans in 2026",
"description": "The Supreme Court is allowing the challenged Texas congressional redistricting plan to be used in next year’s election, despite a lower-court ruling that the map likely discriminates on the basis of race.",
"keywords": "Donald Trump, Courts, Ken Paxton, Texas, General news, Gavin Newsom, Elena Kagan, Ronald Reagan, Samuel Alito, Barack Obama, Redistricting, Elections, U.S. Republican Party, Texas state government, California, Local News for Apple, TX State Wire, AP Top News, Jerry Smith, Richard Hasen, Washington news, George Soros, Politics, David Guaderrama",
"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/supreme-court-redistricting-texas-trump-02b07b477b153f23ed5c387f2f9ae0c4",
"image_url": "https://dims.apnews.com/dims4/default/4e2d648/2147483647/strip/true/crop/5358x3014+0+279/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fe4%2Ff6%2F0196036863d2db7589d9e52e271d%2F66fb65c8795d4146b2a3eefeb5311893",
"language": "en",
"published_at": "2025-12-04T23:53:03.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "f26511f8-1b54-43df-bbe5-07f2886d47e3",
"title": "Supreme Court sides with Texas Republicans on congressional map",
"description": "The Supreme Court sided with Texas Republicans over a new congressional map on Thursday, paving the way for the map to be used in the 2026 midterms.",
"keywords": "Supreme Court of the United States, Republican Party, Texas",
"snippet": "Supreme Court sides with Texas Republicans on congressional map The Supreme Court sided with Texas Republicans over a new congressional map on Thursday, paving ...",
"url": "https://www.cbsnews.com/video/supreme-court-sides-republicans-redistricting-efforts-texas/",
"image_url": "https://assets1.cbsnewsstatic.com/hub/i/r/2025/12/04/cf4dc6cb-cbc4-4ebf-86db-8a40af84146a/thumbnail/1200x630/309f7551442a69e8c042db8308f28087/cbsn-fusion-supreme-court-sides-republicans-redistricting-efforts-texas-thumbnail.jpg",
"language": "en",
"published_at": "2025-12-04T23:23:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "0fc98877-dbfa-4653-be95-1ed0f9f5c55d",
"title": "SCOTUS allows Texas to use Trump-pushed redrawn congressional redistricting map favoring Republicans",
"description": "The Supreme Court ruled on Texas' emergency request to reinstate the Republican-led legislature's congressional map after a lower court blocked the map from taking effect in 2026.",
"keywords": "",
"snippet": "NEW You can now listen to Fox News articles!\n\nThe Supreme Court signaled that Texas is likely to prevail in defending its new congressional map, faulting a lowe...",
"url": "https://www.foxnews.com/politics/scotus-allows-texas-use-trump-pushed-redrawn-congressional-redistricting-map-favoring-republicans",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/08/abbott-texas.png",
"language": "en",
"published_at": "2025-12-04T23:43:40.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "417aba84-d3ba-4b6b-b87f-1d6aa77df16a",
"title": "Supreme Court allows Texas to use new congressional map favoring GOP",
"description": "The Supreme Court has ruled that Texas is allowed to use a new congressional district map that favors Republicans, in a 6-3 ruling along ideological lines. The decision comes after a panel of federal judges blocked the use of the map.",
"keywords": "",
"snippet": "The Supreme Court has ruled that Texas is allowed to use a new congressional district map that favors Republicans, in a 6-3 ruling along ideological lines. The ...",
"url": "https://www.nbcnews.com/video/supreme-court-allows-texas-to-use-new-congressional-map-favoring-gop-253744709745",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/mpx/2704722219/2025_12/1764891729579_now_hallie_supreme_court_texas_251204_1920x1080-9nuwgz.jpg",
"language": "en",
"published_at": "2025-12-04T23:42:14.000000Z",
"source": "nbcnews.com",
"categories": [
"politics",
"general"
],
"locale": "us"
}
]
},
{
"uuid": "dacce425-b7e0-4a4e-90b5-b136ad9f1a8d",
"title": "Grand jury rejects DOJ's attempt to revive fraud case against New York AG Letitia James: Sources",
"description": "A grand jury has refused to indict New York AG Letitia James on charges of mortgage fraud, ten days after a judge dismissed a nearly identical case.",
"keywords": "Article, 128107484",
"snippet": "New York Attorney General, Letitia James, speaks after pleading not guilty outside the United States District Court Oct. 24, 2025, in Norfolk, Va.\n\nNew York Att...",
"url": "https://abcnews.go.com/US/grand-jury-rejects-dojs-attempt-revive-fraud-case/story?id=128107484",
"image_url": "https://i.abcnewsfe.com/a/54cb05ed-9164-4e3e-956c-15e84b8c5ace/letitia-james-ap-jef-251204_1764858968764_hpMain_16x9.jpg?w=1600",
"language": "en",
"published_at": "2025-12-04T23:38:40.000000Z",
"source": "abcnews.go.com",
"categories": [
"general"
],
"locale": "us",
"similar": [
{
"uuid": "4f54f085-0da9-4897-8dab-b6d78e0f57df",
"title": "Grand jury declines to indict N.Y. Attorney General Letitia James, less than two weeks after the first case was dismissed",
"description": "The Justice Department on Thursday failed to secure an indictment against New York Attorney General Letitia James, a person familiar with the matter told NBC News",
"keywords": "",
"snippet": "The Justice Department on Thursday failed to secure an indictment against New York Attorney General Letitia James, a person familiar with the matter told NBC Ne...",
"url": "https://www.nbcnews.com/politics/justice-department/grand-jury-declines-indict-ny-attorney-general-letitia-james-less-two-rcna247310",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2025-12/251203-Letitia-James-jg-b0bce2.jpg",
"language": "en",
"published_at": "2025-12-04T22:40:57.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "5a9093cc-7d1e-490d-b329-5b9d0800b58d",
"title": "Grand jury rejects new mortgage fraud indictment against New York Attorney General Letitia James",
"description": "The Justice Department has failed to secure a new indictment against New York Attorney General Letitia James after a judge dismissed the previous mortgage fraud prosecution encouraged by President Donald Trump.",
"keywords": "Donald Trump, James Comey, Letitia James, Juries, Indictments, Crime, General news, U.S. Department of Justice, New York, Fraud, Legal proceedings, Virginia, Local News for Apple, New York City, AP Top News, U.S. Federal Bureau of Investigation, Politics, Pam Bondi, Lindsey Halligan, Washington news, Cameron McGowan Currie, Erik Siebert, U.S. news, Lawsuits, United States government, U.S. News",
"snippet": "Add AP News as your preferred source to see more of our stories on Google.\n\nAdd AP News on Google Add AP News as your preferred source to see more of our storie...",
"url": "https://apnews.com/article/letitia-james-justice-department-mortgage-fraud-fa10cc83a925ecbb628f44572ee7931b",
"image_url": "https://dims.apnews.com/dims4/default/6d805a6/2147483647/strip/true/crop/5184x2916+0+270/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fc7%2F08%2Fd640aa021b5658d91152abe5feff%2F1c65b8dbc12c4cb5a8cab25812b98380",
"language": "en",
"published_at": "2025-12-04T23:53:03.000000Z",
"source": "apnews.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "3117c98e-cbeb-4b3d-be1b-6f2cc81502fa",
"title": "Grand jury rejects DOJ's attempt to re-indict New York Attorney General Letitia James",
"description": "A grand jury has rejected the Department of Justice's attempt to re-indict New York Attorney General Letitia James. CBS News legal contributor Jessica Levinson has reaction.",
"keywords": "United States Department of Justice, Letitia James, Trump Administration, New York",
"snippet": "Grand jury rejects DOJ's attempt to re-indict New York Attorney General Letitia James A grand jury has rejected the Department of Justice's attempt to re-indict...",
"url": "https://www.cbsnews.com/video/grand-jury-rejects-dojs-attempt-re-indict-ny-attorney-general-letitia-james/",
"image_url": "https://assets2.cbsnewsstatic.com/hub/i/r/2025/12/04/1a34f8e4-92bb-41a2-b6e1-45949bb31943/thumbnail/1200x630/e7d32abb0639f56fba5f1f2944ceaeb6/cbsn-fusion-grand-jury-rejects-dojs-attempt-re-indict-ny-attorney-general-letitia-james-thumbnail.jpg",
"language": "en",
"published_at": "2025-12-04T23:41:00.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "fe2bcca1-c20c-4391-9cdb-00c44c47893e",
"title": "Grand jury declines to re-indict Letitia James in Virginia",
"description": "The Department of Justice was unable to secure a grand jury indictment against New York Attorney General Letitia James in Norfolk, Virginia, a source familiar said.",
"keywords": "",
"snippet": "NEW You can now listen to Fox News articles!\n\nThe Department of Justice failed to bring an indictment against Letitia James on Thursday after a federal judge to...",
"url": "https://www.foxnews.com/politics/grand-jury-declines-re-indict-letitia-james-virginia",
"image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/11/new-york-attorney-general-letitia-james.jpg",
"language": "en",
"published_at": "2025-12-04T23:08:22.000000Z",
"source": "foxnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
}
],
"business": ...,
"sports": ...,
"tech": ...,
"science": ...,
"health": ...
}
}
Top Stories Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/top HTTP/1.1
Use this endpoint to find live and historical top stories around the world or filter to get only top stories for specific countries. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
locale |
false | Comma separated list of country codes to include in the result set. Default is all countries.
Click here for a list of supported countries.
Example: us,ca (US + Canada).
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2025-12-05T07:23:19 |
2025-12-05T07:23 |
2025-12-05T07 |
2025-12-05 |
2025-12 |
2025
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2025-12-05T07:23:19 |
2025-12-05T07:23 |
2025-12-05T07 |
2025-12-05 |
2025-12 |
2025
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-12-05
|
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": 1492270,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "6ef4e905-daa6-4594-8e1d-1ec55a10d26f",
"title": "Ukrainian drone hits business center in southern Russia – media (VIDEO)",
"description": "A Ukrainian drone has hit a business center in Grozny, Chechen Republic, local media have reported",
"keywords": "",
"snippet": "The apparent strike ignited a fire in a high-rise building in Grozny, Chechen Republic, according to footage shared online\n\nA Ukrainian drone has crashed into a...",
"url": "https://www.rt.com/russia/629016-ukrainian-drone-hits-business-center/",
"image_url": "https://mf.b37mrtl.ru/files/static.en/article/breaking.jpg",
"language": "en",
"published_at": "2025-12-05T06:44:08.000000Z",
"source": "rt.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "d528e7a9-b2b3-40cf-bda1-1c51e90d86cf",
"title": "Russia’s largest bank to triple resources in India – chairman",
"description": "India will be one of the top markets for the next 20 years worldwide, Sberbank chief Herman Gref has said",
"keywords": "",
"snippet": "The South Asian country will be one of the top markets for the next 20 years worldwide, Sberbank chief Herman Gref has said\n\nRussia’s largest lender, Sberbank...",
"url": "https://www.rt.com/india/629013-sberbank-triple-resources-india/",
"image_url": "https://mf.b37mrtl.ru/files/2025.12/article/69327d8485f5401f2850a827.jpg",
"language": "en",
"published_at": "2025-12-05T06:40:44.000000Z",
"source": "rt.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "d88429f0-2a80-4914-acbe-3fbd32ff0dc5",
"title": "Miley Cyrus Jokes About Her Engagement Ring on Jimmy Kimmel",
"description": "Miley Cyrus engagement ring took center stage on Jimmy Kimmel as she joked Maxx Morando got a Black Friday deal a",
"keywords": "",
"snippet": "Miley Cyrus joked that her engagement ring from fiancé Maxx Morando was a bargain buy while appearing on Jimmy Kimmel Live!\n\nDuring the Thursday, December 4 ep...",
"url": "https://www.usmagazine.com/celebrity-news/news/miley-cyrus-jokes-about-her-engagement-ring-on-jimmy-kimmel/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2025/12/GettyImages-2249528254Miley-Cyrus-Jokes-About-Her-Engagement-Ring-From-Maxx-Morando.jpg?crop=240px%2C160px%2C1183px%2C621px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2025-12-05T06:39:27.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "a45458ed-c24f-4057-9f04-c8d8990bfa30",
"title": "What Sparked Sensei Biotherapeutics (SNSE) Stock's Nearly 63% After‑Hours Jump? - Sensei Biotherapeutics (NASDAQ:SNSE)",
"description": "Sensei Biotherapeutics surged in after-hours trading Thursday, with strong recent gains and ongoing shareholder activity drawing attention.",
"keywords": "",
"snippet": "Sensei Biotherapeutics Inc. (NASDAQ:SNSE) jumped 62.88% to $17.20 in after-hours trading on Thursday.\n\nCheck out the current price of SNSE stock here.\n\nAccordin...",
"url": "https://www.benzinga.com/markets/equities/25/12/49225076/what-sparked-sensei-biotherapeutics-snse-stocks-nearly-63-after%E2%80%91hours-jump",
"image_url": "https://cdn.benzinga.com/files/images/story/2025/12/05/Close-Up-Of-Smartphone-Of-Young-Asian-In.jpeg?width=1200&height=800&fit=crop",
"language": "en",
"published_at": "2025-12-05T06:31:52.000000Z",
"source": "benzinga.com",
"categories": [
"business"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "42d5eb87-c237-4e0f-9ec2-9a8104137af2",
"title": "DGA Plans To Meet With Netflix Over “Significant Concerns” Regarding Streamer’s Potential Warner Bros. Discovery Acquisition",
"description": "A DGA spokesperson says the guild plans to meet with Netflix regarding concerns over the giant streamer's potential purchase of Warner Bros, Discovery",
"keywords": "",
"snippet": "The Directors Guild of America says it plans to meet with Netflix to discuss “concerns” regarding the streamer’s potential acquisition of Warner Bros. Dis...",
"url": "https://deadline.com/2025/12/dga-reacts-netflix-warner-bros-discovery-deal-talks-1236637152/",
"image_url": "https://deadline.com/wp-content/uploads/2016/06/dga-directors-guild-logo.jpg?w=1000",
"language": "en",
"published_at": "2025-12-05T06:31:24.000000Z",
"source": "deadline.com",
"categories": [
"entertainment"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "2f57f44a-9712-4108-8a7d-f48da31dfb9a",
"title": "19-year-old arrested for role in shocking mob beating of couple at fiery NYC car meet-up",
"description": "19-year-old Justin Aguilera was arrested and hit with a slew of assault charges in connection with the beating of a couple during a fiery illegal car meet-up i...",
"keywords": "Metro, US News, arrests, assaults, fires, queens",
"snippet": "A 19-year-old was arrested and hit with a slew of assault charges Thursday in connection with the mob beatdown of a couple during an out-of-control illegal car ...",
"url": "https://nypost.com/2025/12/05/us-news/19-year-old-arrested-for-role-in-shocking-mob-beating-of-couple-at-fiery-nyc-car-meet-up/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2025/12/Justin-Aguilera-comp-1.jpg?quality=75&strip=all&w=1200",
"language": "en",
"published_at": "2025-12-05T06:12:02.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "d8be25c7-0cdb-43cc-9a67-ad369a0e567b",
"title": "Crossword: December 5, 2025",
"description": "The daily crossword from The Week",
"keywords": "",
"snippet": "Sign up for The Week's Free Newsletters\n\nFrom our morning news briefing to a weekly Good News Newsletter, get the best of The Week delivered directly to your in...",
"url": "https://theweek.com/puzzles/crossword-december-5-2025",
"image_url": "https://cdn.mos.cms.futurecdn.net/CU9J2tS5754BB7YGA7NG7Y-2550-80.jpg",
"language": "en",
"published_at": "2025-12-05T06:05:00.000000Z",
"source": "theweek.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "8a2287d6-28c6-47bd-b97c-c5ca626222f0",
"title": "Sudoku medium: December 5, 2025",
"description": "The daily medium sudoku puzzle from The Week",
"keywords": "",
"snippet": "Sign up for The Week's Free Newsletters\n\nFrom our morning news briefing to a weekly Good News Newsletter, get the best of The Week delivered directly to your in...",
"url": "https://theweek.com/puzzles/sudoku-medium-december-5-2025",
"image_url": "https://cdn.mos.cms.futurecdn.net/fqNgbcavqXtvUkCe29iULT-1400-80.png",
"language": "en",
"published_at": "2025-12-05T06:05:00.000000Z",
"source": "theweek.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "43291f61-d890-4de5-966c-7009bb2ca09f",
"title": "Sudoku hard: December 5, 2025",
"description": "The daily hard sudoku puzzle from The Week",
"keywords": "",
"snippet": "Sign up for The Week's Free Newsletters\n\nFrom our morning news briefing to a weekly Good News Newsletter, get the best of The Week delivered directly to your in...",
"url": "https://theweek.com/puzzles/sudoku-hard-december-5-2025",
"image_url": "https://cdn.mos.cms.futurecdn.net/fqNgbcavqXtvUkCe29iULT-1400-80.png",
"language": "en",
"published_at": "2025-12-05T06:05:00.000000Z",
"source": "theweek.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "ce0067f3-5c1f-411d-aa47-717937566066",
"title": "Codeword: December 5, 2025",
"description": "The daily codeword puzzle from The Week",
"keywords": "",
"snippet": "Sign up for The Week's Free Newsletters\n\nFrom our morning news briefing to a weekly Good News Newsletter, get the best of The Week delivered directly to your in...",
"url": "https://theweek.com/puzzles/codeword-december-5-2025",
"image_url": "https://cdn.mos.cms.futurecdn.net/DKQqCEhKyodz5iuX878Sok-1400-80.png",
"language": "en",
"published_at": "2025-12-05T06:04:00.000000Z",
"source": "theweek.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
}
]
}
All News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/all HTTP/1.1
Use this endpoint to find all live and historical articles we collect. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
search |
false | Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:+ signifies AND operation| signifies OR operation- negates a single token" wraps a number of tokens to signify a phrase for searching* at the end of a term signifies a prefix query( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash ( \).
Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")
For more advanced query examples, see our API Examples section. When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter. |
search_fields |
false | Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,keywordsDefault: title,main_text
|
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2025-12-05T07:23:19 |
2025-12-05T07:23 |
2025-12-05T07 |
2025-12-05 |
2025-12 |
2025
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2025-12-05T07:23:19 |
2025-12-05T07:23 |
2025-12-05T07 |
2025-12-05 |
2025-12 |
2025
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-12-05
|
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": 54541240,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "645ff619-2c78-4aa1-82a3-e4752fb1841d",
"title": "21岁女孩反复高热1个半月，柴胡五根汤两剂退烧，五剂痊愈",
"description": "21岁女孩反复高热1个半月，柴胡五根汤两剂退烧，五剂痊愈",
"keywords": "中医, 西医, 柴胡",
"snippet": "",
"url": "http://www.360doc.com/content/25/1205/07/28698007_1166037680.shtml",
"image_url": "http://thumbnail1.360doc.com/DownloadImg/2020/07/0507/i109/922454125_1.jpg",
"language": "zh",
"published_at": "2025-12-05T07:23:25.000000Z",
"source": "360doc.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "743d481a-4491-4aa2-8059-44f23275a25c",
"title": "우리은행, 생산적 금융 본격화...미래성장 위한 조직개편",
"description": "컨슈머타임스=김지훈 기자 | 우리은행(은행장 정진완)이 4일 △생산적 금융 본격화 △수익구조 다변화 △금융 AX혁신 강?...",
"keywords": "",
"snippet": "컨슈머타임스=김지훈 기자 | 우리은행(은행장 정진완)이 4일 △생산적 금융 본격화 △수익구조 다변화 △금융 AX혁신 강?...",
"url": "https://www.cstimes.com/news/articleView.html?idxno=682045",
"image_url": "https://www.cstimes.com/news/photo/202512/682045_600692_2312.jpeg",
"language": "ko",
"published_at": "2025-12-05T07:23:20.000000Z",
"source": "cstimes.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "05671297-3b9a-42fa-bcc9-6f7acd11034c",
"title": "보험 헬스케어, 의료법 규제 장벽에 '발목'",
"description": "인구 고령화가 급속도로 진행되면서 국민들의 건강관리(헬스케어) 수요가 폭증하고 있지만, 정작 보험사들이 관련 서비?...",
"keywords": "헬스케어, 보험, 의료, 의료법, 규제, 보험연구원",
"snippet": "인구 고령화가 급속도로 진행되면서 국민들의 건강관리(헬스케어) 수요가 폭증하고 있지만, 정작 보험사들이 관련 서비?...",
"url": "http://www.fins.co.kr/news/articleView.html?idxno=106834",
"image_url": "https://cdn.fins.co.kr/news/thumbnail/202512/106834_23897_2147_v150.jpg",
"language": "ko",
"published_at": "2025-12-05T07:22:54.000000Z",
"source": "fins.co.kr",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "dfd3ca62-18eb-4251-b205-bbb618ce7122",
"title": "反ハマス勢力トップ死亡 ガザ、イスラエル武器供与",
"description": "【エルサレム共同】パレスチナ自治区ガザでイスラム組織ハマスと敵対する武装勢力は4日、創設者のアブシャバブ氏が...",
"keywords": "西日本新聞me, 西日本新聞, ニュース, 九州, 福岡",
"snippet": "【エルサレム共同】パレスチナ自治区ガザでイスラム組織ハマスと敵対する武装勢力は4日、創設者のアブシャバブ氏が...",
"url": "https://www.nishinippon.co.jp/item/1431412/",
"image_url": "https://www.nishinippon.co.jp/assets/nnp/img/base/og_image.png",
"language": "ja",
"published_at": "2025-12-05T07:22:42.000000Z",
"source": "nishinippon.co.jp",
"categories": [],
"relevance_score": null
},
{
"uuid": "dd1303f5-0f19-417c-bb43-80e160eeb7e0",
"title": "看懂行情才能赚钱",
"description": "看懂行情才能赚钱",
"keywords": "行情, 基金, 资金",
"snippet": "",
"url": "http://www.360doc.com/content/25/1205/07/26778545_1166037653.shtml",
"image_url": "http://thumbnail1.360doc.com/DownloadImg/2021/06/1510/i109/982197877_1.jpg",
"language": "zh",
"published_at": "2025-12-05T07:22:31.000000Z",
"source": "360doc.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "88c3aa6e-45c2-4765-b930-8c32df92413c",
"title": "清开灵胶囊 中药中的退烧药，相当于西药里的布洛芬。如果发热不是很高，还没有38.5℃，不一定就要用这个药，普通的感冒药也有一定的退热作用。",
"description": "清开灵胶囊 中药中的退烧药，相当于西药里的布洛芬。如果发热不是很高，还没有38.5℃，不一定就要用这个药，普通的...",
"keywords": "胆酸, 胶囊, 药",
"snippet": "",
"url": "http://www.360doc.com/content/25/1205/07/1478467_1166037646.shtml",
"image_url": "http://thumbnail1.360doc.com/DownloadImg/2016/12/0206/i101/611359274_1.jpg",
"language": "zh",
"published_at": "2025-12-05T07:22:21.000000Z",
"source": "360doc.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "99cd7b8b-fa50-4057-8a5a-e8f631c40d29",
"title": "سوق دبي المالي: اليوم بدء التداول على أسهم تعليم القابضة دون الحق في الأرباح",
"description": "يبدأ اليوم الجمعة الموافق لـ 5 ديسمبر 2025، التداول على أسهم تعليم القابضة في سوق دبي الما?...",
"keywords": "أرقام موقع متخصص في متابعة اعمق لسوق الأسهم السعودي تداول مع تغطيه معمقة لشركات وأسعار البتروكيماويات, تقارير مالية, مؤشرات مالية, قطاع الأسمنت, البنوك",
"snippet": "\n\nشعار شركة تعليم القابضة\n\nيبدأ اليوم الجمعة الموافق لـ 5 ديسمبر 2025، التداول على أسهم تعل?...",
"url": "https://www.argaam.com/ar/article/articledetail/id/1863897",
"image_url": "https://argaamplus.s3.amazonaws.com/42a6b02c-3425-4054-b6e6-4ce0080c48b8.png",
"language": "ar",
"published_at": "2025-12-05T07:22:00.000000Z",
"source": "argaam.com",
"categories": [
"business"
],
"relevance_score": null
},
{
"uuid": "b79d500f-2758-46fd-b251-fe005e3a1b52",
"title": "一晃五年了，实习期间记录的一例五根汤治疗发热的案子",
"description": "一晃五年了，实习期间记录的一例五根汤治疗发热的案子",
"keywords": "十克, 柴胡, 汤",
"snippet": "",
"url": "http://www.360doc.com/content/25/1205/07/28698007_1166037634.shtml",
"image_url": "http://image109.360doc.com/DownloadImg/2025/12/0507/304113403_3_20251205072155555.jpeg",
"language": "zh",
"published_at": "2025-12-05T07:21:46.000000Z",
"source": "360doc.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "64dc8a0c-f954-4d17-b3dc-c3f2dfef09cf",
"title": "제25교구대중, 동안거 결제일 스리랑카 삼보사찰 순례하며 정진 - 불교신문",
"description": "조계종 제25교구 본사 봉선사 본말사 스님과 재가불자들이 12월4일 동안거 결제일 ‘사자의 나라’ 스리랑카에서 삼보 사...",
"keywords": "",
"snippet": "동안거 결제일을 맞아 석굴사원에서 정진하는 호산스님과 제25교구 주지스님들\n\n동안거 결제일을 맞아 부처님 치사리를 ...",
"url": "http://www.ibulgyo.com/news/articleView.html?idxno=433595",
"image_url": "https://cdn.ibulgyo.com/news/thumbnail/202512/433595_461043_4339_v150.jpg",
"language": "ko",
"published_at": "2025-12-05T07:21:34.000000Z",
"source": "ibulgyo.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "54f07271-e3b2-4934-b635-cafa52695c85",
"title": "流感肆虐，银翘散治发热一例",
"description": "流感肆虐，银翘散治发热一例",
"keywords": "流感, 妈妈, 喉咙",
"snippet": "",
"url": "http://www.360doc.com/content/25/1205/07/28698007_1166037618.shtml",
"image_url": "http://image109.360doc.com/DownloadImg/2025/12/0507/304113397_2_20251205072154616.jpeg",
"language": "zh",
"published_at": "2025-12-05T07:21:18.000000Z",
"source": "360doc.com",
"categories": [],
"relevance_score": null
}
]
}
Similar News Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/similar/uuid HTTP/1.1
Use this endpoint to find similar stories to a specific article based on its UUID.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
categories |
false | Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude. |
domains |
false | Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page. |
exclude_domains |
false | Comma separated list of domains to exclude |
source_ids |
false | Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page. |
exclude_source_ids |
false | Comma separated list of source_ids to exclude. |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
published_before |
false | Find all articles published before the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2025-12-05T07:23:19 |
2025-12-05T07:23 |
2025-12-05T07 |
2025-12-05 |
2025-12 |
2025
|
published_after |
false | Find all articles published after the specified date. Supported formats include:
Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2025-12-05T07:23:19 |
2025-12-05T07:23 |
2025-12-05T07 |
2025-12-05 |
2025-12 |
2025
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-12-05
|
limit |
false | Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan. |
page |
false | Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of articles found for the request. |
meta > returned |
The number of articles returned on the page.
This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page. |
meta > limit |
The limit based on the limit parameter. |
meta > page |
The page number based on the page parameter. |
data > uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
data > title |
The article title. |
data > description |
The article meta description. |
data > keywords |
The article meta keywords. |
data > snippet |
The first 60 characters of the article body. |
data > url |
The URL to the article. |
data > image_url |
The URL to the article image. |
data > language |
The language of the source. |
data > published_at |
The datetime the article was published. |
data > source |
The domain of the source. |
data > categories |
Array of strings which the source is categorized as. |
data > relevance_score |
Relevance score based on the article provided. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/similar/cc11e3ab-ced0-4a42-9146-e426505e2e67?api_token=YOUR_API_TOKEN&language=en&published_on=2020-12-01
Example Response
{
"meta": {
"found": 3571,
"returned": 3,
"limit": 3,
"page": 1
},
"data": [
{
"uuid": "df4ad427-a672-4c67-b6c6-6f81aa00e164",
"title": "Tesla stock jumps after announcement it will join S&P 500 in one go",
"description": "Tesla's stock price surged early Tuesday after the company b...",
"keywords": "Business, s&p 500, stocks, tesla",
"snippet": "Tesla’s stock price surged early Tuesday after the company...",
"url": "https://nypost.com/2020/12/01/tesla-stock-jumps-on-news-it-will-join-sp-500-in-one-shot/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2020/12/tesla-52.jpg?quality=90&strip=all&w=1200",
"language": "en",
"published_at": "2020-12-01T14:35:46.000000Z",
"source": "nypost.com",
"categories": [
"business"
],
"relevance_score": 153.61266
},
{
"uuid": "c9a23881-12dd-4005-8982-7b6552a2eb50",
"title": "Tesla To Join S&P 500 With Full Market Cap On December 21",
"description": "Tesla will be added to the S&P 500 index all at once at its ...",
"keywords": "Tesla, S&P500, EV, Automotive, Stocks, Investing",
"snippet": "Tesla (NASDAQ: TSLA) will be added to the S&P 500 index all ...",
"url": "https://oilprice.com/Latest-Energy-News/World-News/Tesla-To-Join-SP-500-With-Full-Market-Cap-On-December-21.html",
"image_url": "https://d32r1sh890xpii.cloudfront.net/news/718x300/2020-12-01_xwjdajwctl.jpg",
"language": "en",
"published_at": "2020-12-01T16:30:00.000000Z",
"source": "oilprice.com",
"categories": [
"general",
"business"
],
"relevance_score": 146.92773
},
{
"uuid": "18afdb1c-7742-4016-bf8c-a2f114e11199",
"title": "Tesla to Enter S&P 500 at Full Weight in December",
"description": "The electric-vehicle maker will be added to the broad stock-...",
"keywords": "Motor Vehicles, Alternative Fuel Vehicles, Trusts Funds Financial Vehicles, Diversified Holding Companies, Automotive",
"snippet": "S&P Dow Jones Indices said it will add Tesla Inc.’s full w...",
"url": "https://www.wsj.com/articles/tesla-to-enter-s-p-500-at-full-weight-in-december-11606780897?mod=pls_whats_news_us_business_f",
"image_url": "https://images.wsj.net/im-265933/social",
"language": "en",
"published_at": "2020-12-01T00:01:00.000000Z",
"source": "online.wsj.com",
"categories": [
"business"
],
"relevance_score": 128.22346
}
]
}
News by UUID Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/uuid/uuid HTTP/1.1
Use this endpoint to find specific articles by the UUID which is returned on our search endpoints. This is useful if you wish to store the UUID to return the article later.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
All dates are in UTC (GMT).
HTTP GET Parameters
| name | required | description |
|---|---|---|
api_token |
true | Your API token which can be found on your account dashboard. |
Response Objects
| name | description |
|---|---|
uuid |
The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint. |
title |
The article title. |
description |
The article meta description. |
keywords |
The article meta keywords. |
snippet |
The first 60 characters of the article body. |
url |
The URL to the article. |
image_url |
The URL to the article image. |
language |
The language of the source. |
published_at |
The datetime the article was published. |
source |
The domain of the source. |
categories |
Array of strings which the source is categorized as. |
If no results are found, a resource_not_found error will be returned.
Example Request
GET https://api.thenewsapi.com/v1/news/uuid/147013d8-6c2c-4d50-8bad-eb3c8b7f5740?api_token=YOUR_API_TOKEN
Example Response
{
"uuid": "147013d8-6c2c-4d50-8bad-eb3c8b7f5740",
"title": "These Are The Four American Companies Worth Over $1 Trillion Each – 24",
"description": "America’s major market indexes set records in the early pa...",
"keywords": "",
"snippet": "These Are The Four American Companies Worth Over $1 Trillion...",
"url": "https://247wallst.com/investing/2020/10/17/these-are-the-four-american-companies-worth-over-1-trillion-each/",
"image_url": "https://247wallst.com/wp-content/uploads/2020/08/imageForEntry2-Qrj.jpg",
"language": "en",
"published_at": "2020-10-17T11:16:20.000000Z",
"source": "247wallst.com",
"categories": [
"business"
]
}
Sources Available on: All plans
Endpoint
GET https://api.thenewsapi.com/v1/news/sources HTTP/1.1
Use this endpoint to sources to use in your news API requests. Note that the limit is 50 for all requests.
If you have issues with your requests, please ensure your GET parameters are URL-encoded.
All text data returned is UTF-8.
HTTP GET Parameters
| name | required | description |
|---|---|---|
categories |
false | Comma separated list of categories to include
Example: business,tech
|
exclude_categories |
false | Comma separated list of categories to exclude |
language |
false | Comma separated list of languages to include. Default is all.
Click here for a list of supported languages. Examples: en,es (English + Spanish)
|
page |
false | Use this to paginate through the result set. Default is 1.
Example: page=2
|
Response Objects
| name | description |
|---|---|
meta > found |
The number of sources found for the request. |
meta > returned |
The number of sources returned on the page. |
meta > limit |
The limit is 50. This currently can not be changed. |
meta > page |
The page number based on the page parameter. |
data > source_id |
The unique ID of the source feed. Use this for the source_ids or exclude_source_ids parameters in the news endpoints.
There may be many source_ids for each domain, therefore we would generally suggest using the domains filter instead the source_ids filter. |
data > domain |
The domain of the source. You can use this for the domains or exclude_domains parameters in the news endpoints. |
data > language |
The source language. |
data > locale |
The source locale. Note that only select sources have locales. |
data > categories |
Array of strings which the source is categorized as. |
If no results are found, the data object will be empty.
Example Request
GET https://api.thenewsapi.com/v1/news/sources?api_token=YOUR_API_TOKEN&language=en
Example Response
{
"meta": {
"found": 15453,
"returned": 50,
"limit": 50,
"page": 1
},
"data": [
{
"source_id": "arstechnica.com-1",
"domain": "arstechnica.com",
"language": "en",
"locale": null,
"categories": [
"tech"
]
},
{
"source_id": "adweek.com-1",
"domain": "adweek.com",
"language": "en",
"locale": null,
"categories": [
"business"
]
},
...
Errors
Errors
If your request was unsuccessful, you will receive a JSON formatted error. Below you will find the potential errors you may encounter when using the API.
Errors
| error code | HTTP status | description |
|---|---|---|
malformed_parameters |
400 |
Validation of parameters failed. The failed parameters are usually shown in the error message. |
invalid_api_token |
401 |
Invalid API token. |
usage_limit_reached |
402 |
Usage limit of your plan has been reached. Usage limit and remaining requests can be found on the X-UsageLimit-Limit header. |
endpoint_access_restricted |
403 |
Access to the endpoint is not available on your current subscription plan. |
resource_not_found |
404 |
Resource could not be found. |
invalid_api_endpoint |
404 |
API route does not exist. |
rate_limit_reached |
429 |
Too many requests in the past 60 seconds. Rate limit and remaining requests can be found on the X-RateLimit-Limit header. |
server_error |
500 |
A server error occured. |
maintenance_mode |
503 |
The service is currently under maintenance. |
Example Error Response
{
"error": {
"code": "malformed_parameters",
"message": "The published_before parameter(s) are incorrectly formatted."
}
}
Examples
API Examples
Our endpoints are very useful for filtering to find only specific resources you need. Follow each example request below to see how you can build dynamic queries.
Example Request 1
This is a basic request which will return all articles which match the search term "usd" within the title or body of the article:
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd
Example Request 2
This will return all articles which match the search term "usd" OR "gbp":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%7C%20gbp
Example Request 3
This will return all articles which match the search term "usd" AND "gbp":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%2B%20gbp
Example Request 4
This will return all articles which match the search term "usd" AND "gbp" but removes any articles which mentions "cad":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%2B%20gbp%20-cad
Example Request 5
This will return all articles which match the search term "forex" AND "usd" OR "gbp" but removes any articles which mentions "cad":
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=forex%20%2B%20%28usd%20%7C%20gbp%29%20-cad
Example Request 6
This is the same as Example Request 5 but will also ensure the articles returned are in English and categorized by business or tech but not travel, and are published within the last week:
GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=forex%20%2B%20%28usd%20%7C%20gbp%29%20-cad&language=en&categories=business%2Ctech&exclude_categories=travel&published_after=2025-11-28
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();