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": 378720,
    "articles": [
        {
            "id": "8c168fe55883030680ef03598f38d124",
            "title": "How bad is flu in your state? What to know as new variant spreads",
            "description": "Flu season has taken off nationwide, with cases rising rapidly in some parts of the country over the past few weeks.“We’ve seen sustained, elevated activity across multiple key indicators in many areas of the country,” said Alicia Budd, head of the Centers for Disease Control and Prevention’s domestic influenza surveillance team.",
            "content": "Flu season has taken off nationwide, with cases rising rapidly in some parts of the country over the past few weeks.\n“We’ve seen sustained, elevated activity across multiple key indicators in many areas of the country,” said Alicia Budd, head of the ... [4826 chars]",
            "url": "https://www.nbcnews.com/health/health-news/flu-season-states-severity-new-variant-k-vaccines-kids-rcna250056",
            "image": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2025-12/251219-flu-shot-bf-1153-ec19d8.jpg",
            "publishedAt": "2025-12-19T22:42:35Z",
            "lang": "en",
            "source": {
                "id": "3bab6463853c054dc51d2427c1a5b69e",
                "name": "NBC News",
                "url": "https://www.nbcnews.com"
            }
        },
        {
            "id": "dd3f528b5f94d768f06ec4cf6add370c",
            "title": "EU ataca al Estado Islámico en Siria en represalia de soldados asesinados en emboscada",
            "description": "Dos militares estadunidenses y un intérprete civil fueron ultimados el sábado 13 de diciembre en un ataque perpetrado en Palmira por un miembro de las fuerzas de seguridad sirias.",
            "content": "Washington inició este viernes ataques aéreos contra el Estado Islámico en Siria en represalia por la muerte de dos soldados del ejército estadunidense durante una operación contra esa organización el pasado sábado, en territorio sirio.\nAviones de co... [1562 chars]",
            "url": "https://www.jornada.com.mx/noticia/2025/12/19/mundo/eu-lanza-ataques-aereos-en-siria-contra-el-estado-islamico",
            "image": "https://www.jornada.com.mx/ndjsimg/images/jornada/jornadaimg/eu-lanza-ataques-aereos-en-siria-contra-el-estado-islamico/eu-lanza-ataques-aereos-en-siria-contra-el-estado-islamico_34f2795d-bdeb-4460-aaae-abc25ca2b7e1_mediarawimage=true",
            "publishedAt": "2025-12-19T22:30:00Z",
            "lang": "es",
            "source": {
                "id": "44621fbfced07db503d19b3ae23aaa67",
                "name": "La Jornada",
                "url": "https://www.jornada.com.mx"
            }
        },
        {
            "id": "733a234f0f5b38c7202f14ba11601ed5",
            "title": "Análisis de The New York Times: Trump se basa en distorsiones para argumentar su campaña contra Venezuela",
            "description": "Un análisis publicado por el diario The New York Times destaca que el presidente de Estados Unidos, Donald Trump",
            "content": "Un análisis publicado por el diario The New York Times destacó que el presidente de Estados Unidos, Donald Trump, ha sustentado su campaña de presión contra Venezuela en interpretaciones distorsionadas de la situación legal y factual, en particular a... [1763 chars]",
            "url": "https://www.elnacional.com/2025/12/analisis-de-the-new-york-times-trump-se-basa-en-distorsiones-para-argumentar-su-campana-contra-venezuela/",
            "image": "https://elnacional-uploads.nyc3.digitaloceanspaces.com/wp-content/uploads/2025/12/10174741/AFP__20251210__87QQ7T3__v1__HighRes__UsPoliticsTrump-2560x1705.jpg",
            "publishedAt": "2025-12-19T22:29:03Z",
            "lang": "es",
            "source": {
                "id": "22d1e067add8b55a3825ac5cfebbd088",
                "name": "El Nacional",
                "url": "https://www.elnacional.com"
            }
        }
    ]
}

Categories