Flag of United States

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": 477218,
    "articles": [
        {
            "id": "8d519384ad30ae85bd1efefec8d9839b",
            "title": "Swae Lee's Coachella's Set Reportedly Cut Off Before 'Black Beatles'",
            "description": "Sorry to Swae Lee fans ... they missed out on his hit \"Black Beatles\" when his Coachella set on Friday night was seemingly cut off!",
            "content": "Coachella Valley Music and Arts Festival\nSorry to Swae Lee fans ... they missed out on his hit \"Black Beatles\" when his Coachella set on Friday night was seemingly cut off!\nThe rapper took the Sahara Stage at Night 1 of Coachella -- which many adorin... [1308 chars]",
            "url": "https://www.tmz.com/2026/04/11/swae-lee-coachella-performance-cut-short/",
            "image": "https://imagez.tmz.com/image/d3/16by9/2026/04/11/d302ae7de23a42a8909468388edc5793_xl.png",
            "publishedAt": "2026-04-11T13:13:21Z",
            "lang": "en",
            "source": {
                "id": "3539b82bbf6242ee8b4c1fbed4ea5ec7",
                "name": "TMZ",
                "url": "https://www.tmz.com"
            }
        },
        {
            "id": "54c7ac68ee55ec98da25308107dbdc78",
            "title": "Una rotonda de US$ 1,5 millones que no lleva a ninguna parte: apenas una muestra de la economía de Orbán",
            "description": "Un cartel anuncia con orgullo que la rotonda cerca de Zalaegerszeg, en el oeste de Hungría, se construyó con 500 millones de florines (unos US$ 1,5 millones) de fondos de la Unión Europea (UE).",
            "content": "Un cartel anuncia con orgullo que la rotonda cerca de Zalaegerszeg, en el oeste de Hungría, se construyó con 500 millones de florines (unos US$ 1,5 millones) de fondos de la Unión Europea (UE).\nLa rotonda se construyó para dar servicio a una terminal... [8233 chars]",
            "url": "https://cnnespanol.cnn.com/2026/04/11/mundo/orban-hungria-elecciones-corrupcion-trax",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/rotonda-orban.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-04-11T12:15:00Z",
            "lang": "es",
            "source": {
                "id": "3c9d862fa32f79b035b88873a5d21ccb",
                "name": "CNN en Español",
                "url": "https://cnnespanol.cnn.com"
            }
        },
        {
            "id": "b9008c900e0a2b7874fd3f5706372ca0",
            "title": "Vance meets Pakistan’s prime minister ahead of US-Iran talks",
            "description": "US Vice President JD Vance met with Pakistan’s prime minister in Islamabad ahead of high-stakes negotiations with Iran. Follow for live updates.",
            "content": "Several ships have passed through the Strait of Hormuz as peace talks between Iran and the United States are set to get underway in Islamabad, according to ship tracking data.\nA handful vessels - mostly Chinese tankers or bulk carriers - transited th... [12263 chars]",
            "url": "https://www.cnn.com/2026/04/11/world/live-news/iran-us-war-talks",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/2026-04-11t105225z-1579164395-rc2ymkaq98oi-rtrmadp-3-iran-crisis-sharif-vance.JPG?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-04-11T11:30:00Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        }
    ]
}

Categories