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": 247200,
    "articles": [
        {
            "id": "bc19c980a870345f11f3465bab91e565",
            "title": "Imágenes satelitales detectan y luego pierden el rastro de una misteriosa estructura en el mar de China Meridional",
            "description": "El episodio coincide con la primera patrulla conjunta de los guardacostas de EEUU y Filipinas en el atolón y con el plan chino de declararlo reserva natural nacional",
            "content": "Un objeto de origen desconocido apareció y desapareció en el El Bajo de Masinloc,​ también conocido como el Atolón de Scarborough, entre el 27 de mayo y el 1 de junio, según imágenes satelitales publicadas por Reuters. El hallazgo ocurrió en los mism... [4035 chars]",
            "url": "https://www.infobae.com/america/mundo/2026/06/05/imagenes-satelitales-detectan-y-luego-pierden-el-rastro-de-una-misteriosa-estructura-en-el-mar-de-china-meridional/",
            "image": "https://www.infobae.com/resizer/v2/XZEJMHZD65EIPNKTZXSRXOKFNM.png?auth=369ad9ed251d894e618d4ac44b32e6efb182aee000e056e39fca4db525b422de&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2026-06-05T00:23:41Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        },
        {
            "id": "1ddaf6417e898495fbd13d4095fdc207",
            "title": "La primera guerra convencional que Estados Unidos podría no ganar desde Corea",
            "description": "Si la guerra en Oriente Próximo terminara como está la situación ahora mismo, éste sería el conflicto convencional en el que peor le ha ido a Estados Unidos desde que ese...",
            "content": "Si la guerra en Oriente Próximo terminara como está la situación ahora mismo, éste sería el conflicto convencional en el que peor le ha ido a Estados Unidos desde que ese país existe.\nIrán habría logrado todos sus objetivos. E Israel y Estados Unidos... [6083 chars]",
            "url": "https://www.elmundo.es/internacional/2026/06/05/6a219c53e4d4d82f5a8b45d1.html",
            "image": "https://e01-phantom-elmundo.uecdn.es/238423222a5c09dce36e329930c84681/resize/1200/f/webp/assets/multimedia/imagenes/2026/06/04/17805893151509.jpg",
            "publishedAt": "2026-06-04T22:20:00Z",
            "lang": "es",
            "source": {
                "id": "b0ce8104ba9d892b3581af2e111e61b6",
                "name": "El Mundo",
                "url": "https://www.elmundo.es"
            }
        },
        {
            "id": "bf4823534cacb95321fe0918f98e7a93",
            "title": "wife of Dubai ruler's nephew in custody, prosecutors say",
            "description": "Zeynab Javadli had not been in contact with any of her friends since Tuesday.",
            "content": "For months, she had barely left the house as she believed security officers were waiting to take her children from her and put her under arrest.\nJavadli - a former international gymnast - has also been facing potential arrest for e-crimes - online of... [766 chars]",
            "url": "https://www.bbc.com/news/articles/cx2124zylxno",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/5fa4/live/71ba3610-605d-11f1-b682-cf91850925ea.jpg",
            "publishedAt": "2026-06-04T21:34:49Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Categories