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": 358746,
    "articles": [
        {
            "id": "f43a3872a14b22b63fc234b566bdf347",
            "title": "QB Drake Maye leads Patriots past Giants, to NFL",
            "description": "QB Drake Maye turned in a masterful performance in a 33-15 beatdown of the visiting Giants on Monday night as the Patriots improved to an NFL-best 11-2 heading into their bye week.",
            "content": "FOXBOROUGH, Mass. -- Quarterback Drake Maye and the New England Patriots keep chugging along.\nMaye turned in a masterful performance in a 33-15 beatdown of the visiting New York Giants on Monday night, going 24-of-31 for 282 yards, with 2 touchdowns ... [2553 chars]",
            "url": "https://www.espn.com/nfl/story/_/id/47174252/qb-drake-maye-leads-patriots-giants-nfl-best-11-2-record",
            "image": "https://a3.espncdn.com/combiner/i?img=%2Fphoto%2F2025%2F1202%2Fr1583624_1296x729_16%2D9.jpg",
            "publishedAt": "2025-12-02T06:59:00Z",
            "lang": "en",
            "source": {
                "id": "0207e330d5d787ce8251900411dd488d",
                "name": "ESPN",
                "url": "https://www.espn.com"
            }
        },
        {
            "id": "d72d90db92fde90bd59b9714625d9345",
            "title": "NFL playoff picture after Week 13: Bears surge to top of NFC; Patriots in control of AFC",
            "description": "The race for the No. 1 seed in the NFC is tight, with four teams tied at nine wins. In the AFC, the Patriots and Broncos are pulling away.",
            "content": "Chicago might be The Second City, but its Bears are second to no one — not in the NFC, at least. After running through the defending Super Bowl champion Philadelphia Eagles on Friday, the Bears watched as the Los Angeles Rams dropped a stunner to the... [8421 chars]",
            "url": "https://www.nytimes.com/athletic/6840554/2025/12/01/nfl-playoff-picture-week-13-bears-colts-update/",
            "image": "https://static01.nyt.com/athletic/uploads/wp/2025/12/01233700/GettyImages-2249462726-scaled-e1764650235199.jpg?width=1200&height=630&fit=cover",
            "publishedAt": "2025-12-02T04:41:15Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "9261115364694281f4a944f33636763e",
            "title": "Cyber Monday 2025: Live updates from Amazon, Apple, Best Buy, Walmart",
            "description": "Get live updates on Cyber Monday sales as we near the closing bell. We found last-chance savings of $1,000 on Samsung TVs and record prices on AirPods.",
            "content": "Once upon a time, Americans lined up in droves outside Walmarts and Targets, still full from Thanksgiving dinner, so they could be first in the door at midnight. Thankfully, these frenzied Black Friday free-for-alls are a relic of a bygone era. Now, ... [25330 chars]",
            "url": "https://mashable.com/live/cyber-monday-live-2025-last-chance-deals",
            "image": "https://helios-i.mashable.com/imagery/live_blogs/04KizVdz7WymYWToZPTaNrU/desktop_banner_image.fill.size_1200x675.v1764627613.jpg",
            "publishedAt": "2025-12-02T04:30:04Z",
            "lang": "en",
            "source": {
                "id": "46629ea6ebf50ca97b330731a94e40b7",
                "name": "Mashable",
                "url": "https://mashable.com"
            }
        }
    ]
}

Categories