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": 250852,
    "articles": [
        {
            "id": "7a494c688fb74d89bd313f4d72111b5a",
            "title": "Iván Cepeda insiste en un acuerdo nacional e hizo un llamado a la oposición: “Invitación sincera”",
            "description": "El candidato presidencial del Pacto Histórico habló este sábado.",
            "content": "Este sábado 30 de mayo, a un día de las elecciones presidenciales, el candidato Iván Cepeda ofreció un breve discurso a través de redes sociales, en el que volvió a insistir en la importancia de un acuerdo nacional en el país.\nEn tal sentido, extendi... [2517 chars]",
            "url": "https://www.semana.com/politica/articulo/ivan-cepeda-insiste-en-un-acuerdo-nacional-e-hizo-un-llamado-a-la-oposicion-invitacion-sincera/202621/",
            "image": "https://www.semana.com/resizer/v2/P52XL7C7KJCGVJM44UNZTKEQNU.jpeg?auth=ecad70c9cff05d7ec4e8ff453026270e7d6dde4275cbdc5c6bae254376aae834&smart=true&quality=75&width=1280&height=720",
            "publishedAt": "2026-05-30T16:58:42Z",
            "lang": "es",
            "source": {
                "id": "9c364a5dd1f4ed8e5ff09e7f1d30dc3d",
                "name": "Revista Semana",
                "url": "https://www.semana.com"
            }
        },
        {
            "id": "0d6ee3e9be66d9377289e53ff78022b5",
            "title": "VIDEO: instalan una misión chavista en inmueble arrebatado a Leopoldo López",
            "description": "Autoridades chavistas instalaron entre bombos y platillos el pasado viernes una sede de la “Gran Misión Abuelas y Abuelos de la Patria” en el […]",
            "content": "Autoridades chavistas instalaron entre bombos y platillos el pasado viernes una sede de la “Gran Misión Abuelas y Abuelos de la Patria” en el inmueble arrebatado al líder opositor Leopoldo López en la novena transversal de Los Palos Grandes, municipi... [1058 chars]",
            "url": "https://lapatilla.com/2026/05/30/video-instalan-una-mision-chavista-en-inmueble-arrebatado-a-leopoldo-lopez/",
            "image": "https://sandia.datanubex.uk/wp-content/uploads/2026/05/Captura-de-pantalla-2026-05-30-122439.jpg",
            "publishedAt": "2026-05-30T16:15:17Z",
            "lang": "es",
            "source": {
                "id": "ae02a1b86c7054aeca3e3a08bf47100c",
                "name": "LaPatilla.com",
                "url": "https://lapatilla.com"
            }
        },
        {
            "id": "54da66ccc278de5758a1fd87131d281e",
            "title": "Ghana approves law criminalizing LGBTQ+ activities, advocacy",
            "description": "Ghana's Parliament passed one of the most repressive anti-LGBTQ+ laws in Africa. The law imposes prison terms on individuals who \"promote\" LGBTQ+ activities.",
            "content": "On Friday, Ghana's Parliament passed a bill imposing prison terms of up to 10 years for individuals who promote, sponsor or advocate LGBTQ+ acts and banning the funding of groups and activities.\nThe human sexual rights and family values bill is expec... [1786 chars]",
            "url": "https://www.dw.com/en/ghana-approves-law-criminalizing-lgbtq-activities-advocacy/a-77352654",
            "image": "https://static.dw.com/image/77352651_6.jpg",
            "publishedAt": "2026-05-30T15:48:31Z",
            "lang": "en",
            "source": {
                "id": "67e0c40c5e24b3fec372ab75763abad9",
                "name": "DW.com",
                "url": "https://www.dw.com"
            }
        }
    ]
}

Categories