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": 411344,
    "articles": [
        {
            "id": "6a662a2f58d929f82fa4c577b5ee0e1b",
            "title": "Jaguars to play two London games in 2026, Commanders will play one",
            "description": "The Jaguars will be spending a little extra time in London during the 2026 season.",
            "content": "The Jaguars will be spending a little extra time in London during the 2026 season.\nThe team has made annual visits to the United Kingdom for more than a decade and the NFL announced on Wednesday they will be playing a pair of games on that side of th... [704 chars]",
            "url": "https://www.nbcsports.com/nfl/profootballtalk/rumor-mill/news/jaguars-to-play-two-london-games-in-2026-commanders-will-play-one",
            "image": "https://nbcsports.brightspotcdn.com/dims4/default/33767c2/2147483647/strip/true/crop/8076x4543+0+0/resize/1440x810!/quality/90/?url=https%3A%2F%2Fnbc-sports-production-nbc-sports.s3.us-east-1.amazonaws.com%2Fbrightspot%2Fae%2F65%2F537ba742433a97097676ae8b4333%2Fhttps-api-imagn.com%2Frest%2Fdownload%2FimageID%3D27368402",
            "publishedAt": "2026-02-25T14:21:57Z",
            "lang": "en",
            "source": {
                "id": "dc8f73f077072c35626eba314ee483bd",
                "name": "NBC Sports",
                "url": "https://www.nbcsports.com"
            }
        },
        {
            "id": "43976531330ef17fcad4c65b2dee776c",
            "title": "6 Takeaways From Trump’s State of the Union",
            "description": "In an address that was heavy on theatrics, President Trump lashed out at Democrats as “crazy” and unpatriotic.",
            "content": "President Trump delivered the longest State of the Union address in American history on Tuesday night, insisting that he had overseen a “turnaround for the ages” during his first year back in office, even as voters lose confidence in his handling of ... [1704 chars]",
            "url": "https://www.nytimes.com/2026/02/25/us/politics/trump-state-of-the-union-takeaways.html",
            "image": "https://static01.nyt.com/images/2026/02/24/multimedia/24dc-takeaways-top-qvkf/24dc-takeaways-top-qvkf-facebookJumbo-v2.jpg",
            "publishedAt": "2026-02-25T13:53:40Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "e32de4462932fa0384b1d2d048e5d0f9",
            "title": "Germany’s Leader Merz Delivers a Blunt Warning to China on Trade",
            "description": "Chancellor Friedrich Merz laid out his complaints in a frank message to his hosts on a trip to Beijing that China had designed to showcase their relationship.",
            "content": "Chancellor Friedrich Merz of Germany arrived in China on Wednesday with an outstretched hand and a list of complaints for his hosts, asking for closer diplomatic ties but also relief from economic policies that he said were impeding “fair competition... [1723 chars]",
            "url": "https://www.nytimes.com/2026/02/25/world/asia/china-germany-merz-visit-xi.html",
            "image": "https://static01.nyt.com/images/2026/02/25/multimedia/25int-china-germany-tbmj/25int-china-germany-tbmj-facebookJumbo.jpg",
            "publishedAt": "2026-02-25T13:14:45Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories