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": 573050,
    "articles": [
        {
            "id": "9c7e0f58ad490770bb2e7e511f8aa329",
            "title": "US Open glory beckons for Wyndham Clark with six-shot lead going into final round",
            "description": "Wyndham Clark’s lead shrank, then grew, then all but swallowed the tournament whole",
            "content": "Wyndham Clark’s lead shrank, then grew, then all but swallowed the tournament whole. The 2023 US Open champion watched a four-shot advantage get cut in half on Saturday while still on the first hole, only to respond with a masterclass in survival gol... [5760 chars]",
            "url": "https://www.theguardian.com/sport/2026/jun/21/us-open-glory-beckons-for-wyndham-clark-with-six-shot-lead-going-into-final-round",
            "image": "https://i.guim.co.uk/img/media/786e7abd10f51bc7cb926e9711106afaeed84369/344_173_3007_2407/master/3007.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=0215e6f1b1911692dca06c04aa99503c",
            "publishedAt": "2026-06-21T03:08:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "4c2784acf492dbbc3622f3f7f075e287",
            "title": "Trump blames vandals for Reflecting Pool problems and says it may need to be drained again",
            "description": "WASHINGTON — President Donald Trump on Saturday said that multiple people had been arrested in connection with alleged vandalism of the Reflecting Pool on the National Mall, including an Olympic canoeist, as the administration’s $14 million project to renovate the site has faced multiple setbacks.",
            "content": "WASHINGTON — President Donald Trump on Saturday said that multiple people had been arrested in connection with alleged vandalism of the Reflecting Pool on the National Mall, including an Olympic canoeist, as the administration’s $14 million project t... [3117 chars]",
            "url": "https://www.nbcnews.com/politics/donald-trump/trump-blames-vandals-reflecting-pool-problems-says-may-be-drained-rcna351015",
            "image": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2026-06/260620-reflecting-pool-algae-cc-0938p-064918.jpg",
            "publishedAt": "2026-06-21T03:04:00Z",
            "lang": "en",
            "source": {
                "id": "3bab6463853c054dc51d2427c1a5b69e",
                "name": "NBC News",
                "url": "https://www.nbcnews.com"
            }
        },
        {
            "id": "2d089c5b2936c23fb6f9609206caa8ef",
            "title": "Schwarber conecta DOS jonrones en un inning... ¡y luego truena con un tercero!",
            "description": "FILADELFIA -- ¿Cuál es la mejor manera de superar un jonrón de 456 pies?\nConectar uno de 457 pies en el mismo inning.\nEso fue exactamente lo que hizo Kyle Schwarber en la victoria de los Filis por 15-3 sobre los Mets la noche del sábado en el Citizens Bank",
            "content": "Eso fue exactamente lo que hizo Kyle Schwarber en la victoria de los Filis por 15-3 sobre los Mets la noche del sábado en el Citizens Bank Park.\nY quizás aún más impresionante, Schwarber volvió a superarse en el séptimo episodio al disparar su tercer... [2456 chars]",
            "url": "https://www.mlb.com/es/news/schwarber-conecta-dos-jonrones-en-un-mismo-inning",
            "image": "https://img.mlbstatic.com/mlb-images/image/upload/t_2x1/t_w1536/mlb/u8utj4isychogdaie9m8.jpg",
            "publishedAt": "2026-06-21T02:40:05Z",
            "lang": "es",
            "source": {
                "id": "6aaa550e52f9c04eb9adec9f8430499b",
                "name": "MLB.com",
                "url": "https://www.mlb.com"
            }
        }
    ]
}

Categories