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": 389922,
    "articles": [
        {
            "id": "2663dc2f4d81939c454af37e16b91855",
            "title": "University of Michigan Athletics",
            "description": "The University of Michigan's Donald R. Shepherd Director of Athletics Warde Manuel announced Friday (Dec. 26) the hiring of Kyle Whittingham as the 22nd head...",
            "content": "ANN ARBOR, Mich. -- The University of Michigan's Donald R. Shepherd Director of Athletics Warde Manuel announced Friday (Dec. 26) the hiring of Kyle Whittingham as the 22nd head football coach in the 146-year history of the Michigan program. Whitting... [8191 chars]",
            "url": "https://mgoblue.com/news/2025/12/26/kyle-whittingham-named-michigans-j-ira-and-nicki-harris-family-head-football-coach",
            "image": "https://images.sidearmdev.com/resize?url=https%3A%2F%2Fdxbhsrqyrr690.cloudfront.net%2Fsidearm.nextgen.sites%2Fmgoblue.com%2Fimages%2F2025%2F12%2F26%2Fimg_27599909_bPfKC.jpg&width=1600&type=jpeg",
            "publishedAt": "2025-12-27T03:21:34Z",
            "lang": "en",
            "source": {
                "id": "5fb05e3faab25692ce6ea239659d0ecd",
                "name": "University of Michigan Athletics",
                "url": "https://mgoblue.com"
            }
        },
        {
            "id": "ba8a6959a90eab89012bb54fdcbbbcdb",
            "title": "Popeye’s continúa su expansión y abre su primer restaurante bajo un nuevo concepto",
            "description": "El restaurante de comida rápida invierte $2 millones en dos nuevas localidades",
            "content": "Con la meta de innovar en el segmento de servicio rápido (QSR, por sus siglas en inglés), Popeye’s anunció esta semana la apertura de su restaurante 29, y el primero, bajo el concepto de “Popeye’s ToGo”.\nRestaurant Holding Company (RHC), uno de los o... [4112 chars]",
            "url": "https://www.elnuevodia.com/negocios/empresas-comercios/notas/popeyes-continua-su-expansion-en-puerto-rico/",
            "image": "https://www.elnuevodia.com/resizer/v2/RH2ZXR54KZB3RIUEOEZKUF7U5I.png?auth=226899978087b399ed1e0cbd4b105cd87cfda5fd8aa7f266fc99b355c8fcd095&quality=75&width=1200&height=717&focal=638%2C247",
            "publishedAt": "2025-12-27T03:10:00Z",
            "lang": "es",
            "source": {
                "id": "dcbaf0be33203c3a7f047c2a890430ab",
                "name": "El Nuevo Día",
                "url": "https://www.elnuevodia.com"
            }
        },
        {
            "id": "499e2a5715b5d77391c7aef2c2435ff2",
            "title": "17 New Mexico (Dec 26, 2025) Game Recap",
            "description": "Expert recap and game analysis of the Minnesota Golden Gophers vs. New Mexico Lobos NCAAF game from December 26, 2025 on ESPN.",
            "content": "PHOENIX -- — Minnesota thrives in an era of bowl opt-outs, even when a national championship is out of reach.\nThese Golden Gophers dig the postseason.\nJalen Smith scored his second touchdown on a diving 12-yard catch in the first overtime and Minneso... [3185 chars]",
            "url": "https://www.espn.com/college-football/recap?gameId=401778314",
            "image": "http://s.espncdn.com/stitcher/sports/football/college-football/events/401778314.png?templateId=espn.com.share.1",
            "publishedAt": "2025-12-27T01:18:45Z",
            "lang": "en",
            "source": {
                "id": "0207e330d5d787ce8251900411dd488d",
                "name": "ESPN",
                "url": "https://www.espn.com"
            }
        }
    ]
}

Categories