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": 207954,
    "articles": [
        {
            "id": "5cca6f7e7d5649090a3e2fcd78571471",
            "title": "Russia causes 'significant damage' to thermal plants in mass attack on Ukraine power grid",
            "description": "Attacks were reported across the country, including in western regions.",
            "content": "Russia carried out a mass attack on Ukraine's energy infrastructure on Feb. 7, triggering emergency power outages across most regions, Energy Minister Denys Shmyhal said.\nThe strike hit key elements of Ukraine's power grid as freezing temperatures re... [1776 chars]",
            "url": "https://kyivindependent.com/mass-attack-ukraine-emergency-power-outages/",
            "image": "https://assets.kyivindependent.com/content/images/2026/02/ebhfwjbfjh-2.jpg",
            "publishedAt": "2026-02-07T05:57:07Z",
            "lang": "en",
            "source": {
                "id": "77be3375c4c4b431f1d0e0a6ed40baa6",
                "name": "The Kyiv Independent",
                "url": "https://kyivindependent.com"
            }
        },
        {
            "id": "d17d4649ea1c603834e6a1cc618c9a92",
            "title": "Un paso en falso y todo podría salir mal: los buzos de Ucrania que despejan minas submarinas rusas",
            "description": "Un equipo de buzos especializados tiene la peligrosa y lenta tarea de desminar las zonas del mar Negro que todavía siguen bajo control de Ucrania.",
            "content": "Autor, Laura Gozzi\nTítulo del autor, BBC News,\nInforma desde, Odesa\n3 horas\nTiempo de lectura: 8 min\nEl mar Negro está plagado de armas mortales. Pero nadie sabe cuántas hay ni dónde están.\n\"Cuando nos acercamos a una, debemos guardar silencio, debem... [8189 chars]",
            "url": "https://www.bbc.com/mundo/articles/c70ld4y66ydo",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_mundo/abc4/live/d2d78be0-fdfd-11f0-a8b8-bdd2c5f9bcad.jpg",
            "publishedAt": "2026-02-07T04:09:06Z",
            "lang": "es",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "b96547b930714bbee01ef3e91331a12d",
            "title": "Footage shows Hamas commander killed in Gaza with alleged Israeli guidance",
            "description": "A hidden camera allegedly captured the behind-the-scenes of a Hamas commander’s killing two months ago; Al Jazeera reported that an Israeli officer, known as 'Abu Omar,' directed the gunmen, while the BBC said the Abu Shabab militia is operating checkpoints alongside the IDF",
            "content": "Qatar-based Al Jazeera aired unusual footage Friday night that it said came from a hidden camera and allegedly reveals the behind-the-scenes of the killing of Ahmed Zamzam, known as “Abu al-Majd,” a senior official in Hamas’ internal security apparat... [4630 chars]",
            "url": "https://www.ynetnews.com/article/hkenxevvwg",
            "image": "https://ynet-pic1.yit.co.il/picserver6/crop_images/2026/02/01/SkmDfchLZe/SkmDfchLZe_0_287_961_541_0_large.jpg",
            "publishedAt": "2026-02-07T03:43:13Z",
            "lang": "en",
            "source": {
                "id": "179cfeb8d2cd0b1b229ae6f2db87e23e",
                "name": "Ynetnews",
                "url": "https://www.ynetnews.com"
            }
        }
    ]
}

Categories