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": 485222,
    "articles": [
        {
            "id": "0d7fbb62220ffc84133a7ef6fe97814b",
            "title": "Senate unanimously moves to fund most of DHS, except ICE and border patrol, in rare overnight session",
            "description": "The Senate unanimously moved to fund most of the Department of Homeland Security, except for Immigration and Customs Enforcement and part of Customs and Border Protection, in a rare overnight session.",
            "content": "The Senate unanimously moved to fund most of the Department of Homeland Security, except for Immigration and Customs Enforcement and part of Customs and Border Protection, in a rare overnight session.\nThe agreement would fund other DHS components, su... [4074 chars]",
            "url": "https://www.cnn.com/2026/03/27/politics/senate-agreement-dhs-funding",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/2026-03-26t193324z-1974285159-rc2ickauiq9d-rtrmadp-3-usa-congress.JPG?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-03-27T06:44:01Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "7b5826ed7733fe7fb9a78abee291e6ec",
            "title": "March Madness Sweet Sixteen, Day 1",
            "description": "Catch the best highlights, news and observations from the Sweet Sixteen of the NCAA Basketball Tournament with the NBA.com live blog.",
            "content": "What we know about Thursday’s Sweet Sixteen games:\nWe opened with a pair of close contests, as Trey Kaufman-Renn (20 pts, 8 reb) tipped in the game-winner to help Purdue defeat Texas 79-77, while Iowa took control late to dispatch Nebraska 77-71.\nIn ... [7187 chars]",
            "url": "https://www.nba.com/news/live-updates-march-madness-sweet-16-purdue-vs-texas-opens-the-night",
            "image": "https://cdn.nba.com/manage/2026/03/GettyImages-2268537738-2-Cropped-scaled.jpg",
            "publishedAt": "2026-03-27T05:15:00Z",
            "lang": "en",
            "source": {
                "id": "51615c5a3110b6568c3cd6f1dae8903b",
                "name": "NBA",
                "url": "https://www.nba.com"
            }
        },
        {
            "id": "993371cba02202877931a2449e271ccd",
            "title": "Taylor Swift, Travis Kelce Make Awards Show Debut at iHeartRadio Music",
            "description": "Taylor Swift and Travis Kelce made their awards show debut at the 2026 iHeartRadio Music Awards.",
            "content": "Taylor Swift and Travis Kelce have made their official awards show debut as a couple at the 2026 iHeartRadio Music Awards.\nThe Grammy winner and NFL star were both in attendance at Thursday night’s show, which was held at Los Angeles’ Dolby Theatre. ... [2782 chars]",
            "url": "https://www.hollywoodreporter.com/music/music-news/taylor-swift-travis-kelce-iheartradio-music-awards-1236548546/",
            "image": "https://www.hollywoodreporter.com/wp-content/uploads/2026/03/GettyImages-2268528340-e1774570738771.jpg?w=1440&h=810&crop=1",
            "publishedAt": "2026-03-27T03:54:22Z",
            "lang": "en",
            "source": {
                "id": "58f309465dc77c95e88cbb1d72f55e72",
                "name": "The Hollywood Reporter",
                "url": "https://www.hollywoodreporter.com"
            }
        }
    ]
}

Categories