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": 328042,
    "articles": [
        {
            "id": "1a55df86049f27276ee981e804c9ecef",
            "title": "Xelajú MC - Real España, en vivo: Copa Centroamericana de la Concacaf 2025, en directo",
            "description": "Xelajú MC y Real España se ven las caras en la semifinal de vuelta por la Copa Centroamericana de Concacaf. Bienvenidos a la previa y el minuto a minuto.",
            "content": "¡Tiempo extra en Guatemala!\nFinaliza el partido en los 90 minutos reglamentarios. Ahora, con el empate 1-1 aquí (2-2 global), es momento de ir a los tiempos extras.\nXelajú tiene el momento anímico y Real España está en shock.\n¡Goooooool de Xelajú!\nIm... [1999 chars]",
            "url": "https://as.com/us/futbol/xelaju-mc-real-espana-en-vivo-copa-centroamericana-de-la-concacaf-2025-en-directo-f202510-d/",
            "image": "https://img.asmedia.epimg.net/resizer/v2/NMO4BO5VYNPQDIJYELTAJPKLBE.jpg?auth=77874abd6a84e0536719ffab6ccd5a5bbac45c53b288d4aab1e1b09b1cfade85&width=1472&height=828&focal=2534%2C171",
            "publishedAt": "2025-10-30T04:51:23Z",
            "lang": "es",
            "source": {
                "id": "ca9c060c7ad49f264bf6593eff25e45a",
                "name": "Diario AS",
                "url": "https://as.com"
            }
        },
        {
            "id": "389845164dbea1a5ed7d1bdf6ef7dbeb",
            "title": "Xelajú vs Real España, EN VIVO Copa Centroamericana",
            "description": "España logra su pase a la final de la Copa Centroamericana y escribe una nueva página en su historia",
            "content": "La Copa Centroamericana entra en su fase más emocionante y esta noche Real España tiene una prueba de fuego ante Xelajú en Guatemala, en un partido que define su destino en las semifinales.\nTIEMPO EXTRA: Xelajú 1-1 Real España\nMINUTO 95 — Xelajú se a... [2428 chars]",
            "url": "https://www.laprensa.hn/deportes/xelaju-vs-real-espana-vivo-copa-centroamericana-hora-donde-ver-resumen-goles-jugadas-EK27963362",
            "image": "https://www.laprensa.hn/binrepository/1201x901/0c135/1200d630/none/11004/QSNU/motagua-55_12419632_20251029222754.jpg",
            "publishedAt": "2025-10-30T03:55:04Z",
            "lang": "es",
            "source": {
                "id": "2c1ee07022b8e60dc642801276e99446",
                "name": "LaPrensa.hn",
                "url": "https://www.laprensa.hn"
            }
        },
        {
            "id": "f44162ab23fadfd48165d5a3cc30fc61",
            "title": "World Series 2025: Trey Yesavage's record 12-strikeout night puts Blue Jays up 3-2 vs. Dodgers",
            "description": "The Blue Jays are one win from their first World Series title since 1993.",
            "content": "Trey Yesavage has a new place in baseball history. The Toronto Blue Jays have a 3-2 World Series lead. The Los Angeles Dodgers have some soul-searching to do.\nBehind a World Series rookie-record 12 strikeouts from the 22-year-old Yesavage, the Blue J... [3136 chars]",
            "url": "https://sports.yahoo.com/mlb/live/world-series-2025-trey-yesavages-record-12-strikeout-night-puts-blue-jays-up-3-2-vs-dodgers-231559005.html",
            "image": "https://s.yimg.com/ny/api/res/1.2/Yu7TrQdNzwxKQ3uXtfUAZw--/YXBwaWQ9aGlnaGxhbmRlcjt3PTEyMDA7aD04MDA7Y2Y9d2VicA--/https://s.yimg.com/os/creatr-uploaded-images/2025-10/d5de9bd0-b537-11f0-b51c-a69cf7960082",
            "publishedAt": "2025-10-30T03:19:57Z",
            "lang": "en",
            "source": {
                "id": "1213ab3f5e360256b89d3b205e3e8e48",
                "name": "Yahoo Sports",
                "url": "https://sports.yahoo.com"
            }
        }
    ]
}

Categories