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-04-24
|
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": "5c641101-108a-46ab-abb3-b28658588959",
"title": "Trump wants automakers to move vehicle production to the U.S. It's not that simple",
"description": "DETROIT — When President Donald Trump hinted last week at a reprieve from 25% auto tariffs, he suggested it would be to allow automakers more time to move or increase U.S. vehicle production and parts.",
"keywords": "",
"snippet": "DETROIT — When President Donald Trump hinted last week at a reprieve from 25% auto tariffs, he suggested it would be to allow automakers more time to move or ...",
"url": "https://www.nbcnews.com/business/autos/trump-wants-automakers-move-vehicle-production-us-not-simple-rcna202665",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2025-04/250423-Ford-assembly-plant-ch-1539-f35e48.jpg",
"language": "en",
"published_at": "2025-04-23T19:44:14.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us",
"similar": [
{
"uuid": "9bee4f5c-c37a-4348-b008-37e32d1296ab",
"title": "Consumer spending is up big in early April as people buy in anticipation of tariffs",
"description": "Consumer spending is rising at a faster clip this month as everyday Americans rush to make purchases before President Donald Trump’s full tariff plan takes effect, data released Wednesday from JPMorgan shows.",
"keywords": "",
"snippet": "Consumer spending is rising at a faster clip this month as everyday Americans rush to make purchases before President Donald Trump’s full tariff plan takes ef...",
"url": "https://www.nbcnews.com/business/consumer/consumer-spending-big-early-april-people-buy-anticipation-tariffs-rcna202668",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2024-10/241008-shopper-shopping-bags-vl-500p-3f5727.jpg",
"language": "en",
"published_at": "2025-04-23T20:03:10.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "dd6b3528-010c-466d-ac33-df1b1ba0b148",
"title": "Kathy Hochul, Letitia James join lawsuit against Trump over tariffs in latest clash with prez",
"description": "New York officials joined a lawsuit aimed at President Trump’s controversial tariffs Wednesday – with Gov. Kathy Hochul accusing the White House of stirring “economic chaos” across the country.",
"keywords": "Politics, US News, Metro, donald trump, kathy hochul, lawsuits, letitia james, tariffs",
"snippet": "New York officials joined a lawsuit against President Trump’s tariffs on Wednesday – with Gov. Kathy Hochul calling the fees a tax hike that is stirring “...",
"url": "https://nypost.com/2025/04/23/us-news/kathy-hochul-letitia-james-join-lawsuit-against-trump-over-tariffs-in-latest-clash-with-prez/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2025/04/103178995.jpg?quality=75&strip=all&w=1024",
"language": "en",
"published_at": "2025-04-23T20:37:44.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"locale": "us"
},
{
"uuid": "c15ef3d7-e4aa-4fe8-8fd2-42fb4dfcbb58",
"title": "Trump considering exemption for automakers on some tariffs, White House says",
"description": "Trump is considering exemptions for automakers from some tariffs announced by his administration, the White House confirmed Wednesday.",
"keywords": "Trade, Politics, Autos, China, Eamon Javers, Donald Trump, Breaking News: Business, Breaking News: Politics, business news",
"snippet": "The new Ford F-150 truck is launched at a celebratory event at the Ford Dearborn Plant on April 11, 2024 in Dearborn, Michigan.\n\nPresident Donald Trump is consi...",
"url": "https://www.cnbc.com/2025/04/23/trump-considering-exemption-for-automakers-on-some-tariffs-white-house-says.html",
"image_url": "https://image.cnbcfm.com/api/v1/image/108130921-1744391703159-gettyimages-2209073871-ECP_fc1250920.jpeg?v=1744391806&w=1920&h=1080",
"language": "en",
"published_at": "2025-04-23T21:00:41.000000Z",
"source": "cnbc.com",
"categories": [
"general",
"business"
],
"locale": "us"
},
{
"uuid": "1a194848-d709-435f-a044-6c3223dd7578",
"title": "12 states sue Trump over tariff actions, saying it has \"brought chaos to the American economy\"",
"description": "The lawsuit said the policy put in place by President Trump has been subject to his",
"keywords": "Lawsuit, Tariffs, Trump Administration",
"snippet": "A dozen states sued the Trump administration in the U.S. Court of International Trade in New York on Wednesday to stop its tariff policy, saying it is unlawful ...",
"url": "https://www.cbsnews.com/news/states-sue-trump-over-tariffs/",
"image_url": "https://assets1.cbsnewsstatic.com/hub/i/r/2025/04/23/640bb484-4f99-44f1-9a4a-36e5ab6ef6a7/thumbnail/1200x630/83633cbfc0090ea5ce949131b24c92fd/gettyimages-2211023591.jpg?v=3c17db24e594e0bfc14b069a51163c10",
"language": "en",
"published_at": "2025-04-23T23:13:41.000000Z",
"source": "cbsnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
},
{
"uuid": "d0898bb7-7b7f-41f2-8ff1-581d0d1afe97",
"title": "Trump to mark 100th day in office with Michigan rally",
"description": "President Donald Trump plans to hold a rally in Michigan to mark his 100th day in office, White House press secretary Karoline Leavitt said on Wednesday.",
"keywords": "",
"snippet": "President Donald Trump plans to hold a rally in Michigan to mark his 100th day in office, White House press secretary Karoline Leavitt said on Wednesday.\n\n“Pr...",
"url": "https://www.nbcnews.com/politics/donald-trump/trump-mark-100th-day-office-michigan-rally-rcna202727",
"image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2025-04/250423-michigan-maga-rally-donald-trump-2024-ac-1004p-91428a.jpg",
"language": "en",
"published_at": "2025-04-24T03:15:57.000000Z",
"source": "nbcnews.com",
"categories": [
"general",
"politics"
],
"locale": "us"
}
]
},
{
"uuid": "742508b9-cbff-4c23-8360-3a65c794297b",
"title": "Today's NYT Mini Crossword Answers for April 24",
"description": "Here's today's NYT Mini Crossword answer. These answers will help you solve New York Times' popular crossword game, Mini Crossword, every day!",
"keywords": "",
"snippet": "Looking for the most recent Mini Crossword answer? Click here for today's Mini Crossword hints, as well as our daily answers and hints for The New York Times Wo...",
"url": "https://www.cnet.com/tech/gaming/todays-nyt-mini-crossword-answers-for-thursday-april-24/#ftag=CAD590a51e",
"image_url": "https://www.cnet.com/a/img/resize/5a44b4083f306f5c685f3e792be0473edc33c848/hub/2024/07/19/a459b55d-d069-4efa-bab4-4a28dfe8cc45/nyt-mini-crossword.jpg?auto=webp&fit=crop&height=675&width=1200",
"language": "en",
"published_at": "2025-04-24T02:07:00.000000Z",
"source": "cnet.com",
"categories": [
"tech",
"general"
],
"locale": "us",
"similar": [
{
"uuid": "57917eb4-bc50-4946-a458-4ec431699a17",
"title": "Today's NYT Connections Hints, Answers for April 24, #683",
"description": "Here's today's Connections answer and hints for groups. These clues will help you solve New York Times' popular puzzle game, Connections, every day!",
"keywords": "",
"snippet": "Looking for the most recent Connections answers? Click here for today's Connections hints, as well as our daily answers and hints for The New York Times Mini Cr...",
"url": "https://www.cnet.com/tech/gaming/todays-nyt-connections-hints-answers-and-help-for-april-24-683/#ftag=CAD590a51e",
"image_url": "https://www.cnet.com/a/img/resize/4479965e66e87adf111a6c2bc6765477e0b99c5e/hub/2024/04/30/cdc97512-da91-4895-8db4-90fa31dd8d25/word-games-connections-ny-times-9453.jpg?auto=webp&fit=crop&height=675&width=1200",
"language": "en",
"published_at": "2025-04-23T20:00:06.000000Z",
"source": "cnet.com",
"categories": [
"tech",
"general"
],
"locale": "us"
},
{
"uuid": "e1e4550c-9da7-4668-b7ac-913f44ee7d22",
"title": "Today's NYT Wordle Hints, Answer and Help for April 24, #1405",
"description": "Here's today's Wordle answer, plus a look at spoiler-free hints and past solutions. These clues will help you solve The New York Times' popular puzzle game, Wordle, every day.",
"keywords": "",
"snippet": "Looking for the most recent Wordle answer? Click here for today's Wordle hints, as well as our daily answers and hints for The New York Times Mini Crossword, Co...",
"url": "https://www.cnet.com/tech/gaming/todays-wordle-hints-answer-and-help-for-april-24-1405/#ftag=CAD590a51e",
"image_url": "https://www.cnet.com/a/img/resize/c2b8d1e2686bcca5e387fa0b6c89fa264d27a6c4/hub/2024/05/28/20480816-214e-4fcc-a9b4-b02f0ac71e7c/wordle-word-game-hints-puzzle-8667.jpg?auto=webp&fit=crop&height=675&width=1200",
"language": "en",
"published_at": "2025-04-23T20:00:07.000000Z",
"source": "cnet.com",
"categories": [
"tech",
"general"
],
"locale": "us"
},
{
"uuid": "a3d72160-eba4-4e54-ad69-648946805297",
"title": "Today's NYT Strands Hints, Answer and Help for April 24 #417",
"description": "Here's today's Strands answers and hints. These clues will help you solve The New York Times' popular puzzle game, Strands, every day.",
"keywords": "",
"snippet": "Looking for the most recent Strands answer? Click here for our daily Strands hints, as well as our daily answers and hints for The New York Times Mini Crossword...",
"url": "https://www.cnet.com/tech/gaming/todays-nyt-strands-hints-answers-and-help-for-april-24-417/#ftag=CAD590a51e",
"image_url": "https://www.cnet.com/a/img/resize/38504a76ffbe2999a9c021f1ef73ea3c567fde74/hub/2024/05/15/f6bde1ee-6b73-41f1-87b5-8421e159d837/nyt-new-york-times-strands-2043.jpg?auto=webp&fit=crop&height=675&width=1200",
"language": "en",
"published_at": "2025-04-23T20:43:00.000000Z",
"source": "cnet.com",
"categories": [
"tech",
"general"
],
"locale": "us"
},
{
"uuid": "f98a6937-c792-4a8d-8472-c7c34180d214",
"title": "Today's NYT Connections: Sports Edition Hints, Answers for April 24 #213",
"description": "Here's today's Connections: Sports Edition answer and hints for groups. These clues will help you solve The New York Times' popular puzzle game, Connections: Sports Edition, every day.",
"keywords": "",
"snippet": "Looking for the most recent regular Connections answers? Click here for today's Connections hints, as well as our daily answers and hints for The New York Times...",
"url": "https://www.cnet.com/tech/gaming/todays-nyt-connections-sports-edition-hints-and-answers-for-april-24-213/#ftag=CAD590a51e",
"image_url": "https://www.cnet.com/a/img/resize/a51721727ac6b71b8d078d611ca37505b9006739/hub/2024/10/16/ae3b5078-3ced-47c9-91dd-6b5b1b1a5809/connections-sports-edition-6832.jpg?auto=webp&fit=crop&height=675&width=1200",
"language": "en",
"published_at": "2025-04-23T20:54:41.000000Z",
"source": "cnet.com",
"categories": [
"tech",
"general"
],
"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-04-24T07:31:21 |
2025-04-24T07:31 |
2025-04-24T07 |
2025-04-24 |
2025-04 |
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-04-24T07:31:21 |
2025-04-24T07:31 |
2025-04-24T07 |
2025-04-24 |
2025-04 |
2025
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-04-24
|
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": 1295549,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "6b933fcb-6f61-4778-b35d-aa768a5715bf",
"title": "SEC Zooms In On Nayib Bukele-Led El Salvador's Crypto Regulation Model",
"description": "The Securities and Exchange Commission met with officials from El Salvador’s National Commission on Digital Assets on Tuesday to collaborate on cryptocurren...",
"keywords": "",
"snippet": "The Securities and Exchange Commission met with officials from El Salvador’s National Commission on Digital Assets on Tuesday to collaborate on cryptocurrency...",
"url": "https://www.benzinga.com/25/04/44971891/sec-teams-up-with-nayib-bukele-led-el-salvador-for-a-crypto-regulatory-sandbox",
"image_url": "https://cdn.benzinga.com/files/images/story/2025/04/24/Colourful-Painted-Big-National-Flag-Of-U.jpeg?width=1200&height=800&fit=crop",
"language": "en",
"published_at": "2025-04-24T07:14:11.000000Z",
"source": "benzinga.com",
"categories": [
"business"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "a5d7c31b-ba19-4feb-b5c8-3b6f782a3dc4",
"title": "A new AI app that helps you cheat in conversations is slick, a little creepy, and not quite ready for your next meeting",
"description": "The startup is founded by suspended Columbia student Chungin \"Roy\" Lee, who went viral for creating an AI tool that \"cheated\" on tech interviews.",
"keywords": "",
"snippet": "An advertisement for Cluely shows how the app can help users \"cheat\" on dates.\n\nAn advertisement for Cluely shows how the app can help users \"cheat\" on dates. C...",
"url": "https://www.businessinsider.com/cluely-ai-cheat-job-interviews-columbia-chungin-roy-lee-2025-4",
"image_url": "https://i.insider.com/6809bf433fe8d3928363eaaa?width=1200&format=jpeg",
"language": "en",
"published_at": "2025-04-24T07:11:14.000000Z",
"source": "businessinsider.com",
"categories": [
"business",
"tech"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "23343f54-db4f-4e6d-be05-152d094c392e",
"title": "Dollar-Denominated Debt Gives US Policymakers Edge In Navigating Economic Shocks, Says Expert: '...Are In The Privileged Position' - Invesco QQQ Trust, Series 1 (NASDAQ:QQQ), SPDR S&P 500 (ARCA:SPY)",
"description": "The US's unique position as the issuer of the reserve currency provides an advantage in navigating market shifts, according to Bob Elliot.",
"keywords": "",
"snippet": "With the ongoing shifts in the markets, the U.S.’s reliance on foreign capital is reversing, leading to lower asset prices. However, its unique position as th...",
"url": "https://www.benzinga.com/25/04/44971850/us-policymakers-are-privileged-says-expert-as-its-debt-in-usd-can-help-avoid-balance-of-payment-crisis",
"image_url": "https://cdn.benzinga.com/files/images/story/2025/04/24/Close-Up-Of-A-Stack-Of-Us-One-Dollar-Bil.jpeg?width=1200&height=800&fit=crop",
"language": "en",
"published_at": "2025-04-24T07:07:35.000000Z",
"source": "benzinga.com",
"categories": [
"business"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "16461e7c-2790-4523-a38f-7eabefbe4bbd",
"title": "Former US Army intelligence analyst sentenced for selling sensitive documents to Chinese national",
"description": "Korbein Schultz, 25, of Wills Point, Texas, pleaded guilty in August 2024 to conspiring to collect and transmit national defense information, unlawfully expor...",
"keywords": "US News, army, china, documents, sentences",
"snippet": "A former US Army intelligence analyst was sentenced to seven years in prison on Wednesday for giving sensitive military information to a person he believed was ...",
"url": "https://nypost.com/2025/04/24/us-news/us-army-intelligence-analyst-korbein-schultz-sentenced-for-selling-sensitive-documents-to-chinese-national/",
"image_url": "https://nypost.com/wp-content/uploads/sites/2/2025/04/103203516.jpg?quality=75&strip=all&w=1024",
"language": "en",
"published_at": "2025-04-24T07:05:32.000000Z",
"source": "nypost.com",
"categories": [
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "9ecc8be6-86f9-45e8-8624-e006c03732a5",
"title": "Emma Willis Heart Surgery: Love Is Blind UK Host Shares Health Scare",
"description": "Love Is Blind UK’s Emma Willis revealed she had keyhole heart surgery after discovering a hole in her heart, which went unnoticed for 48 years",
"keywords": "",
"snippet": "Love Is Blind UK host Emma Willis is opening up about a recent health scare.\n\nWillis, 49, shared via Instagram on Wednesday, April 23, that she underwent keyhol...",
"url": "https://www.usmagazine.com/celebrity-news/news/emma-willis-heart-surgery-love-is-blind-uk-host-shares-health-scare/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2025/04/emma.jpg?crop=0px%2C20px%2C1328px%2C697px&resize=1200%2C630&quality=86&strip=all",
"language": "en",
"published_at": "2025-04-24T07:02:16.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "e9b13dde-16a7-4fd6-a4c0-cca2428f5ad4",
"title": "Penn Badgley Unpacks ‘You’ Series Finale & Why Joe’s Downfall Is “So Rewarding”",
"description": "In an interview, Penn Badgley breaks down the series finale of Netflix's You and why Joe Goldberg's downfall had to happen the way it did.",
"keywords": "",
"snippet": "Spoiler alert: The following article contains details about the series finale for You.\n\nAfter seven years, it’s the end of You. Or, rather, the end of its mai...",
"url": "https://deadline.com/2025/04/penn-badgley-you-netflix-series-finale-interview-1236375709/",
"image_url": "https://deadline.com/wp-content/uploads/2025/04/YOU_502_Unit_00233RC.jpg?w=1024",
"language": "en",
"published_at": "2025-04-24T07:01:00.000000Z",
"source": "deadline.com",
"categories": [
"entertainment"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "d5b729be-d7f4-4c45-8a66-662552dfeee9",
"title": "Who Hooked Up During Vanderpump Villa and Mormon Wives Crossover?",
"description": "The crossover between 'The Secret Lives of Mormon Wives' and 'Vanderpump Villa' led to some romantic entanglements",
"keywords": "",
"snippet": "It’s the crossover of reality TV dreams, but who actually hooked up when the Vanderpump Villa cast met the women of The Secret Lives of Mormon Wives?\n\nDuring ...",
"url": "https://www.usmagazine.com/entertainment/news/who-hooked-up-during-vanderpump-villa-and-mormon-wives-crossover/",
"image_url": "https://www.usmagazine.com/wp-content/uploads/2025/04/Breaking-Down-Every-Hookup-During-Vanderpump-Villa-Marciano-Demi.jpg?crop=0px%2C18px%2C2000px%2C1050px&resize=1200%2C630&quality=55&strip=all",
"language": "en",
"published_at": "2025-04-24T07:00:03.000000Z",
"source": "usmagazine.com",
"categories": [
"entertainment",
"general"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "0f0e17eb-73d1-467d-872d-85aa8c7ca075",
"title": "Check out the pitch decks 4 buzzy AI startups used to raise $36 million from top investors",
"description": "Investors poured millions into these startups working in legal tech, cybersecurity, agent testing, and productivity.",
"keywords": "",
"snippet": "Paris-based startup Qevlar secured $14 million from EQT, Forgepoint, and strategic investors, including Datadog CEO Olivier Pomel.\n\nFounded in 2023, the startup...",
"url": "https://www.businessinsider.com/pitch-decks-ai-startups-qevlar-honeyhive-solve-intelligence-delos-vcs-2025-4",
"image_url": "https://i.insider.com/6808c3e43fe8d3928363cb75?width=1200&format=jpeg",
"language": "en",
"published_at": "2025-04-24T07:00:02.000000Z",
"source": "businessinsider.com",
"categories": [
"business",
"tech"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "a195cf70-2730-46fb-b852-eeca149bdcc9",
"title": "Codeword: April 24, 2025",
"description": "The Week's daily codeword puzzle",
"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-april-24-2025",
"image_url": "https://cdn.mos.cms.futurecdn.net/BHNtspXRVLWBNy8KTyoyzj.png",
"language": "en",
"published_at": "2025-04-24T07:00:00.000000Z",
"source": "theweek.com",
"categories": [
"general",
"politics"
],
"relevance_score": null,
"locale": "us"
},
{
"uuid": "8ae4f206-cb86-4608-b91e-9bb8f2d272c0",
"title": "Overnight strikes reported across Ukraine",
"description": "Kiev has faced the brunt of the attack, with numerous casualties, fires and damage to non-residential buildings, officials say",
"keywords": "",
"snippet": "Kiev has faced the brunt of the attack, with numerous casualties, fires, and damage to non-residential buildings, officials have said\n\nThe Russian military has ...",
"url": "https://www.rt.com/russia/616185-strikes-reported-ukraine-kiev/",
"image_url": "https://mf.b37mrtl.ru/files/2025.04/article/6809df2b203027395c3a7556.jpg",
"language": "en",
"published_at": "2025-04-24T06:59:06.000000Z",
"source": "rt.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-04-24T07:31:21 |
2025-04-24T07:31 |
2025-04-24T07 |
2025-04-24 |
2025-04 |
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-04-24T07:31:21 |
2025-04-24T07:31 |
2025-04-24T07 |
2025-04-24 |
2025-04 |
2025
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-04-24
|
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": 51941078,
"returned": 10,
"limit": 10,
"page": 1
},
"data": [
{
"uuid": "323243e1-6321-46d3-9d5d-f603d907b803",
"title": "بروج تعلن شراء 2.5 مليون سهم من أسهمها",
"description": "أعلنت شركة بروج بي إل سي، شراء ما يعادل 2.5 مليون سهم من أسهمها بنسبة 0.01% من رأس المال، بمت?...",
"keywords": "أرقام موقع متخصص في متابعة اعمق لسوق الأسهم السعودي تداول مع تغطيه معمقة لشركات وأسعار البتروكيماويات, تقارير مالية, مؤشرات مالية, قطاع الأسمنت, البنوك",
"snippet": "أرقام\n\nوحسب بيانات، أصدر مجلس إدارة شركة بروج بي إل سي الإثنين الموافق 7 أبريل 2025، قراراً...",
"url": "https://www.argaam.com/ar/article/articledetail/id/1807303",
"image_url": "https://argaamplus.s3.amazonaws.com/3d772436-82d4-4ae3-ac3a-a65663214590.png",
"language": "ar",
"published_at": "2025-04-24T07:31:00.000000Z",
"source": "argaam.com",
"categories": [
"business"
],
"relevance_score": null
},
{
"uuid": "d60cf3a5-ee2a-498f-81d8-b8d5549ee371",
"title": "KTM f?t ab Montag erneut Produktion f?rei Monate herunter",
"description": "Pierer Mobility (vormals KTM) - KTM f?t ab Montag erneut Produktion f?rei Monate herunter",
"keywords": "Kfz-Industrie, Sportindustrie, KTM, Ober?rreich, ",
"snippet": "12.96 +1.2% Hoch:\n\nTief: 13.68 +6.4%\n\n12.5 -2.4% Pierer Mobility (vormals KTM) Datum/Zeit: 24.04.2025 08:31\n\nQuelle: APA\n\nKTM f?t ab Montag erneut Produktion f?...",
"url": "https://aktien-portal.at/shownews.html?id=79744",
"image_url": "",
"language": "de",
"published_at": "2025-04-24T07:31:00.000000Z",
"source": "aktien-portal.at",
"categories": [
"business"
],
"relevance_score": null
},
{
"uuid": "2484817b-3de8-452e-b713-a718e23a162d",
"title": "MOVIE GAMES S.A.: Popremierowe dane dotyczące sprzedaży gry Drug Dealer Simulator na platformach Xbox",
"description": "Spis treści:1. RAPORT BIEŻĄCY2. MESSAGE (ENGLISH VERSION)3. INFORMACJE O PODMIOCIE4. PODPISY OSÓB REPREZENTUJĄCYCH SPÓŁKĘ KOMISJA NADZORU FINANSOWEGO Ra...",
"keywords": "",
"snippet": "Zarząd Movie Games S.A. z siedzibą w Warszawie [„Emitent\" lub „Spółka\"] w nawiązaniu do raportu bieżącego ESPI o numerze 8/2025 z dnia 4 marca 2025 r...",
"url": "https://www.bankier.pl/wiadomosc/MOVIE-GAMES-S-A-Popremierowe-dane-dotyczace-sprzedazy-gry-Drug-Dealer-Simulator-na-platformach-Xbox-8929854.html",
"image_url": "https://galeria.bankier.pl/p/0/f/c054fce945dcfc-thumb-1000.jpg",
"language": "pl",
"published_at": "2025-04-24T07:31:00.000000Z",
"source": "bankier.pl",
"categories": [],
"relevance_score": null
},
{
"uuid": "779669b6-aaaa-48c3-9345-79fa477406f8",
"title": "Senda celebr? jornada de trabajo y experiencias en Sevilla",
"description": "Mantente informado y actualizado sobre el sector seguros con nuestros medios especializados, Revista Aseguranza, Revista Mercado Previsor, Carta del Seguro y Ca...",
"keywords": "GRUPO ASEGURANZA Noticias de Seguros Mediadores de Seguros",
"snippet": "Senda Vivir Seguros celebró recientemente en Sevilla una jornada de trabajo que reunió a socios de toda España para \"compartir ideas, planificar nuevos proye...",
"url": "https://www.grupoaseguranza.com/noticias-de-mediacion/senda-celebro-jornada-trabajo-experiencias-sevilla",
"image_url": "https://www.grupoaseguranza.com/adjuntos/fichero_63125_20250424.jpg",
"language": "es",
"published_at": "2025-04-24T07:31:00.000000Z",
"source": "grupoaseguranza.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "5989f1a0-a79c-41fd-bb92-06dce268c04f",
"title": "涓€鍔燨nePlus Ace 5鎵嬫満12GB+256GB鍒版墜浠",
"description": "",
"keywords": "",
"snippet": "",
"url": "https://mobile.zol.com.cn/977/9770591.html",
"image_url": "",
"language": "zh",
"published_at": "2025-04-24T07:30:48.000000Z",
"source": "mobile.zol.com.cn",
"categories": [
"tech"
],
"relevance_score": null
},
{
"uuid": "d67970b2-404d-4783-8a91-80bf775b0cb6",
"title": "충북경찰청, 도민체전 안전 확보 위한 현장점검 및 대테러 합동훈련 실시",
"description": "[뉴스데일리]김학관 충북경찰청장은 충주에서 열리는 ‘제64회 충북도민체육대회’와 ‘제19회 충북장애인도민체육대회...",
"keywords": "",
"snippet": "대테러훈련(버스진입)\n\n김학관 충북청징이 국가중요시설 점검을 하고 있다.\n\n대테러훈련(가스살포관련)\n\n[뉴스데일리]김?...",
"url": "http://www.newsdaily.kr/news/articleView.html?idxno=246059",
"image_url": "https://cdn.newsdaily.kr/news/thumbnail/202504/246059_157419_2659_v150.jpg",
"language": "ko",
"published_at": "2025-04-24T07:30:38.000000Z",
"source": "newsdaily.kr",
"categories": [],
"relevance_score": null
},
{
"uuid": "fd0718f7-4007-4558-8f18-5f7d304fa589",
"title": "[노트북을 열며] 삶에 남은 정치, 그 사람을 다시 묻는다",
"description": "[굿모닝충청 신성재 기자] 정치는 권위로 밀어붙이는 일이 아니다. 국민의 삶을 이해하고, 그 마음에 가닿을 수 있는 진?...",
"keywords": "대선, 정책선거",
"snippet": "보문산에서 바라본 대전의 야경(굿모닝충청 신성재 기자)\n\n[굿모닝충청 신성재 기자] 정치는 권위로 밀어붙이는 일이 아?...",
"url": "https://www.goodmorningcc.com/news/articleView.html?idxno=419994",
"image_url": "https://cdn.goodmorningcc.com/news/thumbnail/202504/419994_424965_5513_v150.jpg",
"language": "ko",
"published_at": "2025-04-24T07:30:31.000000Z",
"source": "goodmorningcc.com",
"categories": [
"general"
],
"relevance_score": null
},
{
"uuid": "a40b86c7-e4c2-4d1b-b260-465b4ecb0268",
"title": "가상자산사업자 절반 이상 '자본잠식'",
"description": "가상자산사업자들의라이선스갱신이진행되고있는가운데실제사업을영위하거나갱신을마친업체들의절반이상이자본잠식?...",
"keywords": "",
"snippet": "",
"url": "https://www.coinreaders.com/156839",
"image_url": "http://www.coinreaders.com/data/coinreaders_com/banner/favicon.ico",
"language": "ko",
"published_at": "2025-04-24T07:30:28.000000Z",
"source": "coinreaders.com",
"categories": [],
"relevance_score": null
},
{
"uuid": "3326d2d0-3f0a-4c46-9c87-503640667f0a",
"title": "Vitrolife AB (publ) Interim report Q1, 2025: Strong performance in EMEA | VTRLY Stock News",
"description": "Vitrolife's Q1 2025 sales amounted to SEK 842 million, representing a 1% increase in local currencies. EMEA showed strong regional growth of 8%, while A",
"keywords": "GuruFocus, Article, News, GuruFocus News, VTRLY",
"snippet": "Vitrolife's Q1 2025 sales amounted to SEK 842 million, representing a 1% increase in local currencies.\n\nEMEA showed strong regional growth of 8%, while APAC sal...",
"url": "https://www.gurufocus.com/news/2799844/vitrolife-ab-publ-interim-report-q1-2025-strong-performance-in-emea-vtrly-stock-news",
"image_url": "https://static.gurufocus.com/images/global_logo_twitter_card.png",
"language": "en",
"published_at": "2025-04-24T07:30:16.000000Z",
"source": "gurufocus.com",
"categories": [
"business"
],
"relevance_score": null
},
{
"uuid": "8e27e062-8490-4d54-8aff-91599fcb4102",
"title": "韓대행, 오늘 국회서 '추경 시정연설'…'출마설' 입 열까",
"description": "한덕수 대통령 권한대행 국무총리가 24일 국회를 찾아 정부의 12조2천억원 규모 추가경정예산 편성에 대한 시정 연설을 ?...",
"keywords": "",
"snippet": "권한대행 시정연설, 46년 만…韓, 작년엔 尹 대독\n\n(서울=연합인포맥스) 정지서 기자 = 한덕수 대통령 권한대행 국무총리?...",
"url": "https://news.einfomax.co.kr/news/articleView.html?idxno=4352656",
"image_url": "https://cdn.news.einfomax.co.kr/news/thumbnail/202504/4352656_231198_312_v150.jpg",
"language": "ko",
"published_at": "2025-04-24T07:30:13.000000Z",
"source": "t240.ndsoftnews.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-04-24T07:31:21 |
2025-04-24T07:31 |
2025-04-24T07 |
2025-04-24 |
2025-04 |
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-04-24T07:31:21 |
2025-04-24T07:31 |
2025-04-24T07 |
2025-04-24 |
2025-04 |
2025
|
published_on |
false | Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-04-24
|
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-04-17
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();