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": 477818,
    "articles": [
        {
            "id": "482c6d8afee5b1595b32568e4979e8e7",
            "title": "Men's March Madness live tracker: Updates from all of Sunday's games",
            "description": "ESPN reporters are on-site, from Philadelphia to San Diego, tracking all the second-round action.",
            "content": "The first half of the Sweet 16 is set, with 16 teams playing for one of the final eight tickets to the second weekend of the 2026 men's NCAA tournament as the second round continues Sunday.\nESPN reporters are on-site across the country, from Philadel... [10310 chars]",
            "url": "https://www.espn.com/mens-college-basketball/story/_/id/48275055/mens-march-madness-live-updates-analysis-ncaa-tournament-second-round-saturday-2026",
            "image": "https://a3.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0322%2Fr1632310_1296x729_16%2D9.jpg",
            "publishedAt": "2026-03-22T19:45:00Z",
            "lang": "en",
            "source": {
                "id": "0207e330d5d787ce8251900411dd488d",
                "name": "ESPN",
                "url": "https://www.espn.com"
            }
        },
        {
            "id": "fb68d543a19f175471eb21903c5aa4d9",
            "title": "NYCFC - Inter Miami en vivo: MLS 2026, en directo",
            "description": "Sigue la previa y el minuto a minuto de NYCFC vs Inter Miami, partido de la temporada de la MLS que se jugará este domingo desde la ciudad de Nueva York.",
            "content": "Se arma la polémica en New York. Parece que St. Clair agarra el esférico con las manos afuera del área. Villarreal dice que no es así, pero la gente protesta después de ver la repetición en la pantalla.\nGOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOL ... [4577 chars]",
            "url": "https://as.com/us/futbol/nycfc-inter-miami-en-vivo-mls-2026-en-directo-f202603-d/",
            "image": "https://img.asmedia.epimg.net/resizer/v2/BWXQIDEP3VL4XB4UBD7Q3ETVUU.jpg?auth=608656b6e0d9dba29037d59b1bc9d8fbb1d0028753722f9fffe6aff6540aad8c&width=1472&height=828&smart=true",
            "publishedAt": "2026-03-22T19:22:32Z",
            "lang": "es",
            "source": {
                "id": "ca9c060c7ad49f264bf6593eff25e45a",
                "name": "Diario AS",
                "url": "https://as.com"
            }
        },
        {
            "id": "022ed68dc0f0ea953b6c3a09446bd45d",
            "title": "Guerra en Irán hoy: Noticias del conflicto en Medio Oriente; OMS apunta a \"etapa peligrosa\" por ataques cerca de instalaciones nucleares",
            "description": "Este domingo 22 de marzo de 2026 han transcurrido 23 días del inicio de la guerra en Irán bajo la Operación Furia Épica a manos de Estados Unidos e Israel; en este LIVEBLOG de N+ Univision te compartimos la información más reciente sobre el conflicto.\n| N+ Univision Mundo | Univision",
            "content": "A través de un comunicado, afirmó que el ataque contra la infraestructura \"constituye una escalada peligrosa y una violación flagrante de la soberanía de Líbano, y se considera un preludio de una invasión terrestre\". Aoun calificó el bombardeo como u... [3777 chars]",
            "url": "https://www.univision.com/noticias/mundo/guerra-iran-hoy-domingo-22-de-marzo-de-2026-noticias-conflicto-medio-oriente-estados-unidos",
            "image": "https://www.univision.com/api/image/og/us/noticias/mundo/guerra-iran-hoy-domingo-22-de-marzo-de-2026-noticias-conflicto-medio-oriente-estados-unidos",
            "publishedAt": "2026-03-22T18:35:57Z",
            "lang": "es",
            "source": {
                "id": "eb4456d007d51d44dc62d01c16a53d83",
                "name": "Univision",
                "url": "https://www.univision.com"
            }
        }
    ]
}

Categories