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": 566578,
    "articles": [
        {
            "id": "19de320f165b3148cc8c5142f96425d8",
            "title": "Supergirl’s Rotten Tomatoes Audience Score Soars Higher Than Critics’",
            "description": "Supergirl is mostly a miss with critics, but Rotten Tomatoes audience scores for the film are quite a bit higher.",
            "content": "Supergirl has been battered around online for the past two days after critic reviews went live, and it settled at a 58% \"rotten\" Rotten Tomatoes score. That was well below not just its predecessor, Superman, but also other DCU projects from Peacemake... [2603 chars]",
            "url": "https://www.yahoo.com/entertainment/movies/articles/supergirl-rotten-tomatoes-audience-score-131143622.html",
            "image": "https://s.yimg.com/lo/mysterio/api/911d07371427c1dff2183a7e52a8f1a26032ee07db77341e260849defa430e07/lightyear_networkapi/resizefill_w959_h684;quality_80;format_webp/https:%2F%2Fmedia.zenfs.com%2Fen%2Fforbes_contributor_845%2Fa0ba5b727917b5bbc1b12a8841dcdc51",
            "publishedAt": "2026-06-26T13:11:43Z",
            "lang": "en",
            "source": {
                "id": "99e8a2cb4638bb798cf9167e5af5b83b",
                "name": "Yahoo",
                "url": "https://www.yahoo.com"
            }
        },
        {
            "id": "d5ed7c0a85e24a7b370131efbf117c38",
            "title": "Venezuela reels from earthquakes, as death toll more than doubles",
            "description": "As Venezuela begins counting the cost of its deadliest quake disaster in over a century, a shattered economy and struggling health system threaten to slow recovery efforts.",
            "content": "BOGOTA, Colombia — It took less than a minute for two powerful earthquakes to strike Venezuela on Wednesday evening. Two days later, firefighters, soldiers and volunteers are still digging through collapsed buildings in Caracas and surrounding areas.... [3916 chars]",
            "url": "https://www.npr.org/2026/06/26/nx-s1-5870651/venezuela-earthquakes-caracas",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/5472x3078+0+285/resize/1400/quality/85/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2Fc5%2Fbd%2Fcd87a75d449ea4ee31c1de8835f4%2Fap26176447773961.jpg",
            "publishedAt": "2026-06-26T13:00:59Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        },
        {
            "id": "381392d82c6d461a8ca2081fc561e8b9",
            "title": "Es probable que los problemas de corrupción en Venezuela hayan contribuido a la construcción deficiente de los edificios",
            "description": "Décadas de crisis económica y corrupción generalizada en Venezuela sugieren que muchos edificios probablemente han recibido un mantenimiento deficiente o fueron construidos al margen de las normativas oficiales, según Matthew Blackett, profesor asociado de Riesgos Naturales en la Universidad de Coventry, en el Reino Unido.",
            "content": "Décadas de crisis económica y corrupción generalizada en Venezuela sugieren que muchos edificios probablemente han recibido un mantenimiento deficiente o fueron construidos al margen de las normativas oficiales, según Matthew Blackett, profesor asoci... [2187 chars]",
            "url": "https://cnnespanol.cnn.com/2026/06/26/venezuela/corrupcion-venezuela-construccion-deficiente-edificios-trax",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/edificios-venezuela-corrupcion.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-06-26T12:36:00Z",
            "lang": "es",
            "source": {
                "id": "3c9d862fa32f79b035b88873a5d21ccb",
                "name": "CNN en Español",
                "url": "https://cnnespanol.cnn.com"
            }
        }
    ]
}

Categories