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": 537660,
    "articles": [
        {
            "id": "1b8ea0338ca0a61640463d2f57cc3e7a",
            "title": "Resumen del partido Pumas vs América (3",
            "description": "Universitarios y Águilas regalaron un partido memorable en Liguilla",
            "content": "Más cardiaco no podía ser un juego entre Pumas y América que el celebrado en esta Liguilla del Clausura 2026 en el que los felinos avanzaron a Semifinales gracias a que lograron eliminar a las Águilas tras un empate 3-3, global 6-6, y a su mejor posi... [3152 chars]",
            "url": "https://www.mediotiempo.com/futbol/liga-mx/pumas-vs-america-resumen-del-partido-cuartos-de-final-vuelta-clausura-2026",
            "image": "https://cdn2.mediotiempo.com/uploads/media/2026/05/10/pumas-aguanto-la-presion-y.jpg",
            "publishedAt": "2026-05-11T03:24:00Z",
            "lang": "es",
            "source": {
                "id": "6adfa15ab0543b6a74cc26dcb93ab0cc",
                "name": "Mediotiempo",
                "url": "https://www.mediotiempo.com"
            }
        },
        {
            "id": "992cb5e3ffe3e047cb16380cc3560e10",
            "title": "Spring & Mulberry chocolate recall expands over salmonella risk",
            "description": "FDA issues expanded recall of Spring & Mulberry chocolate bars over possible salmonella risk tied to contaminated dates, no illnesses reported.",
            "content": "Spring & Mulberry is expanding its recall of select chocolate bars to include all 12 of its product lines over concerns of possible Salmonella contamination, according to federal regulators.\nThe Friday announcement marks the second widening of the re... [2801 chars]",
            "url": "https://www.foxbusiness.com/lifestyle/chocolate-recall-hits-companys-entire-product-lineup-salmonella-contamination-fears",
            "image": "https://a57.foxnews.com/static.foxbusiness.com/foxbusiness.com/content/uploads/2026/01/0/0/chocolate-bars-pile.jpg?ve=1&tl=1",
            "publishedAt": "2026-05-11T02:25:00Z",
            "lang": "en",
            "source": {
                "id": "2129172d996b80818e14ef74fc4d88e6",
                "name": "Fox Business",
                "url": "https://www.foxbusiness.com"
            }
        },
        {
            "id": "56c9d7c5faefb2d34488fc0f68fda520",
            "title": "Hegseth calls for Sen. Mark Kelly to be investigated by Pentagon for second time",
            "description": "Defense Secretary Pete Hegseth on Sunday called for Sen. Mark Kelly to be investigated over comments he made about US weapon stockpiles, marking the second time the Pentagon chief has opened a review into the Democratic senator.",
            "content": "Defense Secretary Pete Hegseth on Sunday called for Sen. Mark Kelly to be investigated over comments he made about US weapon stockpiles, marking the second time the Pentagon chief has opened a review into the Democratic senator.\nHegseth slammed the r... [3322 chars]",
            "url": "https://www.cnn.com/2026/05/10/politics/mark-kelly-pete-hegseth-pentagon-investigation",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/ap26127628338196.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-05-11T02:18:00Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        }
    ]
}

Categories