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": 567806,
    "articles": [
        {
            "id": "c2511aeb77afb53a269667cd8ca1979f",
            "title": "Stevie Nicks, Tim McGraw Reportedly Performing at Taylor Swift and Travis Kelce's Wedding",
            "description": "Taylor Swift and Travis Kelce's wedding celebration is shaping up to be a once-in-a-lifetime concert ... with some A-list guests reportedly scheduled to jump on the stage for some performances.",
            "content": "Taylor Swift and Travis Kelce's wedding celebration is shaping up to be a once-in-a-lifetime concert ... with some A-list guests reportedly scheduled to jump on the stage for some performances.\nTaylor's longtime pals Stevie Nicks and Tim McGraw are s... [1536 chars]",
            "url": "https://www.tmz.com/2026/06/27/stevie-nicks-tim-mcgraw-performing-at-taylor-travis-wedding/",
            "image": "https://imagez.tmz.com/image/38/16by9/2026/06/27/3817a1ab4a334b65a8f4bba8565315cd_xl.jpg",
            "publishedAt": "2026-06-27T18:41:46Z",
            "lang": "en",
            "source": {
                "id": "3539b82bbf6242ee8b4c1fbed4ea5ec7",
                "name": "TMZ",
                "url": "https://www.tmz.com"
            }
        },
        {
            "id": "fe0409d76037f295c850e7d4e0af49f4",
            "title": "Sweltering heat wave sets new records across Europe",
            "description": "A heat wave is hitting central and eastern Europe, with record temperatures in Switzerland, the Czech Republic and Denmark.",
            "content": "BERLIN (AP) — Temperatures soared to record highs from Switzerland to the Czech Republic and Denmark on Saturday, as a heat wave that baked western European countries this week moved to central and eastern parts of the continent.\nUnusually high tempe... [6035 chars]",
            "url": "https://apnews.com/article/europe-heat-germany-france-uk-69b2d990486f4b645c9ad6ea4252888c",
            "image": "https://dims.apnews.com/dims4/default/21b2049/2147483647/strip/true/crop/4287x2857+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F24%2Fe7%2F0293e41a52b687afd17899d30a8d%2Fe9c1ab27a45f4c66bdc7ac8f04fb24cd",
            "publishedAt": "2026-06-27T18:37:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "4040e04084ebc03dcccc7170224b8285",
            "title": "'Packed to the brim': Trump says 45K guests attend Great American State Fair rally",
            "description": "President Donald Trump touted what he described as a crowd of at least 45,000 people at the Great American State Fair rally in Washington, D.C.",
            "content": "President Donald Trump touted what he described as a crowd of at least 45,000 people at his Great American State Fair rally in Washington, D.C. earlier this week, while also urging supporters to attend a larger Fourth of July celebration that is slat... [1095 chars]",
            "url": "https://komonews.com/news/nation-world/packed-to-the-brim-trump-says-at-least-45k-guests-attended-great-american-state-fair-national-mall-independence-day-celebrations-patriotic-festivities-planes-military-flyovers-united-states-of-america-250-white-house-president-donald-trump",
            "image": "https://komonews.com/resources/media2/16x9/1241/1320/0x65/90/233219a1-63f8-4068-a719-36af1875edae-TRUMP_1.jpg",
            "publishedAt": "2026-06-27T17:05:49Z",
            "lang": "en",
            "source": {
                "id": "69d3ea701ca906abf5309b55e2cd036a",
                "name": "KOMO",
                "url": "https://komonews.com"
            }
        }
    ]
}

Categories