Flag of United States

United States News API

Get the live top headlines from United States with our JSON API.

Get API key for the United States 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=general&apikey=API_KEY
{
    "totalArticles": 489204,
    "articles": [
        {
            "id": "755e9765ee51d9894ed59a7674e83f59",
            "title": "'World According to Garp' Was 79",
            "description": "Mary Beth Hurt, who starred in films including 'The World According to Garp' and was married to director Paul Schrader, has died.",
            "content": "Mary Beth Hurt, who was nominated for three Tonys and appeared in films including “Interiors” and “The World According to Garp,” died on Sunday from Alzheimer’s. She was 79.\nHurt’s death was confirmed via a joint Facebook post from her daughter, Moll... [1822 chars]",
            "url": "https://variety.com/2026/film/news/mary-beth-hurt-dead-world-according-to-garp-1236702265/",
            "image": "https://variety.com/wp-content/uploads/2026/03/MixCollage-29-Mar-2026-11-19-AM-8900.jpg?crop=0px%2C16px%2C1200px%2C675px&resize=1000%2C563",
            "publishedAt": "2026-03-29T18:20:00Z",
            "lang": "en",
            "source": {
                "id": "c96d85bc8a846b5845a5420fe892ac16",
                "name": "Variety",
                "url": "https://variety.com"
            }
        },
        {
            "id": "6d449dd4e12c4efce167d869285546f9",
            "title": "Colombia vs. Francia: Así serán las alineaciones titulares en el amistoso",
            "description": "El equipo de Lorenzo perdió ante Croacia y ahora quiere dejar una buena impresión ante los de Deschamps.",
            "content": "El equipo de Didier Deschamps viene de vencer a Brasil por 2-1 con los goles de Mbappé y Ekitike, una dupla de gran actualidad en la temporada 2025-26. No fue el mejor partido de Francia, pero aún así le alcanzó con su calidad para someter a una Bras... [3249 chars]",
            "url": "https://espndeportes.espn.com/futbol/mundial/nota/_/id/16499124/colombia-vs-francia-asi-seran-alineaciones-titulares-partido-amistoso",
            "image": "https://a2.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0328%2Fr1635063_1296x729_16%2D9.jpg",
            "publishedAt": "2026-03-29T17:54:00Z",
            "lang": "es",
            "source": {
                "id": "504a41c45649f072da3d1e51d7eabf0b",
                "name": "ESPN Deportes",
                "url": "https://espndeportes.espn.com"
            }
        },
        {
            "id": "6af7c96b18aab355f9de0a0323ec86d5",
            "title": "The U.S. Now Has Over 50,000 Troops in the Middle East",
            "description": "The arrival of 2,500 Marines and another 2,500 sailors is keeping the number of American troops in the region at roughly 10,000 more than usual.",
            "content": "The arrival of 2,500 Marines and another 2,500 sailors is keeping the number of American troops in the Mideast region at over 50,000 — roughly 10,000 more than usual — as President Trump decides on his next step in his month-old war in Iran.\nWhile it... [2348 chars]",
            "url": "https://www.nytimes.com/2026/03/29/us/politics/us-marines-middle-east-iran-war.html",
            "image": "https://static01.nyt.com/images/2026/03/29/multimedia/29DC-troops-bpmv/29DC-troops-bpmv-facebookJumbo.jpg",
            "publishedAt": "2026-03-29T17:49:40Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories