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": 578774,
    "articles": [
        {
            "id": "60917858204d9f34e7b22c7ebf1fa948",
            "title": "Australia confirms first case of bird flu as virus reaches every continent",
            "description": "Australia was previously the only continent where the H5N1 bird flu strain had not yet been found.",
            "content": "The H5N1 strain of bird flu has for the first time been found in Australia, the country's agriculture ministry confirmed. It means the highly contagious variant has now reached every continent.\nThe disease was found in a migratory seabird, a brown sk... [1858 chars]",
            "url": "https://www.bbc.com/news/articles/c4gykxklvl5o",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/4be1/live/ab172e90-6c51-11f1-9c25-e3d7dad7dcd5.jpg",
            "publishedAt": "2026-06-20T03:12:47Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "74f71869a107168111a16fa2cbf9498e",
            "title": "TV comedy directing legend James Burrows dies at 85",
            "description": "James Burrows, the director behind iconic TV comedies like “Cheers,” “Taxi,” “Friends” and “Will and Grace,” has died.",
            "content": "LOS ANGELES (AP) — James Burrows, who helped create volumes of laughter as director of more than a thousand episodes of such classic television comedies as “Cheers,” “Taxi,” “Friends” and “Will and Grace,” died Friday. He was 85.\nHis family confirmed... [6732 chars]",
            "url": "https://apnews.com/article/james-burrows-obituary-80b0422bd2268e2aa8fb4b47755eda31",
            "image": "https://dims.apnews.com/dims4/default/113e9fd/2147483647/strip/true/crop/5776x3849+27+0/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fd0%2F80%2F0d0b15d3897ed77a35c6d260d964%2Ff9eaf434639a44ea99e7c21a77f612ad",
            "publishedAt": "2026-06-20T02:45:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "0b63c6bcc4e4fa318cbce02b195e99e1",
            "title": "Brazil vs. Haiti LIVE: World Cup 2026 updates as Cunha brace, Vini Jr. have Ancelotti's side in control",
            "description": "Follow along for Live updates from Brazil's 2026 FIFA World Cup game against Haiti",
            "content": "Brazil take on Haiti in their second match of the 2026 FIFA World Cup, seeking their first win of the edition. You can follow all the action live right here on ESPN.\nMorocco have beaten Scotland in the early match of Group C to go top: can Brazil joi... [1697 chars]",
            "url": "https://www.espn.com/soccer/story/_/id/49119519/brazil-haiti-live-world-cup-2026-latest-updates-commentary-score-result",
            "image": "https://a1.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0620%2Fr1676418_1296x729_16%2D9.jpg",
            "publishedAt": "2026-06-20T01:20:00Z",
            "lang": "en",
            "source": {
                "id": "0207e330d5d787ce8251900411dd488d",
                "name": "ESPN",
                "url": "https://www.espn.com"
            }
        }
    ]
}

Categories