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": 206514,
    "articles": [
        {
            "id": "53de79e3f8dc081fc961ecb98faac882",
            "title": "Deadly Israeli Strikes in Gaza, as Rafah Border Is Set to Reopen",
            "description": "A local health official said at least 26 people had been killed in the attacks, which the Israeli military said had targeted Hamas commanders. The opening of the border was seen as progress in the cease-fire.",
            "content": "The Israeli military launched a series of airstrikes on the Gaza Strip on Saturday, an attack that local health officials said was the deadliest in weeks and that comes as the cease-fire between Israel and Hamas was set to move into its next phase.\nZ... [1676 chars]",
            "url": "https://www.nytimes.com/2026/01/31/world/middleeast/israel-strikes-gaza-rafah-reopening.html",
            "image": "https://static01.nyt.com/images/2026/01/31/multimedia/31int-gaza-strikes-qvfh/31int-gaza-strikes-qvfh-facebookJumbo.jpg",
            "publishedAt": "2026-01-31T15:33:35Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "6233ac679d65054168e101f4be9d4194",
            "title": "Continúa la purga en el régimen chino: ahora está bajo investigación el ministro de Gestión de Emergencias",
            "description": "La investigación se enmarca en la campaña anticorrupción impulsada por el líder chino, Xi Jinping, desde su llegada al poder en 2012, una ofensiva que ha alcanzado a altos cargos del Partido, del Gobierno, del Ejército y de grandes empresas estatales",
            "content": "Las autoridades chinas abrieron este sábado una investigación disciplinaria y de supervisión contra el ministro de Gestión de Emergencias, Wang Xiangxi, por presuntas “graves violaciones de la disciplina y de la ley”, una fórmula habitual empleada po... [4950 chars]",
            "url": "https://www.infobae.com/america/mundo/2026/01/31/continua-la-purga-en-el-regimen-chino-ahora-esta-bajo-investigacion-el-ministro-de-gestion-de-emergencias/",
            "image": "https://www.infobae.com/resizer/v2/BAY3AL5LORFEFGLPYUI7HPNZDA.jpg?auth=f4daaf4516cef6a1610bf356f27cdb3191cacb6d3ccb2e92f44b8e42016d5ff1&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2026-01-31T15:07:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        },
        {
            "id": "edbdacade67679765a357675fb8e3d0b",
            "title": "Canada's Poilievre sweeps Conservative party leadership test with 87.4%",
            "description": "The opposition leader received a strong show of support from party delegates, despite the recent electoral loss against the Liberals.",
            "content": "Pierre Poilievre has cemented his position as Canada's Conservative Party leader, having received a strong endorsement from members despite presiding over recent electoral defeats.\nHe secured 87.4% of votes in the leadership review, held on Friday in... [3729 chars]",
            "url": "https://www.bbc.com/news/articles/c14r1023yy6o",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/11e9/live/10b8b0e0-fe55-11f0-a70e-b952f6bd3d91.jpg",
            "publishedAt": "2026-01-31T14:45:42Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Categories