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": 197538,
    "articles": [
        {
            "id": "85911773191be34139796f52a38293f5",
            "title": "France marks 10 years after Paris Bataclan terrorist attacks : NPR",
            "description": "In the 2015 attacks, 130 people were killed, including at the Bataclan concert hall. France is still wrestling with how to remember the deadliest attack on its soil in modern history and how to live with it.",
            "content": "PARIS — Arthur Dénouveaux's memories of Nov. 13, 2015, aren't exactly hazy. Nor are they perfect.\n\"What I remember from that night are a few very clear pictures,\" he says.\nDénouveaux was one of around 1,500 people inside the Bataclan concert hall to ... [5000 chars]",
            "url": "https://www.npr.org/2025/11/13/nx-s1-5604194/paris-france-bataclan-attacks-10-years-anniversary",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/8192x4608+0+428/resize/1400/quality/100/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2Fa4%2F1e%2F202a60db4a18990d9ce86a1a03c9%2Fgettyimages-2245810110.jpg",
            "publishedAt": "2025-11-13T19:33:42Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        },
        {
            "id": "1a44f55bdf77b6500870631bf3eb3739",
            "title": "Cómo Ucrania intentó capturar un avión ruso MiG-31K con el misil hipersónico Kinzhal y dirigirlo a una base de la OTAN",
            "description": "El FSB ruso aseguró que Kiev, con apoyo británico, intentó captar a pilotos para desviar un MiG-31K armado con el misil hipersónico Kinzhal hacia una base de la OTAN. Esto es lo que se sabe",
            "content": "El Servicio Federal de Seguridad (FSB) de Rusia afirmó haber frustrado un supuesto intento ucraniano de captar a pilotos para desviar un caza MiG-31K hacia una base de la OTAN en Rumania, una denuncia que da una idea de la dimensión de la guerra encu... [5041 chars]",
            "url": "https://elcomercio.pe/mundo/europa/ucrania-como-fue-la-operacion-para-capturar-un-avion-ruso-mig-31k-con-el-misil-kinzhal-y-dirigirlo-a-una-base-de-la-otan-en-rumania-rusia-reino-unido-noticia/",
            "image": "https://elcomercio.pe/resizer/v2/UMAY5XYQJ5F47HC3XB7K7AATGM.jpg?auth=1bda926785db0132774b5037d899c5972ee3a4692f3ad9bdc48ae52b5dfcd47b&width=980&height=528&quality=75&smart=true",
            "publishedAt": "2025-11-13T19:30:27Z",
            "lang": "es",
            "source": {
                "id": "108bcc2f42ee620efad6c803b79b7f95",
                "name": "El Comercio Perú",
                "url": "https://elcomercio.pe"
            }
        },
        {
            "id": "f393d9918c23ce987d64aed3e28473d9",
            "title": "El Ejército de Israel recibió el cuerpo de uno de los últimos rehenes asesinados por Hamas en Gaza",
            "description": "La oficina del primer ministro Benjamín Netanyahu informó que el traslado e identificación de los restos entregados por Hamas a la Cruz Roja se realizará en territorio israelí",
            "content": "Las autoridades israelíes confirmaron este jueves la recepción, a través del Comité Internacional de la Cruz Roja, del cuerpo de uno de los últimos cuatro rehenes asesinados por el grupo terrorista Hamas en Gaza.\nLa entrega se realizó en coordinación... [3467 chars]",
            "url": "https://www.infobae.com/america/mundo/2025/11/13/el-ejercito-de-israel-recibio-el-cuerpo-de-uno-de-los-ultimos-rehenes-asesinados-por-hamas-en-gaza/",
            "image": "https://www.infobae.com/resizer/v2/IMVGQOMSOBFUVILPVXN47R5NXE.JPG?auth=055e94aa2143d12baee74203c10c4517180591198cce6bbf0da3a4d2763b6471&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2025-11-13T19:28:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        }
    ]
}

Categories