Flag of United States

United States World News API

Get the live top world headlines from United States with our JSON API.

Get API key for the United States World 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=world&apikey=API_KEY
{
    "totalArticles": 246826,
    "articles": [
        {
            "id": "ff1f017f595f8d52a2a217ff0cbf3362",
            "title": "‘We will rave on Putin’s grave’: After 4 years of war, dancing has become resistance for some Ukrainians",
            "description": "Despite a harsh winter and the brutal conflict with Russia, Ukrainians are still going to raves. For many it’s a way to forget the war, even if just for one night.",
            "content": "Silhouettes move through dark alleys covered with snow and ice, towards the muffled beat coming from a concrete building in central Kyiv. Inside, a dim red light blurs the faces of a dancing crowd, their sweaty bodies pressed up against one another.\n... [8168 chars]",
            "url": "https://www.cnn.com/2026/03/08/europe/ukraine-rave-scene-war-russia-intl-cmd",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/2022-08-30t101719z-1526260803-rc285w9cuehq-rtrmadp-3-ukraine-crisis-kyiv-nightlife.JPG?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-03-08T05:01:33Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "eba3ba0862eee3bcd903b43879fa5a21",
            "title": "\"Estoy en contra tanto de la guerra como de la represión de la República Islámica\": cómo ven dos académicas iraníes el conflicto en su país",
            "description": "Tras los devastadores ataques de Israel y EE.UU. a Irán, conversamos con una activista de los derechos de las mujeres y una experta en historia moderna de Irán sobre lo que sucede en el país en el que nacieron y del que se fueron.",
            "content": "Autor,\nTítulo del autor, BBC News Mundo\n2 horas\nTiempo de lectura: 11 min\n\"Al gran y orgulloso pueblo de Irán, les digo esta noche que la hora de su libertad está cerca\", dijo el presidente de Estados Unidos, Donald Trump, el 28 de febrero, día en qu... [12989 chars]",
            "url": "https://www.bbc.com/mundo/articles/c9q5dgv200jo",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_mundo/b6d1/live/f3d535e0-195f-11f1-a1cd-a71e69f1cf89.png",
            "publishedAt": "2026-03-08T05:00:45Z",
            "lang": "es",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "dd553b3c0ca6af98ae261094a91a68c5",
            "title": "After initially voicing support, Trump says he doesn't want Kurds to enter Iran war",
            "description": "US president previously stated Kurdish invasion from Iraq would be 'wonderful,' but now says conflict 'complicated enough as it is'; believes Iran behind deadly strike on school",
            "content": "US President Donald Trump said Saturday he didn’t want Kurdish fighters from Iraq to join the war against Iran, after previously expressing support for the idea.\n“I don’t want the Kurds to go into Iran… They’re willing to go in, but I’ve told them I ... [3675 chars]",
            "url": "https://www.timesofisrael.com/after-initially-voicing-support-trump-says-he-doesnt-want-kurds-to-enter-iran-war/",
            "image": "https://static-cdn.toi-media.com/www/uploads/2026/03/AFP__20260307__A2DM9FP__v1__HighRes__UsPoliticsTrump.jpg",
            "publishedAt": "2026-03-08T04:06:55Z",
            "lang": "en",
            "source": {
                "id": "3dec3ce99690067fad56de075404dfee",
                "name": "The Times of Israel",
                "url": "https://www.timesofisrael.com"
            }
        }
    ]
}

Categories