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-06-12
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": "297ef936-70b0-4e47-9954-72399fcb4f52",
                "title": "Tracy medical warehouse fire sends plumes of black smoke into air as gas tanks explode",
                "description": "On Thursday afternoon firefighters responded to a warehouse in Tracy, California, causing traffic on the Interstate 580 to back up.",
                "keywords": "Metro, US News, fires",
                "snippet": "See more of our coverage in your search results.\n\nA massive fire broke out at a medical warehouse in Tracy, Calif., on Thursday, leading to gas tank explosions ...",
                "url": "https://nypost.com/2026/06/11/us-news/crews-battle-medline-industries-warehouse-fire-in-tracy/",
                "image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/06/130626880.jpg?quality=75&strip=all&w=1200",
                "language": "en",
                "published_at": "2026-06-11T22:25:11.000000Z",
                "source": "nypost.com",
                "categories": [
                    "general"
                ],
                "locale": "us",
                "similar": [
                    {
                        "uuid": "43a61a21-c310-4206-9278-91fd54926514",
                        "title": "California city bans kids from leaving the house on summer nights after wild incidents",
                        "description": "Fresno has announced a nighttime curfew for kids and teens from 10:00 p.m. to 5:00 a.m. starting on June 11, as police officers conduct a “summer crime suppression operation.”",
                        "keywords": "Metro, US News, california, summer, teens",
                        "snippet": "See more of our coverage in your search results.\n\nA California town has announced a nighttime curfew for kids and teens in the Central Valley in an effort to pr...",
                        "url": "https://nypost.com/2026/06/11/us-news/california-city-enacts-summer-curfew-for-kids-after-string-of-crimes/",
                        "image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/06/130602981.jpg?quality=75&strip=all&w=1200",
                        "language": "en",
                        "published_at": "2026-06-11T22:25:37.000000Z",
                        "source": "nypost.com",
                        "categories": [
                            "general"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "0a6538e0-3218-4d68-befc-6bd9f8db644d",
                        "title": "Professors at top California college forced to radically alter coursework as students struggle to read",
                        "description": "UC Berkeley humanities professors are slashing reading assignments, replacing books with excerpts, as students struggle to keep up.",
                        "keywords": "Metro, US News, Berkeley, california",
                        "snippet": "See more of our coverage in your search results.\n\nHumanities professors at one of California’s most prestigious universities say they are assigning fewer page...",
                        "url": "https://nypost.com/2026/06/11/us-news/professors-at-top-california-college-forced-to-radically-alter-coursework-as-students-struggle-to-read/",
                        "image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/06/130638179.jpg?quality=75&strip=all&w=1200",
                        "language": "en",
                        "published_at": "2026-06-12T00:18:11.000000Z",
                        "source": "nypost.com",
                        "categories": [
                            "general"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "c8ac3edb-ba2d-4ca0-b9ab-c36e594c5ed9",
                        "title": "California 7-year-old left with half a skull after crash involving undocumented truck driver shares touching moment with Trump’s top brass",
                        "description": "Seven-year-old Dalilah Coleman and her parents met with DHS Secretary Markwayne Mullin to push for “Dalilah’s Law.”",
                        "keywords": "Metro, US News, california, car crashes, department of homeland security, illegal immigrants, Markwayne Mullin, trump",
                        "snippet": "See more of our coverage in your search results.\n\nNearly two years after an illegal immigrant almost took her life, California seven-year-old Dalilah Coleman an...",
                        "url": "https://nypost.com/2026/06/11/us-news/california-7-year-old-left-with-half-a-skull-after-crash-involving-undocumented-truck-driver-shares-touching-moment-with-trumps-top-brass/",
                        "image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/06/130631417.jpg?quality=75&strip=all&w=1200",
                        "language": "en",
                        "published_at": "2026-06-12T00:31:22.000000Z",
                        "source": "nypost.com",
                        "categories": [
                            "general"
                        ],
                        "locale": "us"
                    }
                ]
            },
            {
                "uuid": "8ed8f8f6-eec6-44ea-8d65-d7b4bf46d3fb",
                "title": "Taylor Swift Gets Emotional as She Thanks Family During Songwriters Hall of Fame Speech",
                "description": "Taylor Swift gave an emotional Songwriters Hall of Fame induction speech, thanking parents Scott and Andrea Swift and brother Austin for supporting her",
                "keywords": "",
                "snippet": "Taylor Swift is paying tribute to her family after being inducted into the Songwriters Hall of Fame.\n\nThe “I Knew You, I Knew It” singer, 36, was admitted i...",
                "url": "https://www.usmagazine.com/entertainment/news/taylor-swift-thanks-family-in-songwriters-hall-of-fame-speech/",
                "image_url": "https://www.usmagazine.com/wp-content/uploads/2026/06/GettyImages-2281136383-Taylor-Swift-Gets-Emotional-Thanking-Family-at-Songwriters-Hall-of-Fame.jpg?crop=344px%2C145px%2C1550px%2C814px&resize=1200%2C630&quality=86&strip=all",
                "language": "en",
                "published_at": "2026-06-12T07:55:42.000000Z",
                "source": "usmagazine.com",
                "categories": [
                    "entertainment",
                    "general"
                ],
                "locale": "us",
                "similar": [
                    {
                        "uuid": "4f15cff4-8aa5-4b65-b983-c22c4ddf2f7f",
                        "title": "Taylor Swift Blossoms Into the Songwriters Hall of Fame With Breathtaking Floral Dress",
                        "description": "Taylor Swift was officially inducted into the Songwriters Hall of Fame with a ceremony on Thursday, June 11",
                        "keywords": "",
                        "snippet": "Before making history at the 2026 Songwriters Hall of Fame induction ceremony as the youngest-ever honoree, Taylor Swift delivered another must-see fashion mome...",
                        "url": "https://www.usmagazine.com/entertainment/news/taylor-swift-inducted-into-songwriters-hall-of-fame/",
                        "image_url": "https://www.usmagazine.com/wp-content/uploads/2026/06/GettyImages-2281136394-Taylor-swift-red-carpet.jpg?crop=0px%2C74px%2C1200px%2C631px&resize=1200%2C630&quality=86&strip=all",
                        "language": "en",
                        "published_at": "2026-06-11T23:00:38.000000Z",
                        "source": "usmagazine.com",
                        "categories": [
                            "entertainment",
                            "general"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "5cfb1d74-8d66-4784-93d7-713800ab2125",
                        "title": "Taylor Swift Is in Full Bloom With Dramatic Slit Dress at Songwriters Hall of Fame Induction",
                        "description": "Taylor Swift stepped out at the Songwriters Hall of Fame Induction Ceremony in New York June 11, where she is set to be honored alongside Alanis Morrissette, Gene Simmons and more.",
                        "keywords": "",
                        "snippet": "Watch : Taylor Swift and Travis Kelce Enjoy Stylish NYC Date Night Amid Wedding Buzz\n\nGrab a pen and an old napkin—because you’re going to want to write dow...",
                        "url": "https://www.eonline.com/news/1432355/taylor-swift-on-songwriters-hall-of-fame-induction-ceremony-red-carpet?cmpid=rss-syndicate-genericrss-us-top_stories",
                        "image_url": "https://akns-images.eonline.com/eol_images/Entire_Site/20260611/906bb407-2a7f-4175-871d-81ea56bc8e39_1781218438.jpg?fit=around%7C1080:1080&output-quality=90&crop=1080:1080;center,top",
                        "language": "en",
                        "published_at": "2026-06-11T23:07:51.000000Z",
                        "source": "eonline.com",
                        "categories": [
                            "entertainment",
                            "general"
                        ],
                        "locale": "us"
                    },
                    {
                        "uuid": "2520d3f2-38a6-4afb-b3e2-9294f464f09f",
                        "title": "Travis Kelce Makes Surprise Appearance at Taylor Swift’s Hall of Fame Induction Alongside Their Parents",
                        "description": "Taylor Swift was supported by fiance Travis Kelce, her parents and future mother-in-law Donna Kelce for her induction into the Songwriters Hall of Fame",
                        "keywords": "",
                        "snippet": "Taylor Swift was supported by fiancé Travis Kelce, her parents, Andrea and Scott Swift, and future mother-in-law Donna Kelce on a very important night in her c...",
                        "url": "https://www.usmagazine.com/celebrity-news/news/taylor-swift-supported-by-travis-kelce-parents-at-hof-gala/",
                        "image_url": "https://www.usmagazine.com/wp-content/uploads/2026/06/Travis-Kelce-Makes-Surprise-Appearance-to-Support-Taylor-Swift-Alongside-Their-Parents-at-HOF-Gala-e1781225732643.jpg?crop=0px%2C0px%2C2000px%2C1051px&resize=1200%2C630&quality=86&strip=all",
                        "language": "en",
                        "published_at": "2026-06-12T01:14:43.000000Z",
                        "source": "usmagazine.com",
                        "categories": [
                            "entertainment",
                            "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-06-12T09:38:48 | 2026-06-12T09:38 | 2026-06-12T09 | 2026-06-12 | 2026-06 | 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-06-12T09:38:48 | 2026-06-12T09:38 | 2026-06-12T09 | 2026-06-12 | 2026-06 | 2026
published_on false Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-06-12
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": 1643287,
        "returned": 10,
        "limit": 10,
        "page": 1
    },
    "data": [
        {
            "uuid": "42412c25-917e-4fbb-9b78-c2e5da7da9aa",
            "title": "3 Best New Hulu Movies to Watch This Weekend (June 12-14): ‘A.I.,’ ‘National Treasure’ and More",
            "description": "The best new Hulu movies to watch this June weekend include a Steven Spielberg sci-fi classic, a Nicolas Cage action film and more",
            "keywords": "",
            "snippet": "It’s always an event when Steven Spielberg releases a new movie, and his latest, the sci-fi thriller Disclosure Day with Emily Blunt and Colman Domingo, is no...",
            "url": "https://www.usmagazine.com/entertainment/news/3-best-new-hulu-movies-to-watch-this-weekend-june-12-14-26/",
            "image_url": "https://www.usmagazine.com/wp-content/uploads/2026/06/national-treasure-2004.jpg?crop=0px%2C26px%2C1920px%2C1009px&resize=1200%2C630&quality=86&strip=all",
            "language": "en",
            "published_at": "2026-06-12T09:30:26.000000Z",
            "source": "usmagazine.com",
            "categories": [
                "entertainment",
                "general"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "84eba955-7c79-4e3e-b265-f1e6acc6513d",
            "title": "North Carolina HS valedictorian speaks out after heckling student shames his speech",
            "description": "A North Carolina high school valedictorian who was outed by a heckling senior after appearing to quote Ye in his graduation speech has told how the controversy ...",
            "keywords": "US News, graduation, north carolina",
            "snippet": "See more of our coverage in your search results.\n\nA North Carolina high school valedictorian who was shamed by a heckling senior after appearing to quote Ye in ...",
            "url": "https://nypost.com/2026/06/12/us-news/north-carolina-hs-valedictorian-speaks-out-on-speech-controversy-after-being-outed-by-heckling-student/",
            "image_url": "https://nypost.com/wp-content/uploads/sites/2/2026/06/130673676.jpg?quality=75&strip=all&w=1200",
            "language": "en",
            "published_at": "2026-06-12T09:23:09.000000Z",
            "source": "nypost.com",
            "categories": [
                "general"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "6c5fc4ec-a779-4f2b-a7ff-ca70db30770a",
            "title": "SpaceX's Gwynne Shotwell says IPO is one small step in 'very futuristic' journey",
            "description": "Gwynne Shotwell, long Elon Musk's second-in-command at SpaceX, spoke exclusively with CNBC ahead of her company's highly anticipated IPO.",
            "keywords": "Technology, Business, Social media, Breaking News: Technology, Elon Musk, Elon Musk, Jeff Bezos, Jeff Bezos, IPO, Autos, Space Exploration Technologies Corp, Gwynne Shotwell, Tesla Inc, Procure Space ETF, State Street SPDR S&P Kensho Final Frontiers ETF, Intel Corp, Alphabet Class A, EchoStar Corp, SPDR S&P Aerospace & Defense ETF, iShares U.S. Aerospace & Defense ETF, State Street Financial Select Sector SPDR ETF, Meta Platforms Inc, Broadcom Inc, Planet Labs PBC, Union Pacific Corp, business news",
            "snippet": "In this article SPCX Follow your favorite stocks CREATE FREE ACCOUNT\n\nwatch now\n\nSpaceX didn't just rewrite the playbook for aerospace and defense, it helped bi...",
            "url": "https://www.cnbc.com/2026/06/12/spacex-coo-gwynne-shotwell-spcx-ipo.html",
            "image_url": "https://image.cnbcfm.com/api/v1/image/108320427-1781196078851-SG_Shotwell_2.jpg?v=1781196230&w=1920&h=1080",
            "language": "en",
            "published_at": "2026-06-12T09:14:13.000000Z",
            "source": "cnbc.com",
            "categories": [
                "general",
                "business"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "b45690a1-07d1-4627-bb19-328c333294b4",
            "title": "Cupra Raval: a ‘surprisingly tactile little electric hot hatch’",
            "description": "The VZ has a ‘hefty punch of power’ making it a ‘blast to drive’.",
            "keywords": "",
            "snippet": "Cupra has carved a niche for itself as VW’s “fun, sporty brand”, but this could be “its ticket to the mainstream”, said Car Magazine.\n\nThe Raval is ba...",
            "url": "https://theweek.com/culture-life/cars/cupra-raval-a-surprisingly-tactile-little-electric-hot-hatch",
            "image_url": "https://cdn.mos.cms.futurecdn.net/tGEayofroMenfbhEtjjepD-2000-80.jpg",
            "language": "en",
            "published_at": "2026-06-12T09:01:12.000000Z",
            "source": "theweek.com",
            "categories": [
                "general",
                "politics"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "ede971c0-da32-489d-a6ef-d952ad9db170",
            "title": "LA politicians want to mandate prosperity. The $30 minimum wage proves they can’t",
            "description": "Los Angeles approved a $30 \"Olympic Wage\" for hotel and airport workers, but a business owner argues the mandate will drive investment out of California.",
            "keywords": "opinion, los angeles, economy, economic policy, jobs, leadership",
            "snippet": "NEW You can now listen to Fox News articles!\n\nIf you want to understand why businesses are leaving California, investors are looking elsewhere and common-sense ...",
            "url": "https://www.foxnews.com/opinion/la-politicians-want-mandate-prosperity-30-minimum-wage-proves-cant",
            "image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/06/los-angeles-workers-wage-clerk-coalition-drive.jpg",
            "language": "en",
            "published_at": "2026-06-12T09:00:51.000000Z",
            "source": "foxnews.com",
            "categories": [
                "general",
                "politics"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "5b1b22d7-bdb9-43d4-84dd-0b3a37886143",
            "title": "Don’t look now, but President Trump may have saved Ukraine. Just ask the Russians",
            "description": "Despite predictions Trump would hand Ukraine to Putin, his second-term approach has yielded progress as Ukraine claws back territory and NATO allies boost defen...",
            "keywords": "opinion, donald trump, ukraine, vladimir putin, volodymyr zelenskyy, alliances",
            "snippet": "NEW You can now listen to Fox News articles!\n\nDuring the 2024 presidential campaign, many Democrats — and quite a few Republicans — darkly predicted Preside...",
            "url": "https://www.foxnews.com/opinion/dont-look-president-trump-may-saved-ukraine-ask-russians",
            "image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/09/trump-tank.jpg",
            "language": "en",
            "published_at": "2026-06-12T09:00:50.000000Z",
            "source": "foxnews.com",
            "categories": [
                "general",
                "politics"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "68c54ee3-7b9b-4ccb-b144-477d7c873787",
            "title": "Putin’s road to ruin: Ukraine hits key Russian supply line with new drone campaign",
            "description": "A new Ukrainian campaign is turning Vladimir Putin’s main supply line into a road of ruin",
            "keywords": "",
            "snippet": "Russian-installed officials in southern Ukraine have said that Ukrainian drones are dropping mines onto the highway, trying to create “the illusion of a block...",
            "url": "https://www.nbcnews.com/world/ukraine/ukraine-russia-highway-drone-campaign-crimea-fuel-crisis-rcna349151",
            "image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-06/260610-crimea-rs-a25656.jpg",
            "language": "en",
            "published_at": "2026-06-12T09:00:27.000000Z",
            "source": "nbcnews.com",
            "categories": [
                "general",
                "politics"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "04239623-bf30-4203-a561-abdc6514a4f7",
            "title": "Schmitt goes in-depth on diving catch & changes to college athletics on ‘Ruthless’",
            "description": "Sen. Schmitt says Congress must grant antitrust exemption to fix college sports chaos and protect women's sports and Olympic sports from college football revenu...",
            "keywords": "ncaa fb, sports, congress, media",
            "snippet": "NEW You can now listen to Fox News articles!\n\nIn an exclusive interview with the Ruthless Podcast, Senator Eric Schmitt (R-Mo.) discussed his spectacular diving...",
            "url": "https://www.foxnews.com/media/schmitt-goes-in-depth-diving-catch-changes-college-athletics-ruthless",
            "image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2025/06/eric-schmitt2.jpg",
            "language": "en",
            "published_at": "2026-06-12T09:00:14.000000Z",
            "source": "foxnews.com",
            "categories": [
                "general",
                "politics"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "8a302ad8-7e74-40b7-b320-b89cee0052f9",
            "title": "Cuba’s dictatorship has long been a threat to America. Now, it’s finally teetering",
            "description": "A Cuban-born Congress member argues the Castro regime is more vulnerable than ever, citing U.S. indictments, economic collapse and Trump administration pressure...",
            "keywords": "opinion, marco rubio, cuba, venezuelan political crisis, xi jinping, china",
            "snippet": "NEW You can now listen to Fox News articles!\n\nFor 67 years, the Castro regime has survived by convincing the world that communism in Cuba is a permanent conditi...",
            "url": "https://www.foxnews.com/opinion/cubas-dictatorship-long-threat-america-finally-teetering",
            "image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/05/Jose-Machado-and-Raul-Castro.jpeg",
            "language": "en",
            "published_at": "2026-06-12T09:00:00.000000Z",
            "source": "foxnews.com",
            "categories": [
                "general",
                "politics"
            ],
            "relevance_score": null,
            "locale": "us"
        },
        {
            "uuid": "44e3a646-4ffe-4830-a2a3-c7131561b059",
            "title": "Visualizing a trillion in charts and graphics as Musk nears trillionaire status",
            "description": "Elon Musk, currently worth $696 billion, is poised to become the world’s first trillionaire when SpaceX goes public Friday. Here’s how to visualize that lev...",
            "keywords": "",
            "snippet": "While SpaceX may stand out against historical benchmarks, the rapid growth of AI rivals OpenAI and Anthropic, each with a valuation hovering around $900 billion...",
            "url": "https://www.nbcnews.com/data-graphics/visualizing-trillion-charts-graphics-musk-nears-trillionaire-status-rcna349018",
            "image_url": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-06/20260611-trillion-explaination-cover-2x1-jz-6c33dd.png",
            "language": "en",
            "published_at": "2026-06-12T09:00:00.000000Z",
            "source": "nbcnews.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-06-12T09:38:48 | 2026-06-12T09:38 | 2026-06-12T09 | 2026-06-12 | 2026-06 | 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-06-12T09:38:48 | 2026-06-12T09:38 | 2026-06-12T09 | 2026-06-12 | 2026-06 | 2026
published_on false Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-06-12
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": 54328422,
        "returned": 10,
        "limit": 10,
        "page": 1
    },
    "data": [
        {
            "uuid": "d94ba05f-e184-43e4-8b1b-f1bebdba444e",
            "title": "자리 잡은 청주페이 ‘기부미’ 식어가는 온정에 관심 절실",
            "description": "[충청투데이 송휘헌 기자] 충북 청주시와 청주복지재단이 복지 사각지대를 밝히기 위해 도입된 청주페이(청주사랑상품?...",
            "keywords": "행정안전부, 모금, 인센티브, 홈페이지, 재단, 서비스, 지난해, 대상자",
            "snippet": "청주페이[청주시 제공. 재판매 및 DB 금지]\n\n[충청투데이 송휘헌 기자] 충북 청주시와 청주복지재단이 복지 사각지대를 밝...",
            "url": "https://www.cctoday.co.kr/news/articleView.html?idxno=2231525",
            "image_url": "https://cdn.cctoday.co.kr/news/photo/202606/2231525_687431_4038.jpg",
            "language": "ko",
            "published_at": "2026-06-12T09:38:58.000000Z",
            "source": "cctoday.co.kr",
            "categories": [
                "general"
            ],
            "relevance_score": null
        },
        {
            "uuid": "9d9a784e-0af6-4a80-9ff8-e9507b12af61",
            "title": "함양소방서, 여름철 풍수해 대비 수방·수난구조장비 점검 - 신아일보",
            "description": "경남 함양소방서가 여름철 집중호우와 침수 사고에 대비해 수방·수난구조장비 점검을 실시하며 재난 대응 역량 강화에 ...",
            "keywords": "",
            "snippet": "경남 함양소방서가 여름철 집중호우와 침수 사고에 대비해 수방·수난구조장비 점검을 실시하며 재난 대응 역량 강화에 ...",
            "url": "https://www.shinailbo.co.kr/news/articleView.html?idxno=5029873",
            "image_url": "https://www.shinailbo.co.kr/image/logo/snslogotrans_20260213013714.png",
            "language": "ko",
            "published_at": "2026-06-12T09:38:52.000000Z",
            "source": "shinailbo.co.kr",
            "categories": [],
            "relevance_score": null
        },
        {
            "uuid": "cdab1c55-8930-464a-ae8e-fc1c04f12c3e",
            "title": "신한투자증권, 국민성장펀드 서민형 비중 35%로 확대해 전량 모집 완료",
            "description": "신한투자증권은 정부 정책형 금융상품인 '국민성장펀드' 모집에서 서민형 배정 비중을 대폭 확대하며 전량 모집을 완료?...",
            "keywords": "",
            "snippet": "출처 : 신한투자증권권\n\n(서울=연합인포맥스) 피혜림 기자 = 신한투자증권은 정부 정책형 금융상품인 '국민성장펀드' 모?...",
            "url": "https://news.einfomax.co.kr/news/articleView.html?idxno=4419657",
            "image_url": "https://cdn.news.einfomax.co.kr/news/thumbnail/202606/4419657_321824_382_v150.jpg",
            "language": "ko",
            "published_at": "2026-06-12T09:38:01.000000Z",
            "source": "news.einfomax.co.kr",
            "categories": [
                "general"
            ],
            "relevance_score": null
        },
        {
            "uuid": "428388e1-1323-4e4d-9e3b-434a4e806cca",
            "title": "El Banco Central Europeo sube en 25 puntos básicos los tipos de interés para contener la inflación",
            "description": "La inflación alcanzó en mayo el 3,2% en la zona euro",
            "keywords": "",
            "snippet": "Más de 1.000 personas salen a la calle en Cangas del Narcea para exigir mejoras en las carreteras del suroccidente",
            "url": "https://www.rtpa.es/noticias-economia/2026-06-12/El-Banco-Central-Europeo-sube-en-25-puntos-basicos-los-tipos-de-interes-para-contener-la-inflacion_111781248904.html",
            "image_url": "https://www.rtpa.es/fotos//26/06/20260612092102_RTPA8225398.webp",
            "language": "es",
            "published_at": "2026-06-12T09:38:00.000000Z",
            "source": "rtpa.es",
            "categories": [
                "general"
            ],
            "relevance_score": null
        },
        {
            "uuid": "1ec72029-fe7e-4274-a07f-f0f36ba5f6ff",
            "title": "강동구, 공동주택 관리 역량 강화 교육 실시…권역별 순회 운영 - 신아일보",
            "description": "서울 강동구가 공동주택 관리의 전문성과 투명성을 높이기 위해 관리주체를 대상으로 한 권역별 교육에 나선다.구는 오?...",
            "keywords": "",
            "snippet": "[사진=강동구]\n\n서울 강동구가 공동주택 관리의 전문성과 투명성을 높이기 위해 관리주체를 대상으로 한 권역별 교육에 ?...",
            "url": "https://www.shinailbo.co.kr/news/articleView.html?idxno=5029872",
            "image_url": "https://cdn.shinailbo.co.kr/news/photo/202606/5029872_2028474_3739.jpg",
            "language": "ko",
            "published_at": "2026-06-12T09:37:45.000000Z",
            "source": "shinailbo.co.kr",
            "categories": [],
            "relevance_score": null
        },
        {
            "uuid": "9b9eea10-ccb7-48af-92f6-84dc30b43cf6",
            "title": "스페이스X IPO 113조 조달…시총 7위권 직행 - 스페셜경제",
            "description": "스페셜경제=박숙자 기자 | 일론 머스크가 이끄는 우주·인공지능(AI) 기업 스페이스X가 기업공개(IPO) 공모가를 주당 135달?...",
            "keywords": "",
            "snippet": "사진은 2018년 2월 6일(현지시간) 미국 플로리다주 케이프커내버럴 케네디우주센터 39A 발사대에서 스페이스X의 팰컨 헤비 ...",
            "url": "https://www.speconomy.com/news/articleView.html?idxno=414843",
            "image_url": "https://cdn.speconomy.com/news/photo/202606/414843_411417_2114.jpg",
            "language": "ko",
            "published_at": "2026-06-12T09:36:47.000000Z",
            "source": "speconomy.com",
            "categories": [],
            "relevance_score": null
        },
        {
            "uuid": "72e440e5-b05e-4f7d-a94f-4348e75f1683",
            "title": "정선사회복지협의회-한전 정선지사 취약 국가보훈대상 물품 꾸러미 전달 - 강원도민일보",
            "description": "",
            "keywords": "",
            "snippet": "▲ 정선군사회복지협의회는 지난 11일 사회복지협의회 회의실에서 한전 정선지사와 함께 호국보훈의 달을 맞아 지역 내 ...",
            "url": "https://www.kado.net/news/articleView.html?idxno=2055418",
            "image_url": "https://cdn.kado.net/news/photo/202606/2055418_862210_3604.jpg",
            "language": "ko",
            "published_at": "2026-06-12T09:36:46.000000Z",
            "source": "kado.net",
            "categories": [],
            "relevance_score": null
        },
        {
            "uuid": "29b1f73d-9dc7-426d-a560-b361f320d7c6",
            "title": "은행권, ‘빚투’ 급증에 신용대출 조이기 돌입 - 강원도민일보",
            "description": "증시 호조에 따른 이른바 ‘빚투(빚내서 투자)’가 늘어나자 은행권이 신용대출 관리 강화에 나섰다.12일 금융권에 따르?...",
            "keywords": "",
            "snippet": "금융당국 가계부채 관리 강화\n\n▲ 서울의 한 시중은행. 연합뉴스\n\n증시 호조에 따른 이른바 ‘빚투(빚내서 투자)’가 늘?...",
            "url": "https://www.kado.net/news/articleView.html?idxno=2055417",
            "image_url": "https://cdn.kado.net/news/photo/202606/2055417_862209_2518.jpg",
            "language": "ko",
            "published_at": "2026-06-12T09:36:42.000000Z",
            "source": "kado.net",
            "categories": [],
            "relevance_score": null
        },
        {
            "uuid": "f2e01ae0-2ab0-4ccc-9c24-dfd8d1686aaf",
            "title": "iPhone 17系列首发近1年！方形前摄要普及了：国产TOP5全员跟进",
            "description": "iPhone 17系列首发近1年！方形前摄要普及了：国产TOP5全员跟进",
            "keywords": ", iPhone 17系列首发近1年！方形前摄要普及了：国产TOP5全员跟进, 快科技",
            "snippet": "iPhone 17系列首发近1年！方形前摄要普及了：国产TOP5全员跟进\n\n快科技6月12日消息，据博主数码闲聊站最新爆料，OPPO、华?...",
            "url": "https://news.mydrivers.com/1/1129/1129025.htm",
            "image_url": "https://img1.mydrivers.com/img/20260612/a3d57ba4fbf24bc8930e72cf3da9bb12.png",
            "language": "zh",
            "published_at": "2026-06-12T09:36:34.000000Z",
            "source": "news.mydrivers.com",
            "categories": [
                "tech",
                "general"
            ],
            "relevance_score": null
        },
        {
            "uuid": "2ae98f8d-59f0-4a05-84df-8a6df3075cf8",
            "title": "마포구, '희망두배 청년통장' 참여자 모집…3년 저축 시 최대 1080만 원 마련 - 신아일보",
            "description": "서울 마포구가 청년들의 안정적인 자산 형성과 미래 준비를 돕기 위해 ‘2026년 희망두배 청년통장’ 신규 참여자를 모집...",
            "keywords": "",
            "snippet": "[사진=마포구]\n\n서울 마포구가 청년들의 안정적인 자산 형성과 미래 준비를 돕기 위해 ‘2026년 희망두배 청년통장’ 신규...",
            "url": "https://www.shinailbo.co.kr/news/articleView.html?idxno=5029870",
            "image_url": "https://cdn.shinailbo.co.kr/news/photo/202606/5029870_2028472_363.jpg",
            "language": "ko",
            "published_at": "2026-06-12T09:36:20.000000Z",
            "source": "shinailbo.co.kr",
            "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-06-12T09:38:48 | 2026-06-12T09:38 | 2026-06-12T09 | 2026-06-12 | 2026-06 | 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-06-12T09:38:48 | 2026-06-12T09:38 | 2026-06-12T09 | 2026-06-12 | 2026-06 | 2026
published_on false Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2026-06-12
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-06-05

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