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": 234326,
    "articles": [
        {
            "id": "67665ce78571a16b1708794e4abc678e",
            "title": "Falleció Carmen Navas, madre de Víctor Hugo Quero",
            "description": "Carmen Navas, madre de Víctor Quero, falleció este domingo 17 de mayo. La noticia fue confirmada por el periodista Rafael Hernández Marcano.",
            "content": "Carmen Navas, madre de Víctor Hugo Quero, falleció este domingo 17 de mayo. La noticia fue confirmada por el periodista Rafael Hernández Marcano. En un emotivo mensaje en sus redes sociales, rindió homenaje a la memoria de quien describió como una \"g... [4352 chars]",
            "url": "https://www.elnacional.com/2026/05/murio-carmen-navas-madre-de-victor-quero/",
            "image": "https://elnacional-uploads.nyc3.digitaloceanspaces.com/wp-content/uploads/2026/05/15164125/misa-150526-Ezvisual-19.jpg",
            "publishedAt": "2026-05-17T23:44:38Z",
            "lang": "es",
            "source": {
                "id": "22d1e067add8b55a3825ac5cfebbd088",
                "name": "El Nacional",
                "url": "https://www.elnacional.com"
            }
        },
        {
            "id": "045caceeb347695434774138454cb5d7",
            "title": "They Left America for a Job Abroad, Then Retired Happily in Thailand",
            "description": "The couple retired in Thailand and says the move has given them a quality of life they don't think they could replicate in the US.",
            "content": "When Kevin Elliott's job in Qatar ended, he and his wife, Camille, had to decide quickly where to retire.\nThe couple had spent nearly eight years in Doha after moving from South Carolina in 2018 for Kevin's job. Life in the Middle East took some gett... [5408 chars]",
            "url": "https://www.businessinsider.com/couple-left-america-moved-abroad-retired-in-huahin-thailand-affordable-2026-5",
            "image": "https://i.insider.com/69e5c8583fecbb42897a192f?width=1200&format=jpeg",
            "publishedAt": "2026-05-17T23:14:08Z",
            "lang": "en",
            "source": {
                "id": "3349d5cc8abff1623266825fbe6b0f68",
                "name": "Business Insider",
                "url": "https://www.businessinsider.com"
            }
        },
        {
            "id": "283f6016a1f07eb1e2d91f986f706023",
            "title": "Ukrainian drones hit Moscow and surrounding area, killing 3",
            "description": "The attack, the largest and most deadly to target the Russian capital region since the invasion of Ukraine in 2022, showed Kyiv’s increasing ability to carry out long-range strikes.",
            "content": "The attack, the largest and most deadly to target the Russian capital region since the invasion of Ukraine in 2022, showed Kyiv’s increasing ability to carry out long-range strikes.\nMay 17, 2026 at 4:46 p.m. EDTToday at 4:46 p.m. EDT\nThree people wer... [416 chars]",
            "url": "https://www.washingtonpost.com/world/2026/05/17/ukrainian-drones-hit-moscow-russias-capital-region-killing-three/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://cloudfront-us-east-1.images.arcpublishing.com/wapo/7Y346YOMAGGI56XE7BLJAFZ42Y.JPG&w=1440",
            "publishedAt": "2026-05-17T22:09:25Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        }
    ]
}

Categories