Flag of United States

United States News API

Get the live top headlines from United States with our JSON API.

Get API key for the United States News API

API Demonstration

This example demonstrates the HTTP request to make and the JSON response you will receive when you use the news api to get the top headlines from United States.

GET
https://gnews.io/api/v4/top-headlines?country=us&category=general&apikey=API_KEY
{
    "totalArticles": 397270,
    "articles": [
        {
            "id": "ddf8e9c4be91be49c79e245edb325ea5",
            "title": "Stefon Diggs: Unless Patriots opt out, I anticipate being here",
            "description": "Wide receiver Stefon Diggs's first season in New England ended short of a Super Bowl title, but the veteran plans on making another run with the Patriots.",
            "content": "Wide receiver Stefon Diggs’s first season in New England ended short of a Super Bowl title, but the veteran plans on making another run with the Patriots.\nDiggs signed a three-year contract as a free agent and returned from a 2024 torn ACL to post 85... [873 chars]",
            "url": "https://www.nbcsports.com/nfl/profootballtalk/rumor-mill/news/stefon-diggs-unless-patriots-opt-out-i-anticipate-being-here",
            "image": "https://nbcsports.brightspotcdn.com/dims4/default/2340a36/2147483647/strip/true/crop/6657x3745+0+0/resize/1440x810!/quality/90/?url=https%3A%2F%2Fnbc-sports-production-nbc-sports.s3.us-east-1.amazonaws.com%2Fbrightspot%2F31%2F6b%2F658c43d34deb8563760f438bc35f%2Fhttps-delivery-gettyimages.com%2Fdownloads%2F2260603558",
            "publishedAt": "2026-02-09T14:58:26Z",
            "lang": "en",
            "source": {
                "id": "dc8f73f077072c35626eba314ee483bd",
                "name": "NBC Sports",
                "url": "https://www.nbcsports.com"
            }
        },
        {
            "id": "feb47317827512a84ab53befee3ef416",
            "title": "Revealed: The new Defiler stomps onto the battlefield",
            "description": "Wield six legs of absolute devastation on the battlefield.",
            "content": "© Copyright Games Workshop Limited 2026. GW, Games Workshop, Citadel, White Dwarf, Space Marine, 40K, Warhammer, Warhammer 40,000, the ‘Aquila’ Double-headed Eagle logo, Warhammer Age of Sigmar, Battletome, Stormcast Eternals, and all associated logo... [1341 chars]",
            "url": "https://www.warhammer-community.com/en-gb/articles/8oknimbb/revealed-the-new-defiler-stomps-onto-the-battlefield/",
            "image": "https://assets.warhammer-community.com/1-feature-crdbmi7lma.jpg",
            "publishedAt": "2026-02-09T14:57:24Z",
            "lang": "en",
            "source": {
                "id": "ff0cce4a7da337a925c01deb06a20c2b",
                "name": "Warhammer Community",
                "url": "https://www.warhammer-community.com"
            }
        },
        {
            "id": "ab96a30d60c52801445c9f1715b1d441",
            "title": "Red Sox To Acquire Caleb Durbin",
            "description": "The Red Sox are acquiring infielder Caleb Durbin in a six-player trade with the Brewers. Read more at MLB Trade Rumors.",
            "content": "The Red Sox are acquiring infielder Caleb Durbin from the Brewers, reports Jeff Passan of ESPN. Milwaukee receives a three-player package including lefties Kyle Harrison and Shane Drohan as well as infielder David Hamilton, Passan adds. Boston is als... [6865 chars]",
            "url": "https://www.mlbtraderumors.com/2026/02/brewers-trade-caleb-durbin-red-sox.html",
            "image": "https://cdn.mlbtraderumors.com/files/2026/02/caleb-durbin-brewers-1024x683.jpg",
            "publishedAt": "2026-02-09T14:26:52Z",
            "lang": "en",
            "source": {
                "id": "95e9972ed9d1a75fccc1269425e6b80e",
                "name": "MLB Trade Rumors",
                "url": "https://www.mlbtraderumors.com"
            }
        }
    ]
}

Categories