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-07-16
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": "56ee27ba-e38d-42cd-be50-2566280d0a4c",
                "title": "Trump Spirals After Being Asked if His Name Is in Epstein Files",
                "description": "Donald Trump received a particularly blunt question about what he knows about the Epstein files.",
                "keywords": "",
                "snippet": "Asked whether Attorney General Pam Bondi told him his name is in the Epstein files, President Trump doubled down on the far-fetched notion that the whole thing ...",
                "url": "https://newrepublic.com/post/197996/trump-asked-name-epstein-files",
                "image_url": "https://images.newrepublic.com/40be8377325521d133f0e7294c76665d8870e0e2.jpeg?w=1200&h=630&crop=faces&fit=crop&fm=jpg",
                "language": "en",
                "published_at": "2025-07-15T20:19:52.000000Z",
                "source": "newrepublic.com",
                "categories": [
                    "general",
                    "politics",
                    "entertainment"
                ],
                "locale": "us",
                "similar": [
                    {
                        "uuid": "ccdb5d9b-4876-466b-8d5f-acc9705691e6",
                        "title": "House Republicans block release of Jeffrey Epstein files",
                        "description": "Just one Republican voted to release the files, calling the Trump administration's reversal",
                        "keywords": "",
                        "snippet": "House Republicans on Monday blocked a Democratic attempt to force the Justice Department to release all records related to Jeffrey Epstein, rejecting an amendme...",
                        "url": "https://www.salon.com/2025/07/15/house-republicans-block-release-of-jeffrey-epstein-files/",
                        "image_url": "https://www.salon.com/app/uploads/2025/07/virginia-foxx-2216327532.jpg",
                        "language": "en",
                        "published_at": "2025-07-15T14:51:34.000000Z",
                        "source": "salon.com",
                        "categories": [
                            "general"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "6ad56cf8-1958-4139-a905-45ecf5eaea3d",
                        "title": "Trump's Epstein files fiasco is indicative of a broader problem",
                        "description": "President Donald Trump's about-face on releasing Jeffrey Epstein files is indicative of a broader problem with the handling of public records in his administration.",
                        "keywords": "",
                        "snippet": "President Donald Trump’s about-face on releasing federal records on convicted sex offender Jeffrey Epstein has drawn rebuke from even some of his most stalwar...",
                        "url": "https://www.msnbc.com/opinion/msnbc-opinion/trump-epstein-files-public-records-project-47-newsletter-rcna218273",
                        "image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2025-07/250711-donald-trump-se-1150a-42b94a.jpg",
                        "language": "en",
                        "published_at": "2025-07-15T14:49:50.000000Z",
                        "source": "msnbc.com",
                        "categories": [
                            "general",
                            "politics"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "209b25e4-5806-4357-b624-cd5f0d9b3c63",
                        "title": "Jon Stewart: MAGA in “open revolt” over Epstein files",
                        "description": "The Daily Show host had some fun with the right-wing rupture over Jeffrey Epstein",
                        "keywords": "",
                        "snippet": "On Monday’s The Daily Show, Jon Stewart skewered President Donald Trump over the growing backlash from his own base after failing to deliver the long-promised...",
                        "url": "https://www.salon.com/2025/07/15/jon-stewart-maga-in-open-revolt-over-epstein-files/",
                        "image_url": "https://www.salon.com/app/uploads/2024/03/the_daily_show_still_11.jpg",
                        "language": "en",
                        "published_at": "2025-07-15T17:08:15.000000Z",
                        "source": "salon.com",
                        "categories": [
                            "general"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "86effb3e-8558-4a10-b7e9-d53c17f3a79a",
                        "title": "Calif. Dem rep’s bid to force release of Epstein files falls flat in House",
                        "description": "California Democratic Rep. Ro Khanna's bid to force the release of the Justice Department's files on notorious sex predator Jeffrey Epstein fell flat in the House on Monday.",
                        "keywords": "Politics, US News, congress, democrats, donald trump, jeffrey epstein, justice department",
                        "snippet": "California Democratic Rep. Ro Khanna’s bid to force the release of the Justice Department’s files on notorious sex predator Jeffrey Epstein fell flat in the...",
                        "url": "https://nypost.com/2025/07/15/us-news/ro-khannas-bid-to-force-release-of-epstein-files-falls-flat-in-house/",
                        "image_url": "https://nypost.com/wp-content/uploads/sites/2/2025/07/newspress-collage-ngikydjuj-1752598719688.jpg?quality=75&strip=all&1752584337&w=1024",
                        "language": "en",
                        "published_at": "2025-07-15T17:35:23.000000Z",
                        "source": "nypost.com",
                        "categories": [
                            "general"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "3ae6a1da-b756-401e-8c94-c5cadb7ba8fe",
                        "title": "211 House Republicans Vote to Block Release of Epstein Files",
                        "description": "House Republicans didn’t even want to allow debate on whether the Trump administration should be required to release the files.",
                        "keywords": "",
                        "snippet": "House Republicans on Tuesday blocked a rule to release the Epstein files, with zero Republicans supporting the measure. The final vote was 211 to 210. One Repub...",
                        "url": "https://newrepublic.com/post/197987/house-republicans-vote-block-epstein-files",
                        "image_url": "https://images.newrepublic.com/44b82f2adb8a4844cddd67cec1600cbd9f98fd79.jpeg?w=1200&h=630&crop=faces&fit=crop&fm=jpg",
                        "language": "en",
                        "published_at": "2025-07-15T18:24:15.000000Z",
                        "source": "newrepublic.com",
                        "categories": [
                            "general",
                            "politics",
                            "entertainment"
                        ],
                        "locale": "us"
                    }
                ]
            },
            {
                "uuid": "e5712571-2112-4b2d-9f0f-01b51d001edd",
                "title": "'American Idol' music supervisor and her husband found dead in their Los Angeles home",
                "description": "A suspect was taken into custody Tuesday, a day after an “American Idol” music supervisor and her husband were found shot to death in their Los Angeles home, police and a representative of the show said",
                "keywords": "",
                "snippet": "A suspect was taken into custody Tuesday, a day after an “American Idol” music supervisor and her husband were found shot to death in their Los Angeles home...",
                "url": "https://www.nbcnews.com/news/us-news/american-idol-music-supervisor-husband-found-dead-los-angeles-home-rcna219001",
                "image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2025-07/250715-robin-kaye-thomas-deluca-ugc-ac-748p-779729.jpg",
                "language": "en",
                "published_at": "2025-07-15T23:52:08.000000Z",
                "source": "nbcnews.com",
                "categories": [
                    "general",
                    "politics"
                ],
                "locale": "us",
                "similar": [
                    {
                        "uuid": "ebdc714c-278a-4c0b-9432-f4e05f531efb",
                        "title": "2 people found shot dead in home during welfare check in Los Angeles: Police",
                        "description": "Police found the victims while responding to the home in Encino on Monday afternoon, according to the Los Angeles Police Department",
                        "keywords": "Article, 123778341",
                        "snippet": "No arrests have been made, police said.\n\n2 people found shot dead in home during welfare check in Los Angeles: Police\n\nTwo found shot to death inside Encino hom...",
                        "url": "https://abcnews.go.com/US/encino-double-homicide-shooting/story?id=123778341",
                        "image_url": "https://i.abcnewsfe.com/a/de679062-8138-48e0-b201-4b93452934d5/cali-1-abc-er-250715_1752606201666_hpMain_16x9.jpg?w=1600",
                        "language": "en",
                        "published_at": "2025-07-15T19:55:48.000000Z",
                        "source": "abcnews.go.com",
                        "categories": [
                            "general"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "ab27c23f-4813-4b82-bd5b-e021784fb7ca",
                        "title": "Suspected Los Angeles arsonist run down by former college football player",
                        "description": "A former college football player ran down a suspected arsonist, and Los Angeles firefighters tackled hillside flames before the burning brush could get out of control, officials said Tuesday",
                        "keywords": "",
                        "snippet": "A former college football player ran down a suspected arsonist, and Los Angeles firefighters tackled hillside flames before the burning brush could get out of c...",
                        "url": "https://www.nbcnews.com/news/us-news/suspected-los-angeles-arsonist-run-former-college-football-player-rcna218911",
                        "image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2025-07/250715-kentucky-wildcats-Kentucky-Wildcats-Scott-Mitchell-se-1252p-10004a.jpg",
                        "language": "en",
                        "published_at": "2025-07-15T20:27:24.000000Z",
                        "source": "nbcnews.com",
                        "categories": [
                            "general",
                            "politics"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "c84549dd-e430-4f05-88c8-c9db8833295c",
                        "title": "Pentagon rescinds about half of National Guard troops in Los Angeles",
                        "description": "The Trump administration last month deployed thousands of National Guard troops to Los Angeles.",
                        "keywords": "",
                        "snippet": "About half of the California National Guard troops deployed to Los Angeles last month are being released, the Pentagon said Tuesday, significantly pulling back ...",
                        "url": "https://www.washingtonpost.com/nation/2025/07/15/trump-national-guard-los-angeles/",
                        "image_url": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://arc-anglerfish-washpost-prod-washpost.s3.amazonaws.com/public/THKJRUZBE3SRLIMQ7456BLFY3E_size-normalized.JPG&w=1440",
                        "language": "en",
                        "published_at": "2025-07-15T23:56:12.000000Z",
                        "source": "washingtonpost.com",
                        "categories": [
                            "general"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "865bb62e-94f8-4fa2-9e25-108567870386",
                        "title": "Alleged burglar arrested in the shooting deaths of ‘American Idol’ boss Robin Kaye and her husband: report",
                        "description": "A longtime \"American Idol\" supervisor and her musician husband were allegedly gunned down in their California home by a burglar – who has been arrested over the shocking double murder, according to a report.",
                        "keywords": "US News, american idol, burglaries, los angeles, murders",
                        "snippet": "A longtime “American Idol” supervisor and her musician husband were allegedly gunned down in their California home by a burglar – who has been arrested ov...",
                        "url": "https://nypost.com/2025/07/15/us-news/alleged-burglar-arrested-in-the-shooting-deaths-of-american-idol-boss-robin-kaye-and-her-husband-report/",
                        "image_url": "https://nypost.com/wp-content/uploads/sites/2/2025/07/newspress-collage-booif94lc-1752623293353.jpg?quality=75&strip=all&1752608906&w=1024",
                        "language": "en",
                        "published_at": "2025-07-15T23:50:44.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: 2025-07-16T02:31:50 | 2025-07-16T02:31 | 2025-07-16T02 | 2025-07-16 | 2025-07 | 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-07-16T02:31:50 | 2025-07-16T02:31 | 2025-07-16T02 | 2025-07-16 | 2025-07 | 2025
published_on false Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-07-16
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": 1370692,
        "returned": 10,
        "limit": 10,
        "page": 1
    },
    "data": [
        {
            "uuid": "aa93ae9d-5ab6-4c89-9862-7bd413331026",
            "title": "TikToker Madeleine White Marries Andrew Fedyk: See Her Wedding Dress",
            "description": "Madeleine White married Andrew Fedyk in a Viktor & Rolf wedding dress featuring 40 hand-appliquéd butterflies, before switching into Berta and Versace for the ...",
            "keywords": "",
            "snippet": "Watch : 2024 Celebrity Weddings: All the Stars Who Have Tied the Knot!\n\nLeave it to Madeleine White to find her wedding dress on TikTok.\n\nThe influencer—whose...",
            "url": "https://www.eonline.com/news/1419902/madeleine-white-marries-andrew-fedyk-wedding-dress-photos?cmpid=rss-syndicate-genericrss-us-top_stories",
            "image_url": "https://akns-images.eonline.com/eol_images/Entire_Site/20250715/73e2ce40-335f-4e42-95e9-00dc219624cd_1752627760.jpg?fit=around%7C1080:1080&output-quality=90&crop=1080:1080;center,top",
            "language": "en",
            "published_at": "2025-07-16T02:01:45.000000Z",
            "source": "eonline.com",
            "categories": [
                "entertainment",
                "general"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "bbc59255-a109-4de2-a431-478d677ca029",
            "title": "The Valley's Nia Sanchez Debates Mommy Makeover After Kids",
            "description": "Nia Sanchez reflected on body image as she debated a mommy makeover during ‘The Valley’ with her husband Danny Booko by her side",
            "keywords": "",
            "snippet": "Nia Sanchez is hoping to feel good in her clothes again as she debates a mommy makeover.\n\nDuring the Tuesday, July 15, episode of The Valley, the reality star, ...",
            "url": "https://www.usmagazine.com/entertainment/news/the-valleys-nia-sanchez-debates-mommy-makeover-after-kids/",
            "image_url": "https://www.usmagazine.com/wp-content/uploads/2025/07/nia-sanchez-the-valley2.jpg?crop=258px%2C148px%2C856px%2C449px&resize=1200%2C630&quality=55&strip=all",
            "language": "en",
            "published_at": "2025-07-16T02:00:44.000000Z",
            "source": "usmagazine.com",
            "categories": [
                "entertainment",
                "general"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "b60f1f74-4c29-4e1b-a4e0-3224d4e560b9",
            "title": "NYC Council rejects land use change for Bally’s planned Bronx casino — effectively killing bid for gaming license",
            "description": "The City Council voted to reject a land-use change for Bally's Corp. to open a casino at the golf property formerly operated by President Trump's firm at Ferry ...",
            "keywords": "Metro, US News, casinos, donald trump, the bronx, trump golf links at ferry point, trump organization",
            "snippet": "The City Council voted to reject a land-use change for Bally’s to open a casino at the Bronx golf property formerly operated by President Trump’s company ?...",
            "url": "https://nypost.com/2025/07/15/us-news/nyc-council-rejects-land-use-change-for-ballys-planned-bronx-casino-effectively-killing-bid-for-gaming-license/",
            "image_url": "https://nypost.com/wp-content/uploads/sites/2/2025/07/newspress-collage-8804oq2h3-1752630579507.jpg?quality=75&strip=all&1752616249&w=1024",
            "language": "en",
            "published_at": "2025-07-16T01:56:15.000000Z",
            "source": "nypost.com",
            "categories": [
                "general"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "6459f506-de40-4e45-b82a-b08ed041ed00",
            "title": "Kylie Jenner sets pulses racing in polka-dot bikini photos ahead of summer swimsuit launch",
            "description": "Kylie Jenner generates fan excitement with Instagram photos featuring her new swimwear collection, a collaboration between Frankies Bikinis and her brand Khy la...",
            "keywords": "",
            "snippet": "NEW You can now listen to Fox News articles!\n\nKylie Jenner is turning heads while teasing her latest collaboration.\n\nThe 27-year-old \"Keeping Up with the Kardas...",
            "url": "https://www.foxnews.com/entertainment/kylie-jenner-sets-pulses-racing-polka-dot-bikini-photos-ahead-summer-swimsuit-launch",
            "image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/07/kylie-jenner-split.jpg",
            "language": "en",
            "published_at": "2025-07-16T01:51:26.000000Z",
            "source": "foxnews.com",
            "categories": [
                "general",
                "politics"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "8e8a6bdb-ef1f-4ebd-87f7-023ff3634b3d",
            "title": "New person of interest revealed in 1995 vanishing of beloved Iowa news anchor: documentary",
            "description": "Jodi Huisentruit vanished from outside her apartment in June 1995. She's never been found.",
            "keywords": "US News, abductions, cold cases, documentaries, iowa, kidnappings, missing persons, news anchors",
            "snippet": "A new person of interest has been revealed in the baffling cold case of Iowa news anchor Jodi Huisentruit, who vanished from her home on a summer morning over 3...",
            "url": "https://nypost.com/2025/07/15/us-news/new-person-of-interest-revealed-in-1995-vanishing-of-beloved-iowa-news-anchor-documentary/",
            "image_url": "https://nypost.com/wp-content/uploads/sites/2/2025/07/108200829.jpg?quality=75&strip=all&w=1024",
            "language": "en",
            "published_at": "2025-07-16T01:48:36.000000Z",
            "source": "nypost.com",
            "categories": [
                "general"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "32ecc491-3c89-415b-871c-9c1e5ce0fff3",
            "title": "'Ruthless' podcast hosts think Newsom's pivot from radical stances is 'BS' but a 'bold move'",
            "description": "Ruthless podcast hosts criticize California Gov. Gavin Newsom's political pivot away from far-left positions, suggesting he's preparing for a 2028 presidential ...",
            "keywords": "",
            "snippet": "NEW You can now listen to Fox News articles!\n\n\"Ruthless\" podcast hosts Josh Holmes, Michael Duncan, John Ashbrook and Comfortably Smug took aim at Democratic Ca...",
            "url": "https://www.foxnews.com/media/ruthless-podcast-hosts-think-newsoms-pivot-from-radical-stances-bs-bold-move",
            "image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2024/12/newsom-degrees.jpg",
            "language": "en",
            "published_at": "2025-07-16T01:33:54.000000Z",
            "source": "foxnews.com",
            "categories": [
                "general",
                "politics"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "1f26df1d-02f4-4c5b-a4ec-8f2bf82a9f8a",
            "title": "Rep. James Comer mocks NBC story equating his digital signature with Biden's autopen scandal",
            "description": "Rep. James Comer, R-Ky., responded to an NBC story that compared his use of a digital signature to former President Joe Biden’s use of an autopen in office.",
            "keywords": "",
            "snippet": "NEW You can now listen to Fox News articles!\n\nHouse Oversight Committee chairman Rep. James Comer, R-Ky., ripped NBC News and one of its reporters on Tuesday fo...",
            "url": "https://www.foxnews.com/media/rep-james-comer-mocks-nbc-story-equating-his-digital-signature-bidens-autopen-scandal",
            "image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2023/01/GettyImages-1246229761.jpg",
            "language": "en",
            "published_at": "2025-07-16T01:30:43.000000Z",
            "source": "foxnews.com",
            "categories": [
                "general",
                "politics"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "2b5abad9-8928-41f8-a4ce-27d6240bb8c0",
            "title": "Cathie Wood Doubles Down On Tesla Despite Leadership Exodus, Dumps $22 Million Of Crypto Stocks Amid Bitcoin Buzz - ARK 21Shares Bitcoin ETF Common Shares of Beneficial Interests (BATS:ARKB)",
            "description": "Cathie Wood-led Ark Invest made significant trades on Tuesday, involving major companies like Tesla Inc. (NASDAQ:TSLA), Coinbase Global Inc.",
            "keywords": "",
            "snippet": "Cathie Wood-led Ark Invest made significant trades on Tuesday, involving major companies like Tesla Inc. TSLA, Coinbase Global Inc. COIN, ARK 21Shares Bitcoin E...",
            "url": "https://www.benzinga.com/etfs/broad-u-s-equity-etfs/25/07/46433784/cathie-wood-doubles-down-on-tesla-despite-leadership-exodus-dumps-22-million-of-crypto",
            "image_url": "https://cdn.benzinga.com/files/images/story/2025/07/15/Germany--Mannheim-January-29--2025--Sign.jpeg?width=1200&height=800&fit=crop",
            "language": "en",
            "published_at": "2025-07-16T01:29:13.000000Z",
            "source": "benzinga.com",
            "categories": [
                "business"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "46cf467d-dc00-4d34-9827-8924fdcb27b6",
            "title": "Joe Rogan weighs in on Jeffrey Epstein files controversy amid uproar over DOJ probe",
            "description": "Joe Rogan lambasted the Trump administration's announcement that there was never a list or footage revealing clients of high-flying pedophile Jeffrey Epstein --...",
            "keywords": "US News, Media, conspiracy theories, donald trump, jeffrey epstein, joe rogan, podcasts",
            "snippet": "Joe Rogan used his latest podcast episode to weigh in on the Epstein files controversy amid public uproar over the Department of Justice’s probe into the late...",
            "url": "https://nypost.com/2025/07/15/us-news/joe-rogan-weighs-in-on-jeffrey-epstein-files-controversy-amid-uproar-over-doj-probe/",
            "image_url": "https://nypost.com/wp-content/uploads/sites/2/2025/07/joe-rogan-lambasts-trump-admin-108211866.jpg?quality=75&strip=all&w=1024",
            "language": "en",
            "published_at": "2025-07-16T01:27:41.000000Z",
            "source": "nypost.com",
            "categories": [
                "general"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "6534ba8d-4451-438e-bc1e-5c37a6be8d0a",
            "title": "Senate Votes To Advance Trump’s Effort To Rescind Funding For PBS, NPR And Public Media",
            "description": "The bill would claw back $1.1 billion to PBS, NPR and public media",
            "keywords": "",
            "snippet": "The Senate voted on Tuesday evening to advance a package that would roll back $1.1 billion in funding to PBS, NPR and public media that had already been allocat...",
            "url": "https://deadline.com/2025/07/public-broadcasting-senate-funding-trump-rescissions-1236458885/",
            "image_url": "https://deadline.com/wp-content/uploads/2025/07/GettyImages-2225257762.jpg?w=1024",
            "language": "en",
            "published_at": "2025-07-16T01:22:34.000000Z",
            "source": "deadline.com",
            "categories": [
                "entertainment"
            ],
            "relevance_score": null,
            "locale": "us"
        }
    ]
}
            
        

All News Available on: All plans

Endpoint

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

Use this endpoint to find all live and historical articles we collect. Filtering by language, category, source and publish date is also possible, as well as advanced searching on title and the main text of the article.

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

All text data returned is UTF-8.

All dates are in UTC (GMT).

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
search false Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:
+ signifies AND operation
| signifies OR operation
- negates a single token
" wraps a number of tokens to signify a phrase for searching
* at the end of a term signifies a prefix query
( and ) signify precedence

To use one of these characters literally, escape it with a preceding backslash (\).

Example 1: forex + (usd | gbp) -cad (searches for forex articles which include usd or gbp but excludes cad)
Example 2: "Apple Inc" (searches for articles with exact matches for "Apple Inc")

For more advanced query examples, see our API Examples section.

When using special characters (+, -, |, ", *, ()) you MUST URL-encode this parameter.
search_fields false Comma separated list of fields to apply the search parameter to.
Supported fields: title | description | keywords | main_text
Example: title,description,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: 2025-07-16T02:31:50 | 2025-07-16T02:31 | 2025-07-16T02 | 2025-07-16 | 2025-07 | 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-07-16T02:31:50 | 2025-07-16T02:31 | 2025-07-16T02 | 2025-07-16 | 2025-07 | 2025
published_on false Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-07-16
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": 53044798,
        "returned": 10,
        "limit": 10,
        "page": 1
    },
    "data": [
        {
            "uuid": "e313c86c-81f0-4d37-99c7-8c8de35f8ffb",
            "title": "Trump Releases 2K Troops From LA",
            "description": "President Trump's administration is ending the deployment of 2,000 National Guard troops sent to Los Angeles to support immigration enforcement activities, chie...",
            "keywords": "Los Angeles protests, Los Angeles, California, National Guard",
            "snippet": "President Trump's administration is ending the deployment of 2,000 National Guard troops sent to Los Angeles to support immigration enforcement activities, chie...",
            "url": "https://www.newser.com/story/371935/2k-national-guard-troops-are-leaving-los-angeles.html",
            "image_url": "https://img1-azrcdn.newser.com/image/1622508-12-20250715210017.jpeg",
            "language": "en",
            "published_at": "2025-07-16T02:31:41.000000Z",
            "source": "newser.com",
            "categories": [
                "general",
                "politics"
            ],
            "relevance_score": null
        },
        {
            "uuid": "1bc7a470-a17d-4856-9609-de00527b62a6",
            "title": "Benjamin Netanyahu visits IDF Haredi brigade, praises soldiers' willingness to se",
            "description": "Netanyahu, Smotrich, and senior defense officials, met with soldiers and commanders at the training facility and received a briefing on the brigade's operations...",
            "keywords": "Benjamin Netanyahu, Haredi, IDF, Haredi draft, haredim, hasmonean, Bezalel Smotrich",
            "snippet": "Netanyahu, Smotrich visit IDF Haredi brigade, praises soldiers' willingness to serve Netanyahu, Smotrich, and senior defense officials, met with soldiers and co...",
            "url": "https://www.jpost.com/israel-news/article-861164",
            "image_url": "https://images.jpost.com/image/upload/f_auto,fl_lossy/q_auto/c_fill,g_faces:center,h_720,w_1280/672795",
            "language": "en",
            "published_at": "2025-07-16T02:31:08.000000Z",
            "source": "jpost.com",
            "categories": [
                "general"
            ],
            "relevance_score": null
        },
        {
            "uuid": "62e3c566-3acf-4e21-95f1-ae63f6f3a547",
            "title": "Drag X Drive Gets Exhibition Matches Weekend Of August 9 - News",
            "description": "",
            "keywords": "",
            "snippet": "Time to see if two mice can handle one basketball.\n\nDrag x Drive is offering a trial for Nintendo Switch Online members ahead of its launch.\n\nA \"Test Jam\" for t...",
            "url": "http://www.nintendoworldreport.com/news/71732/drag-x-drive-gets-exhibition-matches-weekend-of-august-9",
            "image_url": "http://www.nintendoworldreport.com/media/71732/4/1.jpg",
            "language": "en",
            "published_at": "2025-07-16T02:31:05.000000Z",
            "source": "nintendoworldreport.com",
            "categories": [
                "tech"
            ],
            "relevance_score": null
        },
        {
            "uuid": "0450236c-1765-4333-86d1-76d9d88166c0",
            "title": "솔라나 vs XRP, 누가 진짜 백만장자 코인이 될까?",
            "description": "XRP와솔라나  © 7월15일(현지시간)투자전문매체더모틀리풀에따르면,솔라나(Solana,SOL)와엑스알피(XRP)는각각뚜렷한성장동...",
            "keywords": "",
            "snippet": "",
            "url": "https://www.coinreaders.com/173132",
            "image_url": "https://www.coinreaders.com/imgdata/coinreaders_com/202505/800_533_2025052627261849.png",
            "language": "ko",
            "published_at": "2025-07-16T02:30:00.000000Z",
            "source": "coinreaders.com",
            "categories": [],
            "relevance_score": null
        },
        {
            "uuid": "9de1a1cc-cbe4-428c-8629-22a50c806b03",
            "title": "DAILY POST",
            "description": "",
            "keywords": "",
            "snippet": "",
            "url": "https://www.kenyan-post.com/feeds/8163190149433425457/comments/default",
            "image_url": "",
            "language": "en",
            "published_at": "2025-07-16T02:27:12.000000Z",
            "source": "kenyan-post.com",
            "categories": [
                "general",
                "entertainment"
            ],
            "relevance_score": null
        },
        {
            "uuid": "a7a72ae2-aad2-4644-b452-9f65ea38f11d",
            "title": "克宫:俄罗斯将认真研究特朗普的最后通牒",
            "description": "",
            "keywords": "",
            "snippet": "",
            "url": "https://baijiahao.baidu.com/s?id=1837764229540572444",
            "image_url": "https://www.baidu.com/favicon.ico?t=20171027",
            "language": "zh",
            "published_at": "2025-07-16T02:27:03.000000Z",
            "source": "news.baidu.com",
            "categories": [],
            "relevance_score": null
        },
        {
            "uuid": "c671d220-846e-400e-b480-b4ed4bd80762",
            "title": "A new strategic phase in the Israel-Iran confrontation after war",
            "description": "Israel and Iran stand on the threshold of a new phase in their strategic confrontation, and Israel must act with heightened intelligence alertness.",
            "keywords": "Iran, iran israel, War, nuclear power",
            "snippet": "Staying alert: A new strategic phase in the Israel-Iran confrontation - opinion Israel and Iran stand on the threshold of a new phase in their strategic confron...",
            "url": "https://www.jpost.com/opinion/article-861094",
            "image_url": "https://images.jpost.com/image/upload/f_auto,fl_lossy/q_auto/c_fill,g_faces:center,h_720,w_1280/672699",
            "language": "en",
            "published_at": "2025-07-16T02:26:48.000000Z",
            "source": "jpost.com",
            "categories": [
                "general"
            ],
            "relevance_score": null
        },
        {
            "uuid": "b27c648e-5d05-443d-927a-ae123be0447f",
            "title": "大学生の春・夏休みに!セブ島短期留学で得る5つのメリット - ネイティブキャンプ英会話ブログ",
            "description": "大学生に人気のセブ島短期留学は、春休みや夏休みを活用でき、費用も欧米より大幅に安いのがメリット!マンツーマ?...",
            "keywords": "オンライン英会話",
            "snippet": "近年、大学生を中心に短期の海外留学の需要が高まっています。\n\nその中で注目されているのがフィリピンのセブ島で?...",
            "url": "https://nativecamp.net/blog/20250716_study_abroad_5",
            "image_url": "https://cdn.image.st-hatena.com/image/scale/e503e82affc23bec59e3a207e833feb832ebd33a/backend=imagemagick;version=1;width=1300/https%3A%2F%2Fcdn-ak.f.st-hatena.com%2Fimages%2Ffotolife%2Fn%2Fnativecamp_official%2F20250714%2F20250714202617.jpg",
            "language": "ja",
            "published_at": "2025-07-16T02:26:42.000000Z",
            "source": "nativecamp.net",
            "categories": [],
            "relevance_score": null
        },
        {
            "uuid": "24c9ae82-211c-4438-b85d-6d324ee84031",
            "title": "シャルガオ島とは?サーフィンや観光アクティビティ、島内の移動手段などを徹底解説! - ネイティブキャンプ英会話ブログ",
            "description": "サーフィンの聖地・シャルガオ島は、フィリピン有数の観光スポット。上級者向けの「Cloud 9」や、美しいビーチ、スグ...",
            "keywords": "オンライン英会話",
            "snippet": "「シャルガオ島ってどんなところなんだろう?」\n\n「サーフィンが有名だけど、観光も楽しめるのかな?」\n\n「シャルガ...",
            "url": "https://nativecamp.net/blog/20250716_study_abroad__surfing",
            "image_url": "https://cdn.image.st-hatena.com/image/scale/182af9d539778c4ecb6e0f4202a1a430e567d802/backend=imagemagick;version=1;width=1300/https%3A%2F%2Fcdn-ak.f.st-hatena.com%2Fimages%2Ffotolife%2Fn%2Fnativecamp_official%2F20250714%2F20250714202655.jpg",
            "language": "ja",
            "published_at": "2025-07-16T02:26:42.000000Z",
            "source": "nativecamp.net",
            "categories": [],
            "relevance_score": null
        },
        {
            "uuid": "0b94c3ac-cb3c-4ef9-a1ca-30ed62bf3a97",
            "title": "大谷は2打席で交代",
            "description": "",
            "keywords": "",
            "snippet": "【アトランタ共同】米大リーグのオールスター戦で大谷は2打席で交代し2打数1安打だった。",
            "url": "https://news.jp/i/1318032359597817942",
            "image_url": "https://nordot-res.cloudinary.com/c_limit,w_200,h_200,f_auto,q_auto:eco/ch/units/39166665832988672/profile_7.png",
            "language": "ja",
            "published_at": "2025-07-16T02:26:41.000000Z",
            "source": "this.kiji.is",
            "categories": [
                "general",
                "business"
            ],
            "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-07-16T02:31:50 | 2025-07-16T02:31 | 2025-07-16T02 | 2025-07-16 | 2025-07 | 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-07-16T02:31:50 | 2025-07-16T02:31 | 2025-07-16T02 | 2025-07-16 | 2025-07 | 2025
published_on false Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2025-07-16
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-07-09
    

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