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": 223274,
    "articles": [
        {
            "id": "01b259e682246a86abcc572715479502",
            "title": "Tsunami warning lifted after 7.4-magnitude earthquake hits Indonesia",
            "description": "Locals are reckoning with the aftermath of the quake, which damaged buildings and caused at least one death.",
            "content": "In pictures: The aftermath of this morning's earthquake\nPictures from the ground give an idea of the damage caused by this morning's earthquake - showing damage to a sports complex and a hotel in Manado\nAs of now, the death toll still stands at one.\n... [4764 chars]",
            "url": "https://www.bbc.com/news/live/c8xy522nd5lt",
            "image": "https://ichef.bbci.co.uk/ace/branded_news/1200/cpsprodpb/14bf/live/623e4af0-2e35-11f1-a51c-f5c41fb3ee77.jpg",
            "publishedAt": "2026-04-02T00:06:45Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "1a5646ca434f45241d39c3afb2a75c9e",
            "title": "Magnitude 7.4 quake hits off Indonesia’s Ternate, tsunami warning triggered",
            "description": "The epicentre of the ⁠earthquake was about ⁠120km (75 miles) from Ternate, in Indonesia’s North Maluku ‌province.",
            "content": "A magnitude 7.4 earthquake has hit the ⁠Northern Molucca Sea off the coast of the city of ⁠Ternate, in eastern Indonesia, triggering a tsunami warning for nearby islands.\nThe United States Geological Survey (USGS) said Thursday’s quake, which was ini... [1316 chars]",
            "url": "https://www.aljazeera.com/news/2026/4/1/magnitude-7-4-quake-hits-off-indonesias-ternate-tsunami-warning-triggered",
            "image": "https://www.aljazeera.com/wp-content/uploads/2026/04/WEBMAP_MALUKU_TERNATE-1775087619.jpg?resize=1200%2C675",
            "publishedAt": "2026-04-01T23:54:52Z",
            "lang": "en",
            "source": {
                "id": "7530d90c9af769eda4cb548f32ed381d",
                "name": "Al Jazeera",
                "url": "https://www.aljazeera.com"
            }
        },
        {
            "id": "80e7f00b84caf126869ab723beef1b9b",
            "title": "Emiratos Árabes Unidos solicitó a la ONU autorizar el uso de la fuerza para reabrir el estrecho de Ormuz",
            "description": "La iniciativa busca apoyo diplomático internacional para que los países del Golfo puedan intervenir ante el bloqueo impuesto por el régimen de Irán y restaurar el tránsito marítimo",
            "content": "Emiratos Árabes Unidos solicitó al Consejo de Seguridad de Naciones Unidas que autorice acciones inmediatas, incluyendo la fuerza militar, para garantizar la reapertura del estrecho de Ormuz, ante el cierre impuesto por Irán que ha paralizado el trán... [3736 chars]",
            "url": "https://www.infobae.com/america/mundo/2026/04/01/emiratos-arabes-unidos-solicito-a-la-onu-autorizar-el-uso-de-la-fuerza-para-reabrir-el-estrecho-de-ormuz/",
            "image": "https://www.infobae.com/resizer/v2/GKUNPSP5XIIRJ6F5CN4L2QQ73Y.jpg?auth=aa72f8f5cd5ac5233ab686925b3477d8fa5a2e2f4d24b44005fae11ae3dab60b&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2026-04-01T23:26:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        }
    ]
}

Categories