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": 377322,
    "articles": [
        {
            "id": "21ec5bad7b85129f88918e5cf2f587b2",
            "title": "Piers Morgan Hospitalized After Fall, Undergoes Hip Replacement",
            "description": "Piers Morgan is hospitalized after a painful fall, which landed him with a brand new hip.",
            "content": "Piers Morgan is hospitalized after a painful fall, which landed him with a brand new hip.\nThe broadcaster revealed Sunday he's recovering in a London hospital after tripping at a restaurant, suffering a serious femur fracture that required a hip repl... [681 chars]",
            "url": "https://www.tmz.com/2026/01/18/piers-morgan-hospitalized-after-fall/",
            "image": "https://imagez.tmz.com/image/c9/16by9/2026/01/18/c9d1153a71f44e3691958444ee0a3d84_xl.jpg",
            "publishedAt": "2026-01-18T16:00:05Z",
            "lang": "en",
            "source": {
                "id": "3539b82bbf6242ee8b4c1fbed4ea5ec7",
                "name": "TMZ",
                "url": "https://www.tmz.com"
            }
        },
        {
            "id": "3c32f0def6bf3892c15d8561c4dc7e82",
            "title": "A$AP Rocky and Rihanna Step Out After His 'SNL' Musical Guest Debut",
            "description": "A$AP Rocky and Rihanna wrapped up a huge night in true power couple fashion.",
            "content": "A$AP Rocky and Rihanna wrapped up a huge night in true power couple fashion.\nThe two were spotted making a stylish exit from the \"Saturday Night Live\" after party at Saks Fifth Avenue in New York City Saturday night, following Rocky's musical guest d... [640 chars]",
            "url": "https://www.tmz.com/2026/01/18/asap-rocky-rihanna-seen-after-snl-debut/",
            "image": "https://imagez.tmz.com/image/77/16by9/2026/01/18/77b8f2c13f6d4edbb2109041e222314c_xl.jpg",
            "publishedAt": "2026-01-18T14:48:24Z",
            "lang": "en",
            "source": {
                "id": "3539b82bbf6242ee8b4c1fbed4ea5ec7",
                "name": "TMZ",
                "url": "https://www.tmz.com"
            }
        },
        {
            "id": "daa442c11c1bbae5f7168e00554abef0",
            "title": "Sean McDermott, via unusual pool report, says interception ruling was incorrect",
            "description": "McDermott called Jay Skurski of the Buffalo News from team plane.",
            "content": "In his usual postgame press conference, Bills coach Sean McDermott expressed concern about the process used to uphold a critical overtime interception ruling that likely decided the playoff game between Buffalo and Denver. Then, something unusual hap... [4678 chars]",
            "url": "https://www.nbcsports.com/nfl/profootballtalk/rumor-mill/news/sean-mcdermott-via-unusual-pool-report-says-interception-ruling-was-incorrect",
            "image": "https://nbcsports.brightspotcdn.com/dims4/default/c7ca72c/2147483647/strip/true/crop/8640x4860+0+450/resize/1440x810!/quality/90/?url=https%3A%2F%2Fnbc-sports-production-nbc-sports.s3.us-east-1.amazonaws.com%2Fbrightspot%2F12%2Fce%2Fb1412ce54d4a9e4264a6be2c28e0%2Fhttps-delivery-gettyimages.com%2Fdownloads%2F2256235056",
            "publishedAt": "2026-01-18T14:45:18Z",
            "lang": "en",
            "source": {
                "id": "dc8f73f077072c35626eba314ee483bd",
                "name": "NBC Sports",
                "url": "https://www.nbcsports.com"
            }
        }
    ]
}

Categories