Documentation

Sign up for free!

Get instant access to the API with your free API token. No billing details required!

Sign up now

Getting Started

Introduction

Our API was developed to provide global news from thousands of sources with exceptional response times. On average we add over 1 million articles weekly, so you will never be short of content. Even better, it is completely free!

To get started simply sign up and use your API token in any of the available API endpoints documented below for instant access.

If you have any questions or concerns, feel free to contact us.

Authentication

As mentioned above, when you sign up for free you will find your API token on your dashboard. Simply add this to any of our API endpoints as a GET parameter to gain access. Examples of how this is done can be found below.

API Endpoints

Headlines Available on: Standard plan and above

Endpoint

            
                GET https://api.thenewsapi.com/v1/news/headlines HTTP/1.1

Use this endpoint to find get the latest headlines by category along with similar articles, allowing you to create the perfect news aggregation page similar to Google News .

If you have issues with your requests, please ensure your GET parameters are URL-encoded.

All text data returned is UTF-8.

All dates are in UTC (GMT).

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
locale false Comma separated list of country codes to include in the result set. Default is all countries. Click here for a list of supported countries.
Example: us,ca (US + Canada).
domains false Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page.
exclude_domains false Comma separated list of domains to exclude
source_ids false Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page.
exclude_source_ids false Comma separated list of source_ids to exclude.
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
published_on false Find headlines for articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-03-09
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": "746f7ad1-6472-492d-9419-8d52b30ad7cf",
                "title": "‘We’re going to make a tonne of money’: US Senator Graham on US war on Iran",
                "description": "The veteran GOP senator appears to suggest that the war on Iran was launched to gain control over its oil supplies.",
                "keywords": "Lindsey Graham, Iran, Donald Trump, Israel, country, nuclear weapons, President Barack Obama, Middle East",
                "snippet": "Powered by Yahoo Scout. Yahoo is using AI to generate key points from this article. This means the info may not always match what’s in the article. Reporting ...",
                "url": "https://www.yahoo.com/news/articles/going-tonne-money-us-senator-093054435.html",
                "image_url": "https://s.yimg.com/ny/api/res/1.2/01j4Da7DDY26LxrgiyEsSQ--/YXBwaWQ9aGlnaGxhbmRlcjt3PTEyMDA7aD04MDA7Y2Y9d2VicA--/https://media.zenfs.com/en/al_jazeera_289/1fab4a20a93126e48d22cf2034468700",
                "language": "en",
                "published_at": "2026-03-09T09:30:54.000000Z",
                "source": "yahoo.com",
                "categories": [
                    "general",
                    "business",
                    "sports",
                    "entertainment"
                ],
                "locale": "us",
                "similar": [
                    {
                        "uuid": "a2604411-e078-47b4-8353-2e1de487ae36",
                        "title": "U.S. orders staff to leave Saudi Arabia as Iran war spreads and oil surges above $110",
                        "description": "The U.S. ordered non-emergency government staff to leave Saudi Arabia as the widening Iran war rattled markets and sent oil prices surging above $110 per barrel.",
                        "keywords": "@LCO26Q, United States Oil Fund, LP, Saudi Arabia, Ali Khamenei, Iran, United States, Israel, Invesco DB Oil Fund, iShares MSCI Israel ETF, Lockheed Martin Corp, Northrop Grumman Corp, General Dynamics Corp, Foreign policy, US Bancorp, @GC26J, Exxon Mobil Corp, Chevron Corp, ConocoPhillips, Occidental Petroleum Equity Warrants Exp 3rd August 2027, Donald Trump, Halliburton Co, BP PLC, Shell PLC, Marathon Petroleum Corp, Valero Energy Corp, ProShares Ultra Bloomberg Crude Oil, @LCO26K, United States Brent Oil Fund, LP, Phillips 66, World economy, Breaking News: Economy, Economy, Breaking News: Markets, Markets, Breaking News: Politics, Politics, EOG Resources Inc, Edoc Acquisition Corp, China Automotive Systems Inc, iShares Global Energy ETF, TotalEnergies SE, Baker Hughes Co, Tehran, business news",
                        "snippet": "Smoke rises from the site of airstrikes in a central area of the Iranian capital Tehran on March 6, 2026.\n\nThe U.S. government ordered non-emergency government ...",
                        "url": "https://www.cnbc.com/2026/03/09/iran-war-updates-oil-brent-wti-crude-110-gulf-gcc-uae-iraq-saudi-arabia-kurds.html",
                        "image_url": "https://image.cnbcfm.com/api/v1/image/108274763-1772805551400-gettyimages-2264458531-AFP_A28K7KN.jpeg?v=1773014689&w=1920&h=1080",
                        "language": "en",
                        "published_at": "2026-03-09T03:29:14.000000Z",
                        "source": "cnbc.com",
                        "categories": [
                            "general",
                            "business"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "4c4ce169-d6e6-46fd-beec-8a907b957811",
                        "title": "World shares tumble as Iran war pushes crude prices over $110 a barrel",
                        "description": "Japan's benchmark Nikkei 225 index plunged more than 5% after oil prices soared to well over $100 a barrel due to disruptions from the war in the Middle East.",
                        "keywords": "Financial markets, Energy industry, General news, Middle East, Iran war, Persian Gulf, Stephen Innes, Economic indicators, Business, Donald Trump, International trade, Iran, South Korea, Japan, Energy markets, World news, Federal Reserve System, Lee Jae Myung, World News",
                        "snippet": "Add AP News as your preferred source to see more of our stories on Google.\n\nAdd AP News on Google Add AP News as your preferred source to see more of our storie...",
                        "url": "https://apnews.com/article/oil-stock-markets-iran-war-458890210407eb0cba85c7e1a684c890",
                        "image_url": "https://dims.apnews.com/dims4/default/8c6d96b/2147483647/strip/true/crop/8000x5331+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F36%2F2a%2F6cb82fa495c5d494cfcc807369e7%2Ff56bf290357b494eb4dcc1b18c931f60",
                        "language": "en",
                        "published_at": "2026-03-09T07:53:02.000000Z",
                        "source": "apnews.com",
                        "categories": [
                            "general"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "6af7e6eb-b89e-48f0-bcf8-c009f455f569",
                        "title": "Trump’s strike on Iran deals a major blow to Putin’s war machine in Ukraine",
                        "description": "U.S. strikes on Iran disrupt Shahed drone supply chain to Russia, potentially reducing Moscow's ability to terrorize Ukrainian civilians with Iranian-designed weapons of war.",
                        "keywords": "",
                        "snippet": "NEW You can now listen to Fox News articles!\n\nWithin hours of American munitions striking Iranian soil, Ukrainian President Volodymyr Zelenskyy posted a stateme...",
                        "url": "https://www.foxnews.com/opinion/trumps-strike-iran-deals-major-blow-putins-war-machine-ukraine",
                        "image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2024/02/Vladimir-Putin-meeting.jpg",
                        "language": "en",
                        "published_at": "2026-03-09T10:00:27.000000Z",
                        "source": "foxnews.com",
                        "categories": [
                            "general",
                            "politics"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "01552d76-0f8c-43c2-8246-c5d0f67a7264",
                        "title": "The dangerous lesson countries may take from the Iran war",
                        "description": "The dangerous lesson of the war in the Middle East.",
                        "keywords": "",
                        "snippet": "is a senior correspondent at Vox covering foreign policy and world news with a focus on the future of international conflict. He is the author of the 2018 book ...",
                        "url": "https://www.vox.com/politics/481880/iran-france-nuclear-deterrent",
                        "image_url": "https://platform.vox.com/wp-content/uploads/sites/2/2026/03/gettyimages-2263872773.jpg?quality=90&strip=all&crop=0%2C10.732984293194%2C100%2C78.534031413613&w=1200",
                        "language": "en",
                        "published_at": "2026-03-09T10:20:56.000000Z",
                        "source": "vox.com",
                        "categories": [
                            "general",
                            "politics",
                            "entertainment"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "1cef7f53-47e4-46a4-b312-4ca82e15b5b3",
                        "title": "Iran war exposes EU blunder in sanctioning Russia – Putin envoy",
                        "description": "The Iran war and rising oil prices show that the EU made a mistake by sanctioning Russian energy, Kirill Dmitriev has said",
                        "keywords": "",
                        "snippet": "Brent oil prices peaked at nearly $120 per barrel as another energy crisis looms\n\nThe Iran war has shown that EU sanctions on Russian energy were “strategic b...",
                        "url": "https://www.rt.com/russia/634248-iran-war-eu-russia-sanctions-blunder/",
                        "image_url": "https://mf.b37mrtl.ru/files/2026.03/article/69aeac2e85f5407abf2eb3ee.jpg",
                        "language": "en",
                        "published_at": "2026-03-09T11:17:42.000000Z",
                        "source": "rt.com",
                        "categories": [
                            "general",
                            "politics"
                        ],
                        "locale": "us"
                    }
                ]
            },
            {
                "uuid": "fee3607d-32e5-4b0a-b403-4bc8301baf60",
                "title": "Trump Causes Worldwide Panic Over Surging Oil Prices",
                "description": "President Trump’s war on Iran has caused a global oil crisis.",
                "keywords": "",
                "snippet": "“Frankly, they don’t have a lot of people to say that for them because the United States and the State of Israel have completely wiped out more than 50 lead...",
                "url": "https://newrepublic.com/post/207500/trump-global-panic-oil-prices",
                "image_url": "https://images.newrepublic.com/68505e8a327426f2490b9738ec1ef82d2c0fc2b7.jpeg?w=1200&h=630&crop=faces&fit=crop&fm=jpg",
                "language": "en",
                "published_at": "2026-03-09T12:55:57.000000Z",
                "source": "newrepublic.com",
                "categories": [
                    "general",
                    "politics",
                    "entertainment"
                ],
                "locale": "us",
                "similar": [
                    {
                        "uuid": "9f6a1d94-0477-4bf4-b72b-c73f21a6c50b",
                        "title": "Crude oil prices spike above $115 a barrel as the Iran war impedes production and shipping",
                        "description": "Oil prices have briefly spiked near $120 a barrel as the Iran war disrupts oil production and shipping in the Middle East.",
                        "keywords": "Energy industry, Iran war, Christopher Wright, Iran government, Financial markets, General news, AP Top News, Mohammad Bagher Qalibaf, World news, Iran, U.S. news, Politics, Business, World News, 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/markets-oil-iran-trump-war-brent-72e8c9a29c2ba1fd761ee968f3d4e553",
                        "image_url": "https://dims.apnews.com/dims4/default/ac75822/2147483647/strip/true/crop/6000x3998+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F3d%2Fa0%2F02ad06f466a07bdccbab1d3b4918%2Fe17e37c39b5a468583dfdfb1be1ec913",
                        "language": "en",
                        "published_at": "2026-03-09T07:53:02.000000Z",
                        "source": "apnews.com",
                        "categories": [
                            "general"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "300c7c83-169a-42b4-9eff-98e3cd887d5c",
                        "title": "Trump says short term oil price spikes ‘very small price’ for peace",
                        "description": "President Trump has claimed spiking short-term oil costs triggered by Operation Epic Fury is a “very small price” to pay for peace.",
                        "keywords": "Politics, US News, oil, trump",
                        "snippet": "President Trump said spiking short-term oil costs triggered by Operation Epic Fury is a “very small price” to pay for peace.\n\nTrump posted on Truth Social S...",
                        "url": "https://nypost.com/2026/03/09/us-news/trump-says-short-term-oil-price-spikes-very-small-price-for-peace/",
                        "image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/03/123140440.jpg?quality=75&strip=all&w=1200",
                        "language": "en",
                        "published_at": "2026-03-09T09:13:21.000000Z",
                        "source": "nypost.com",
                        "categories": [
                            "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,keywords
Default: title,main_text
locale false Comma separated list of country codes to include in the result set. Default is all countries. Click here for a list of supported countries.
Example: us,ca (US + Canada).
categories false Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel
Example: business,tech
exclude_categories false Comma separated list of categories to exclude.
domains false Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page.
exclude_domains false Comma separated list of domains to exclude
source_ids false Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page.
exclude_source_ids false Comma separated list of source_ids to exclude.
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
published_before false Find all articles published before the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-03-09T14:28:01 | 2026-03-09T14:28 | 2026-03-09T14 | 2026-03-09 | 2026-03 | 2026
published_after false Find all articles published after the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-03-09T14:28:01 | 2026-03-09T14:28 | 2026-03-09T14 | 2026-03-09 | 2026-03 | 2026
published_on false Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-03-09
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": 1568852,
        "returned": 10,
        "limit": 10,
        "page": 1
    },
    "data": [
        {
            "uuid": "59280b05-2536-42f2-81ac-0b5d4b729f87",
            "title": "2026 Players Championship: Ranking the top 25 players in the field",
            "description": "We run through the top contenders among the 123-man field to win the PGA Tour's flagship event at TPC Sawgrass.",
            "keywords": "",
            "snippet": "Open Extended Reactions\n\nPONTE VEDRA BEACH, Fla. -- The weather is finally heating up on the East Coast, and the PGA Tour is headed to The Players, its flagship...",
            "url": "https://www.espn.com/golf/story/_/id/48142426/2026-players-championship-ranking-top-25-players-field",
            "image_url": "https://a4.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0308%2Fr1625414_1296x729_16%2D9.jpg",
            "language": "en",
            "published_at": "2026-03-09T14:26:51.000000Z",
            "source": "espn.com",
            "categories": [
                "sports",
                "general"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "0c81ab95-b397-4551-aa2b-e978cc7bf129",
            "title": "Premier League giants can't afford to miss Champions League riches for even a season",
            "description": "The Champions League is back, but for the biggest clubs it's ever-more important that it never goes away as the price of failure to qualify increases.",
            "keywords": "",
            "snippet": "Open Extended Reactions\n\nThe UEFA Champions League is back this week, but for the biggest clubs, it is becoming increasingly important that it never goes away. ...",
            "url": "https://www.espn.com/soccer/story/_/id/48151544/premier-league-giants-cant-afford-miss-champions-league-riches-even-season",
            "image_url": "https://a3.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0309%2Fr1625615_1296x729_16%2D9.jpg",
            "language": "en",
            "published_at": "2026-03-09T14:21:25.000000Z",
            "source": "espn.com",
            "categories": [
                "sports",
                "general"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "afc87fa5-8c8c-411f-8c0a-308c88d93b83",
            "title": "Milan's big derby win; Arsenal's FA Cup scare; Yamal stars again; more",
            "description": "Milan's derby win over Inter has opened a little bit of a title race again in Italy ... at least for now. PLUS: Arsenal messed around in the FA Cup and nearly f...",
            "keywords": "",
            "snippet": "Open Extended Reactions\n\nIt's been a weekend, hasn't it? Europe's top teams, leagues and cup competitions all gave us plenty of fun and plenty to talk about, so...",
            "url": "https://www.espn.com/soccer/story/_/id/48150661/milan-derby-serie-arsenal-fa-cup-lamine-yamal-barcelona-spanish-laliga-analysis-gab-marcotti",
            "image_url": "https://a2.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0309%2Fr1625614_1296x729_16%2D9.jpg",
            "language": "en",
            "published_at": "2026-03-09T14:21:25.000000Z",
            "source": "espn.com",
            "categories": [
                "sports",
                "general"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "15288086-0dc0-4955-83ba-e9a2b4b94b35",
            "title": "Hasbro CEO Chris Cocks on AI, KPop Demon Hunters, and Harry Potter",
            "description": "Hasbro’s CEO discusses the video game market, how AI fits into toy design, and why he believes Harry Potter is a solid brand despite J. K. Rowling’s transph...",
            "keywords": "",
            "snippet": "Today, I’m talking with Chris Cocks, CEO of Hasbro.\n\nYou know, Hasbro — the toy and game company that makes some of the most iconic products in the world, f...",
            "url": "https://www.theverge.com/podcast/890703/hasbro-toys-games-magic-exodus-ai-tariffs",
            "image_url": "https://platform.theverge.com/wp-content/uploads/sites/2/2026/03/DCD_20260309_Cocks.jpg?quality=90&strip=all&crop=0%2C10.732984293194%2C100%2C78.534031413613&w=1200",
            "language": "en",
            "published_at": "2026-03-09T14:11:01.000000Z",
            "source": "theverge.com",
            "categories": [
                "tech"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "28a7a149-28f8-4d22-86e4-7d6dcc85b4b4",
            "title": "Hulk throws punch, 23 players sent off after mass brawl in Brazil final",
            "description": "Cruzeiro's 1-0 win over Atlético-MG in Sunday's Mineiro Championship final was overshadowed by a mass brawl that erupted seconds before the final whistle and r...",
            "keywords": "",
            "snippet": "Open Extended Reactions\n\nCruzeiro's 1-0 win over Atlético-MG in Sunday's Mineiro Championship final was overshadowed by a mass brawl that erupted seconds befor...",
            "url": "https://www.espn.com/soccer/story/_/id/48150964/hulk-sent-23-players-sent-mass-brawl-brazil-final",
            "image_url": "https://a4.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0309%2Fr1625576_1296x729_16%2D9.jpg",
            "language": "en",
            "published_at": "2026-03-09T14:10:06.000000Z",
            "source": "espn.com",
            "categories": [
                "sports",
                "general"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "2a4746a1-db95-48ab-b524-699a68752e79",
            "title": "What is economic abuse?",
            "description": "Prevalence of economic abuse in domestic-abuse deaths is a ‘wake-up call’, says report",
            "keywords": "",
            "snippet": "Economic abuse, a form of coercive control, plays a part in 51% of domestic abuse-related deaths in England and Wales. And, every 19 days, a victim of economic ...",
            "url": "https://theweek.com/crime/economic-abuse-by-partner-coercive-control",
            "image_url": "https://cdn.mos.cms.futurecdn.net/f2dbcvtCZEKtQa6NakSLSU-2000-80.jpg",
            "language": "en",
            "published_at": "2026-03-09T14:07:24.000000Z",
            "source": "theweek.com",
            "categories": [
                "general",
                "politics"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "2a0265ea-98c1-4e2b-acb2-cb7471f826f7",
            "title": "90 Day: The Single Life’s Liz Opens Up About Cancer Battle",
            "description": "'90 Day: The Single Life' star Liz Woods is hoping she finally found a special someone to discuss her cancer diagnosis with",
            "keywords": "",
            "snippet": "90 Day: The Single Life star Liz Woods is hoping she finally found a special someone to discuss her cancer diagnosis with.\n\nIn Us Weekly’s exclusive sneak pee...",
            "url": "https://www.usmagazine.com/entertainment/news/90-day-the-single-lifes-liz-opens-up-about-cancer-battle/",
            "image_url": "https://www.usmagazine.com/wp-content/uploads/2026/03/90-day-the-single-life-liz-villa.jpg?crop=0px%2C0px%2C2191px%2C1151px&resize=1200%2C630&quality=86&strip=all",
            "language": "en",
            "published_at": "2026-03-09T14:05:15.000000Z",
            "source": "usmagazine.com",
            "categories": [
                "entertainment",
                "general"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "c71a8782-4407-4351-8fec-8d63cc8e2370",
            "title": "I’ve studied MAGA rhetoric for a decade, and this is what I see in Hegseth’s boasts, action‑movie one‑liners and gloating over dominance",
            "description": "Why does Defense Secretary Pete Hegseth brag and gloat in his statements about the Iran war? In the MAGA media world, war is a game, a test of masculine fortitu...",
            "keywords": "",
            "snippet": "When Secretary of Defense James Mattis addressed the intensification of U.S. combat operations against the Islamic State group in 2017, he assured the American ...",
            "url": "https://theconversation.com/ive-studied-maga-rhetoric-for-a-decade-and-this-is-what-i-see-in-hegseths-boasts-action-movie-one-liners-and-gloating-over-dominance-277731",
            "image_url": "https://images.theconversation.com/files/722644/original/file-20260307-57-yumqfx.jpg?ixlib=rb-4.1.0&rect=0%2C501%2C5967%2C2983&q=45&auto=format&w=1356&h=668&fit=crop",
            "language": "en",
            "published_at": "2026-03-09T14:01:33.000000Z",
            "source": "theconversation.com",
            "categories": [
                "general",
                "politics"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "a83d4301-b48a-4462-8021-7fd849721ad0",
            "title": "Abandoned Pennsylvania mines and waste‑heat recycling could make the state’s massive new data centers far more sustainable",
            "description": "In Pennsylvania, new data centers could require enough electricity to  power 11 million homes.",
            "keywords": "",
            "snippet": "The electricity needed to power new Pennsylvania data centers already in advanced stages of planning could power 11 million homes – nearly twice the total num...",
            "url": "https://theconversation.com/abandoned-pennsylvania-mines-and-waste-heat-recycling-could-make-the-states-massive-new-data-centers-far-more-sustainable-273180",
            "image_url": "https://images.theconversation.com/files/720035/original/file-20260223-57-c6qarl.jpg?ixlib=rb-4.1.0&rect=0%2C870%2C8064%2C4032&q=45&auto=format&w=1356&h=668&fit=crop",
            "language": "en",
            "published_at": "2026-03-09T14:01:33.000000Z",
            "source": "theconversation.com",
            "categories": [
                "general",
                "politics"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "6370cb57-9f9d-4549-b47f-8337b53cbe37",
            "title": "Why do mountaintops stay snowy, even though they’re closer to the Sun?",
            "description": "The answer has to do with the air we breathe and that bright white snowpack, as an atmospheric scientist in Colorado explains.",
            "keywords": "",
            "snippet": "Curious Kids is a series for children of all ages. If you have a question you’d like an expert to answer, send it to [email protected].\n\nWhy d...",
            "url": "https://theconversation.com/why-do-mountaintops-stay-snowy-even-though-theyre-closer-to-the-sun-277560",
            "image_url": "https://images.theconversation.com/files/722165/original/file-20260304-68-3yi5iv.jpg?ixlib=rb-4.1.0&rect=0%2C614%2C7360%2C3680&q=45&auto=format&w=1356&h=668&fit=crop",
            "language": "en",
            "published_at": "2026-03-09T14:01:33.000000Z",
            "source": "theconversation.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,keywords
Default: title,main_text
categories false Comma separated list of categories to include.
Supported categories: general | science | sports | business | health | entertainment | tech | politics | food | travel
Example: business,tech
exclude_categories false Comma separated list of categories to exclude.
domains false Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page.
exclude_domains false Comma separated list of domains to exclude
source_ids false Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page.
exclude_source_ids false Comma separated list of source_ids to exclude.
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
published_before false Find all articles published before the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-03-09T14:28:01 | 2026-03-09T14:28 | 2026-03-09T14 | 2026-03-09 | 2026-03 | 2026
published_after false Find all articles published after the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-03-09T14:28:01 | 2026-03-09T14:28 | 2026-03-09T14 | 2026-03-09 | 2026-03 | 2026
published_on false Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-03-09
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": 53893705,
        "returned": 10,
        "limit": 10,
        "page": 1
    },
    "data": [
        {
            "uuid": "2563df7d-b074-42ef-8358-27596ee3b7a8",
            "title": "부처님 가르침 담은 사회복지 프로그램 찾는다 - 불교신문",
            "description": "불교사상과 부처님 가르침을 사회복지에 구현하려면 어떻게 해야 할까. 조계종사회복지재단(대표이사 도륜스님)은 ‘제...",
            "keywords": "",
            "snippet": "불교사상과 부처님 가르침을 사회복지에 구현하려면 어떻게 해야 할까. 조계종사회복지재단(대표이사 도륜스님)은 ‘제...",
            "url": "http://www.ibulgyo.com/news/articleView.html?idxno=436114",
            "image_url": "https://cdn.ibulgyo.com/news/thumbnail/202603/436114_465921_2657_v150.jpg",
            "language": "ko",
            "published_at": "2026-03-09T14:27:47.000000Z",
            "source": "ibulgyo.com",
            "categories": [],
            "relevance_score": null
        },
        {
            "uuid": "59280b05-2536-42f2-81ac-0b5d4b729f87",
            "title": "2026 Players Championship: Ranking the top 25 players in the field",
            "description": "We run through the top contenders among the 123-man field to win the PGA Tour's flagship event at TPC Sawgrass.",
            "keywords": "",
            "snippet": "Open Extended Reactions\n\nPONTE VEDRA BEACH, Fla. -- The weather is finally heating up on the East Coast, and the PGA Tour is headed to The Players, its flagship...",
            "url": "https://www.espn.com/golf/story/_/id/48142426/2026-players-championship-ranking-top-25-players-field",
            "image_url": "https://a4.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0308%2Fr1625414_1296x729_16%2D9.jpg",
            "language": "en",
            "published_at": "2026-03-09T14:26:51.000000Z",
            "source": "espn.com",
            "categories": [
                "sports",
                "general"
            ],
            "relevance_score": null
        },
        {
            "uuid": "d3dbeeeb-d69b-4cca-8acb-1585e2f9fa52",
            "title": "태안군-싱가포르 뷔나그룹 ‘1조 원대 해상풍력’ 투자협약",
            "description": "［중부매일 이희득 기자］ 태안군이 6일 싱가포르 스위소텔 더 스탬포드 호텔에서 뷔나그룹과 1조 원대 재생에너지(해상...",
            "keywords": "태안군, 뷔나그룹, 해상풍력",
            "snippet": "▲ 태안군청사 전경. / 태안군\n\n［중부매일 이희득 기자］ 태안군이 6일 싱가포르 스위소텔 더 스탬포드 호텔에서 뷔나그...",
            "url": "https://www.jbnews.com/news/articleView.html?idxno=1500028",
            "image_url": "https://cdn.jbnews.com/news/thumbnail/202603/1500028_1348493_3002_v150.jpg",
            "language": "ko",
            "published_at": "2026-03-09T14:26:40.000000Z",
            "source": "jbnews.com",
            "categories": [],
            "relevance_score": null
        },
        {
            "uuid": "f6a81ba9-7d38-4705-9a1f-0674a396fdd7",
            "title": "마크비전, ‘2026 브랜드 인텔리전스 리포트’ 발간…AI 기반 브랜드 위협 경험 기업↑",
            "description": "[테크월드뉴스=김혜진 기자] 마크비전이 AI 시대의 브랜드 위협 실태와 전략적 대응 방안을 담은 ‘2026 브랜드 인텔리전?...",
            "keywords": "마크비전",
            "snippet": "[테크월드뉴스=김혜진 기자] 마크비전이 AI 시대의 브랜드 위협 실태와 전략적 대응 방안을 담은 ‘2026 브랜드 인텔리전?...",
            "url": "https://www.epnc.co.kr/news/articleView.html?idxno=329538",
            "image_url": "https://cdn.epnc.co.kr/news/thumbnail/202603/329538_335242_2630_v150.jpg",
            "language": "ko",
            "published_at": "2026-03-09T14:26:36.000000Z",
            "source": "epnc.co.kr",
            "categories": [
                "tech"
            ],
            "relevance_score": null
        },
        {
            "uuid": "ac93b047-fe5a-40a3-8dbe-b263b8ceda8d",
            "title": "MDPI Phycology—论文—科学网",
            "description": "",
            "keywords": ", ",
            "snippet": "来源：Phycology 发布时间：2026/3/9 14:26:39 选择字号： 小 中 大 海藻的创新加工及工业应用 | MDPI Phycology 论文标题：Innovative ...",
            "url": "https://paper.sciencenet.cn/htmlpaper/2026/3/202639142635286147045.shtm?id=147045",
            "image_url": "https://paper.sciencenet.cn/upload/paper/images/2026/3/2026391426131610.png",
            "language": "zh",
            "published_at": "2026-03-09T14:26:00.000000Z",
            "source": "paper.sciencenet.cn",
            "categories": [
                "science",
                "tech",
                "general"
            ],
            "relevance_score": null
        },
        {
            "uuid": "0a81e56b-a4e8-4287-b223-9a3ef800f469",
            "title": "이규형 한신기업 대표, 충북자동차산업협회 이끈다",
            "description": "［중부매일 박상철 기자］ 이규형 한신기업㈜ 대표가 충북자동차산업협회를 이끈다.충북자동차산업협회(회장 신희증, ?...",
            "keywords": "충북자동차산업협회, 정기총회, 회장이취임식",
            "snippet": "▲ 제2대 충북자동차산업협회를 이끌게 되는 이규형 한신기업 대표./중부매일DB\n\n［중부매일 박상철 기자］ 이규형 한신?...",
            "url": "https://www.jbnews.com/news/articleView.html?idxno=1500031",
            "image_url": "https://cdn.jbnews.com/news/thumbnail/202603/1500031_1348496_3006_v150.jpg",
            "language": "ko",
            "published_at": "2026-03-09T14:25:45.000000Z",
            "source": "jbnews.com",
            "categories": [],
            "relevance_score": null
        },
        {
            "uuid": "bbf33014-e2c7-499b-800d-7a8219228618",
            "title": "넷마블, 게임업계 대학생 서포터즈 ‘마블챌린저’ 25기 발대식 개최  - 경향게임스",
            "description": "넷마블은 대학생 대외활동 프로그램 ‘마블챌린저’ 25기 발대식을 진행했다고 9일 밝혔다. ‘마블챌린저’는 게임을 좋...",
            "keywords": "",
            "snippet": "넷마블은 대학생 대외활동 프로그램 ‘마블챌린저’ 25기 발대식을 진행했다고 9일 밝혔다.\n\n\n\n제공=넷마블\n\n‘마블챌린?...",
            "url": "https://www.khgames.co.kr/news/articleView.html?idxno=302128",
            "image_url": "https://cdn.khgames.co.kr/news/photo/202603/302128_303613_2525.jpg",
            "language": "ko",
            "published_at": "2026-03-09T14:25:38.000000Z",
            "source": "khgames.co.kr",
            "categories": [],
            "relevance_score": null
        },
        {
            "uuid": "30bdcd6a-11fc-4ad0-ad65-645ea001fff6",
            "title": "\"연말연초 성과급 들어온다\"…27조 개인자금 국내증시 추가 유동성 기대 < 증권 < 기사본문",
            "description": "반도체와 조선 등 고부가가치 산업에서의 연말·연초 성과급이라는 강력한 현금 버퍼가 국내 증시의 든든한 하단 지지 ?...",
            "keywords": "",
            "snippet": "(서울=연합인포맥스) 송하린 기자 = 반도체와 조선 등 고부가가치 산업에서의 연말·연초 성과급이라는 강력한 현금 버퍼...",
            "url": "https://news.einfomax.co.kr/news/articleView.html?idxno=4402586",
            "image_url": "https://cdn.news.einfomax.co.kr/news/thumbnail/202603/4402586_298832_262_v150.jpg",
            "language": "ko",
            "published_at": "2026-03-09T14:25:31.000000Z",
            "source": "t240.ndsoftnews.com",
            "categories": [],
            "relevance_score": null
        },
        {
            "uuid": "6c3fa87b-8cb8-4085-9c12-b4a852695677",
            "title": "Live Nation Settles With DOJ in Illegal Monopoly Case",
            "description": "The Justice Department reached a settlement in its antitrust lawsuit against Ticketmaster and its parent company, Live Nation Entertainment, on Monday in a case...",
            "keywords": "Live Nation, Ticketmaster, Justice Department, monopoly, settlement",
            "snippet": "The Justice Department reached a settlement in its antitrust lawsuit against Ticketmaster and its parent company, Live Nation Entertainment, on Monday in a case...",
            "url": "https://www.newser.com/story/385049/live-nation-settles-with-doj-in-illegal-monopoly-case.html",
            "image_url": "https://img2-azrcdn.newser.com/image/1669805-12-20260309082526.jpeg",
            "language": "en",
            "published_at": "2026-03-09T14:25:26.000000Z",
            "source": "newser.com",
            "categories": [
                "general",
                "politics"
            ],
            "relevance_score": null
        },
        {
            "uuid": "10b976e3-6c68-41bc-a905-2b89df172ae2",
            "title": "나용찬 괴산군수 예비후보, 공공기관 유치·인구 5만명 달성 공약",
            "description": "［중부매일 서인석 기자］ 더불어민주당 나용찬 괴산군수 예비후보가 9일 군청 기자실에서 간담회를 갖고 ‘손으로 잡?...",
            "keywords": "나용찬",
            "snippet": "▲ 더불어민주당 나용찬 전 괴산군수. / 중부매일 DB\n\n［중부매일 서인석 기자］ 더불어민주당 나용찬 괴산군수 예비후보...",
            "url": "https://www.jbnews.com/news/articleView.html?idxno=1500029",
            "image_url": "https://cdn.jbnews.com/news/thumbnail/202603/1500029_1348494_3004_v150.jpg",
            "language": "ko",
            "published_at": "2026-03-09T14:25:18.000000Z",
            "source": "jbnews.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: 2026-03-09T14:28:01 | 2026-03-09T14:28 | 2026-03-09T14 | 2026-03-09 | 2026-03 | 2026
published_after false Find all articles published after the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2026-03-09T14:28:01 | 2026-03-09T14:28 | 2026-03-09T14 | 2026-03-09 | 2026-03 | 2026
published_on false Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-03-09
limit false Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan.
page false Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2

Response Objects

name description
meta > found The number of articles found for the request.
meta > returned The number of articles returned on the page. This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page.
meta > limit The limit based on the limit parameter.
meta > page The page number based on the page parameter.
data > uuid The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint.
data > title The article title.
data > description The article meta description.
data > keywords The article meta keywords.
data > snippet The first 60 characters of the article body.
data > url The URL to the article.
data > image_url The URL to the article image.
data > language The language of the source.
data > published_at The datetime the article was published.
data > source The domain of the source.
data > categories Array of strings which the source is categorized as.
data > relevance_score Relevance score based on the article provided.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.thenewsapi.com/v1/news/similar/cc11e3ab-ced0-4a42-9146-e426505e2e67?api_token=YOUR_API_TOKEN&language=en&published_on=2020-12-01

Example Response

            
                
            {
               "meta": {
                  "found": 3571,
                  "returned": 3,
                  "limit": 3,
                  "page": 1
               },
               "data": [
                  {
                     "uuid": "df4ad427-a672-4c67-b6c6-6f81aa00e164",
                     "title": "Tesla stock jumps after announcement it will join S&P 500 in one go",
                     "description": "Tesla's stock price surged early Tuesday after the company b...",
                     "keywords": "Business, s&p 500, stocks, tesla",
                     "snippet": "Tesla’s stock price surged early Tuesday after the company...",
                     "url": "https://nypost.com/2020/12/01/tesla-stock-jumps-on-news-it-will-join-sp-500-in-one-shot/",
                     "image_url": "https://nypost.com/wp-content/uploads/sites/2/2020/12/tesla-52.jpg?quality=90&strip=all&w=1200",
                     "language": "en",
                     "published_at": "2020-12-01T14:35:46.000000Z",
                     "source": "nypost.com",
                     "categories": [
                        "business"
                     ],
                     "relevance_score": 153.61266
                  },
                  {
                     "uuid": "c9a23881-12dd-4005-8982-7b6552a2eb50",
                     "title": "Tesla To Join S&P 500 With Full Market Cap On December 21",
                     "description": "Tesla will be added to the S&P 500 index all at once at its ...",
                     "keywords": "Tesla, S&P500, EV, Automotive, Stocks, Investing",
                     "snippet": "Tesla (NASDAQ: TSLA) will be added to the S&P 500 index all ...",
                     "url": "https://oilprice.com/Latest-Energy-News/World-News/Tesla-To-Join-SP-500-With-Full-Market-Cap-On-December-21.html",
                     "image_url": "https://d32r1sh890xpii.cloudfront.net/news/718x300/2020-12-01_xwjdajwctl.jpg",
                     "language": "en",
                     "published_at": "2020-12-01T16:30:00.000000Z",
                     "source": "oilprice.com",
                     "categories": [
                        "general",
                        "business"
                     ],
                     "relevance_score": 146.92773
                  },
                  {
                     "uuid": "18afdb1c-7742-4016-bf8c-a2f114e11199",
                     "title": "Tesla to Enter S&P 500 at Full Weight in December",
                     "description": "The electric-vehicle maker will be added to the broad stock-...",
                     "keywords": "Motor Vehicles, Alternative Fuel Vehicles, Trusts Funds Financial Vehicles, Diversified Holding Companies, Automotive",
                     "snippet": "S&P Dow Jones Indices said it will add Tesla Inc.’s full w...",
                     "url": "https://www.wsj.com/articles/tesla-to-enter-s-p-500-at-full-weight-in-december-11606780897?mod=pls_whats_news_us_business_f",
                     "image_url": "https://images.wsj.net/im-265933/social",
                     "language": "en",
                     "published_at": "2020-12-01T00:01:00.000000Z",
                     "source": "online.wsj.com",
                     "categories": [
                        "business"
                     ],
                     "relevance_score": 128.22346
                  }
               ]
            }

News by UUID Available on: All plans

Endpoint

            
                GET https://api.thenewsapi.com/v1/news/uuid/uuid HTTP/1.1

Use this endpoint to find specific articles by the UUID which is returned on our search endpoints. This is useful if you wish to store the UUID to return the article later.

If you have issues with your requests, please ensure your GET parameters are URL-encoded.

All text data returned is UTF-8.

All dates are in UTC (GMT).

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.

Response Objects

name description
uuid The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint.
title The article title.
description The article meta description.
keywords The article meta keywords.
snippet The first 60 characters of the article body.
url The URL to the article.
image_url The URL to the article image.
language The language of the source.
published_at The datetime the article was published.
source The domain of the source.
categories Array of strings which the source is categorized as.

If no results are found, a resource_not_found error will be returned.

Example Request

            
                GET https://api.thenewsapi.com/v1/news/uuid/147013d8-6c2c-4d50-8bad-eb3c8b7f5740?api_token=YOUR_API_TOKEN

Example Response

            
                
            {
                "uuid": "147013d8-6c2c-4d50-8bad-eb3c8b7f5740",
                "title": "These Are The Four American Companies Worth Over $1 Trillion Each – 24",
                "description": "America’s major market indexes set records in the early pa...",
                "keywords": "",
                "snippet": "These Are The Four American Companies Worth Over $1 Trillion...",
                "url": "https://247wallst.com/investing/2020/10/17/these-are-the-four-american-companies-worth-over-1-trillion-each/",
                "image_url": "https://247wallst.com/wp-content/uploads/2020/08/imageForEntry2-Qrj.jpg",
                "language": "en",
                "published_at": "2020-10-17T11:16:20.000000Z",
                "source": "247wallst.com",
                "categories": [
                    "business"
                ]
            }

Sources Available on: All plans

Endpoint

            
                GET https://api.thenewsapi.com/v1/news/sources HTTP/1.1

Use this endpoint to sources to use in your news API requests. Note that the limit is 50 for all requests.

If you have issues with your requests, please ensure your GET parameters are URL-encoded.

All text data returned is UTF-8.

HTTP GET Parameters

name required description
categories false Comma separated list of categories to include
Example: business,tech
exclude_categories false Comma separated list of categories to exclude
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
page false Use this to paginate through the result set. Default is 1.
Example: page=2

Response Objects

name description
meta > found The number of sources found for the request.
meta > returned The number of sources returned on the page.
meta > limit The limit is 50. This currently can not be changed.
meta > page The page number based on the page parameter.
data > source_id The unique ID of the source feed. Use this for the source_ids or exclude_source_ids parameters in the news endpoints. There may be many source_ids for each domain, therefore we would generally suggest using the domains filter instead the source_ids filter.
data > domain The domain of the source. You can use this for the domains or exclude_domains parameters in the news endpoints.
data > language The source language.
data > locale The source locale. Note that only select sources have locales.
data > categories Array of strings which the source is categorized as.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.thenewsapi.com/v1/news/sources?api_token=YOUR_API_TOKEN&language=en

Example Response

            
                
            {
                "meta": {
                    "found": 15453,
                    "returned": 50,
                    "limit": 50,
                    "page": 1
                },
                "data": [
                    {
                        "source_id": "arstechnica.com-1",
                        "domain": "arstechnica.com",
                        "language": "en",
                        "locale": null,
                        "categories": [
                            "tech"
                        ]
                    },
                    {
                        "source_id": "adweek.com-1",
                        "domain": "adweek.com",
                        "language": "en",
                        "locale": null,
                        "categories": [
                            "business"
                        ]
                    },
                    ...

Errors

Errors

If your request was unsuccessful, you will receive a JSON formatted error. Below you will find the potential errors you may encounter when using the API.

Errors

error code HTTP status description
malformed_parameters 400 Validation of parameters failed. The failed parameters are usually shown in the error message.
invalid_api_token 401 Invalid API token.
usage_limit_reached 402 Usage limit of your plan has been reached. Usage limit and remaining requests can be found on the X-UsageLimit-Limit header.
endpoint_access_restricted 403 Access to the endpoint is not available on your current subscription plan.
resource_not_found 404 Resource could not be found.
invalid_api_endpoint 404 API route does not exist.
rate_limit_reached 429 Too many requests in the past 60 seconds. Rate limit and remaining requests can be found on the X-RateLimit-Limit header.
server_error 500 A server error occured.
maintenance_mode 503 The service is currently under maintenance.

Example Error Response

            
                
            {
                "error": {
                    "code": "malformed_parameters",
                    "message": "The published_before parameter(s) are incorrectly formatted."
                }
            }

Examples

API Examples

Our endpoints are very useful for filtering to find only specific resources you need. Follow each example request below to see how you can build dynamic queries.

Example Request 1

This is a basic request which will return all articles which match the search term "usd" within the title or body of the article:

    
        GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd

Example Request 2

This will return all articles which match the search term "usd" OR "gbp":

    
        GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%7C%20gbp

Example Request 3

This will return all articles which match the search term "usd" AND "gbp":

    
        GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%2B%20gbp

Example Request 4

This will return all articles which match the search term "usd" AND "gbp" but removes any articles which mentions "cad":

    
        GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=usd%20%2B%20gbp%20-cad

Example Request 5

This will return all articles which match the search term "forex" AND "usd" OR "gbp" but removes any articles which mentions "cad":

    
        GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=forex%20%2B%20%28usd%20%7C%20gbp%29%20-cad

Example Request 6

This is the same as Example Request 5 but will also ensure the articles returned are in English and categorized by business or tech but not travel, and are published within the last week:

    
        GET https://api.thenewsapi.com/v1/news/all?api_token=YOUR_API_TOKEN&search=forex%20%2B%20%28usd%20%7C%20gbp%29%20-cad&language=en&categories=business%2Ctech&exclude_categories=travel&published_after=2026-03-02

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();