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": 497170,
    "articles": [
        {
            "id": "1a3bc6c0bc5c760c2a4f3d592320c42a",
            "title": "European allies say Russia is helping Iran more than the U.S. has acknowledged, sources say",
            "description": "The Europeans also argue that the war in Ukraine is intertwined with the war in Iran due to the cooperation between Russia and Iran.",
            "content": "European allies are publicly and privately telling American diplomats that Russia is directly and materially helping Iran's war efforts beyond what the U.S. will publicly acknowledge, sources tell CBS News.\nThe Europeans are also continuing to argue ... [4309 chars]",
            "url": "https://www.cbsnews.com/news/russia-iran-war-european-allies-intelligence-help/",
            "image": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/03/26/4f46ab04-0c90-4b66-87fc-2ca697347521/thumbnail/1200x630/bd7969d77236bad2d605f9bafb18ef39/gettyimages-2266357272.jpg",
            "publishedAt": "2026-03-28T19:34:00Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        },
        {
            "id": "fc35069f903d797aeda0b9bc748e76f6",
            "title": "USMNT v Belgium: international friendly - live updates",
            "description": "Join Alexander Abnos for live updates from Mercedes-Benz Stadium as the USMNT take on Belgium",
            "content": "Key events\nShow key events only\nPlease turn on JavaScript to use this feature\n35min: McKennie and Robinson combine for a nice little move down the left side, but it’s cut out well and shepherded over the line for a goal kick by Zeno Debast.\nShare\nFro... [6775 chars]",
            "url": "https://www.theguardian.com/football/live/2026/mar/28/usmnt-belgium-live-lineups-analysis-friendly",
            "image": "https://i.guim.co.uk/img/media/b6643a21b032a43fa02c3badda5e6cdaee07f495/150_0_4615_3692/master/4615.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctbGl2ZS5wbmc&enable=upscale&s=68ebb5d9597e280deff556c2cf1581b7",
            "publishedAt": "2026-03-28T19:26:55Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "004e931f46130a14a55d1510ad6318a4",
            "title": "Ukraine Finalizes Air Defense Deals With Gulf Nations Amid War in Mideast",
            "description": "The Ukrainian president visited the Middle East, where he sought to shift his country from a recipient of military aid to a supplier.",
            "content": "President Volodymyr Zelensky of Ukraine hailed his Middle East tour to promote anti-drone technologies as a success, saying on Saturday that he had negotiated air defense agreements with Saudi Arabia, Qatar and the United Arab Emirates.\nIn the Mideas... [1643 chars]",
            "url": "https://www.nytimes.com/2026/03/28/world/europe/ukraine-air-defense-deal-qatar-saudi-arabia.html",
            "image": "https://static01.nyt.com/images/2026/03/28/multimedia/28int-ukraine-zelensky-jvbw/28int-ukraine-zelensky-jvbw-facebookJumbo.jpg",
            "publishedAt": "2026-03-28T18:45:46Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories