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": 579196,
    "articles": [
        {
            "id": "318f2150aef19ac7550813d98ef9b56e",
            "title": "Iran attacks Bahrain and Kuwait with drones and missiles and threatens to halt talks",
            "description": "Iran’s paramilitary Revolutionary Guard says it launched drone and missile attacks targeting Bahrain and Kuwait in response to U.S. airstrikes that hit the Islamic Republic.",
            "content": "DUBAI, United Arab Emirates (AP) — Iran’s paramilitary Revolutionary Guard launched drone and missile attacks Sunday targeting Bahrain and Kuwait in response to U.S. airstrikes that hit the Islamic Republic, and threatened a “complete halt” could com... [4190 chars]",
            "url": "https://apnews.com/article/iran-us-israel-war-hormuz-strait-june-28-2026-1132d316545db2cddb3928b6e7840f51",
            "image": "https://dims.apnews.com/dims4/default/4f3e4f3/2147483647/strip/true/crop/5500x3665+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fe0%2F79%2Fd12d3715d10ea6065ba93a6641ef%2F68c196edf5244b759d9371eefed2fd56",
            "publishedAt": "2026-06-28T07:30:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "bed73e71232a9658694776bb2301e005",
            "title": "Which teams are in World Cup last-32 knockouts, and what is the schedule?",
            "description": "All the qualified teams and match schedule for the round of 32 at the 2026 FIFA World Cup, which begins on Sunday.",
            "content": "All the qualified teams and match schedule for the round of 32 at the 2026 FIFA World Cup, which begins on Sunday.\nShare\nThe round of 32 bracket of the 2026 World Cup is complete.\nAfter 72 group games featuring 48 teams, it’s time for the knockouts.\n... [2419 chars]",
            "url": "https://www.aljazeera.com/sports/2026/6/28/which-teams-are-in-world-cup-last-32-knockouts-and-what-is-the-schedule",
            "image": "https://www.aljazeera.com/wp-content/uploads/2026/06/2026-06-28T022120Z_1905514881_MT1USATODAY29287701_RTRMADP_3_SOCCER-FIFA-WORLD-CUP-2026-GROUP-L-PANAMA-V-ENGLAND-1782618863_a8d9e3-1782625852.jpg?resize=1200%2C630&quality=80",
            "publishedAt": "2026-06-28T06:18:45Z",
            "lang": "en",
            "source": {
                "id": "7530d90c9af769eda4cb548f32ed381d",
                "name": "Al Jazeera",
                "url": "https://www.aljazeera.com"
            }
        },
        {
            "id": "baf57fc274cac7833c4541145b83bf05",
            "title": "PFL San Diego: McKee vs. Isbulaev live results, highlights",
            "description": "Follow along for live updates and highlights for PFL San Diego.",
            "content": "12:09 am ET June 28, 2026\nPFL San Diego post-fight show\n12:04 am ET June 28, 2026\nPFL San Diego results: A.J. McKee def. Salamat Isbulaev\nResult: A.J. McKee def. Salamat Isbulaev via unanimous decision (30-27, 30-27, 30-27)\nRecap: PFL San Diego resul... [7981 chars]",
            "url": "https://mmajunkie.usatoday.com/story/sports/pfl/2026/06/27/pfl-san-diego-mckee-vs-isbulaev-live-results-highlights--live/90724322007/",
            "image": "https://mmajunkie.usatoday.com/gcdn/authoring/authoring-images/2026/06/26/SMMA/90715612007-pfl-20260626-mb-7-7032.JPG?crop=5497,3092,x0,y0&width=3200&height=1800&format=pjpg&auto=webp",
            "publishedAt": "2026-06-28T04:39:40Z",
            "lang": "en",
            "source": {
                "id": "a6c55b108c862c448499845826257e4c",
                "name": "MMA Junkie",
                "url": "https://mmajunkie.usatoday.com"
            }
        }
    ]
}

Categories