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": 554588,
    "articles": [
        {
            "id": "ace3da85ba8f04928cd4ed1217a8fc6a",
            "title": "Paxton is the Republican nominee for Senate in Texas, beating Cornyn : NPR",
            "description": "Controversial Texas Attorney General Ken Paxton challenged Sen. John Cornyn's reelection and won President Trump's endorsement in the bitter primary fight that cost Republicans more than $100 million.",
            "content": "Texas Republicans nominated scandal-plagued state Attorney General Ken Paxton in their U.S. Senate primary following an endorsement from President Trump, according to a race call by the Associated Press. This effectively unseats Sen. John Cornyn, a p... [3938 chars]",
            "url": "https://www.npr.org/2026/05/26/nx-s1-5835745/paxton-republican-texas-senate-nominee-trump-cornyn-talarico",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/6048x3402+0+311/resize/1400/quality/85/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F55%2F30%2F336141e84a8ea36d417af72dc3da%2Fgettyimages-2264116767.jpg",
            "publishedAt": "2026-05-27T01:03:35Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        },
        {
            "id": "9634f1664ad817e73e35f95d98644f83",
            "title": "Menefee beats Green in Houston congressional district",
            "description": "Green’s loss means the Texas House delegation is losing one of its most senior members, who served more than 20 years in Congress.",
            "content": "Democratic U.S. Rep. Christian Menefee defeated U.S. Rep. Al Green to represent a newly drawn congressional district that encompasses both of their current Houston-area districts, effectively ending the tenure of one of the state’s longest-serving co... [2708 chars]",
            "url": "https://www.texastribune.org/2026/05/26/texas-18th-congressional-district-democratic-runoff-al-green-christian-menefee/",
            "image": "https://i0.wp.com/www.texastribune.org/wp-content/uploads/2026/05/menefee-Social-lead.jpg?quality=100&w=1200&h=630&ssl=1",
            "publishedAt": "2026-05-27T00:37:20Z",
            "lang": "en",
            "source": {
                "id": "027fe3325cb324bae2b5ec820424e92d",
                "name": "The Texas Tribune",
                "url": "https://www.texastribune.org"
            }
        },
        {
            "id": "0ca8a85bfb3136e62c29efa925cd7764",
            "title": "Todos los grupos",
            "description": "Este martes 26 de mayo se realizó el sorteo de la Copa Centroamericana 2026.",
            "content": "Sin duda, el duelo que roba miradas desde la fase de grupos es el choque entre Olimpia y Saprissa en el Grupo C. Se trata de dos gigantes de Centroamérica, multicampeones en sus países y acostumbrados a protagonizar noches internacionales.\nEl “León” ... [2118 chars]",
            "url": "https://www.diez.hn/centroamerica/olimpia-ante-saprissa-motagua-con-municipal-diego-vazquez-frente-a-marathon-BJ30824410",
            "image": "https://www.diez.hn/binrepository/1201x901/0c92/1200d630/none/3014757/RSOL/copa-centroamericana-2_14520542_20260526185458.jpg",
            "publishedAt": "2026-05-27T00:32:00Z",
            "lang": "es",
            "source": {
                "id": "62687b88e66412a58e4dbdec538ec187",
                "name": "DIEZ.HN",
                "url": "https://www.diez.hn"
            }
        }
    ]
}

Categories