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": 361710,
    "articles": [
        {
            "id": "5e8c349d25df76c370656b226f4f5af7",
            "title": "Musk and Hegseth vow to “make Star Trek real” but miss the show’s lessons",
            "description": "AI weapons systems may annihilate their creators.",
            "content": "This week, SpaceX CEO Elon Musk and Secretary of Defense Pete Hegseth touted their desire to “make Star Trek real”—while unconsciously reminding us of what the utopian science fiction franchise is fundamentally about.\nTheir Tuesday event was the late... [3081 chars]",
            "url": "https://arstechnica.com/culture/2026/01/pentagons-arsenal-of-freedom-tour-borrows-name-from-star-trek-episode-about-killer-ai/",
            "image": "https://cdn.arstechnica.net/wp-content/uploads/2026/01/vulcan-salute-1152x648-1768432794.jpg",
            "publishedAt": "2026-01-14T23:43:46Z",
            "lang": "en",
            "source": {
                "id": "344add8dabb753d03641ce9f246787ad",
                "name": "Ars Technica",
                "url": "https://arstechnica.com"
            }
        },
        {
            "id": "6a75ddb009aa6b7dc513565cf5386fe4",
            "title": "SC measles outbreak has gone berserk: 124 cases since Friday, 409 quarantined",
            "description": "On Jan. 6, there were 211 cases. The outbreak, which began in October, is now at 434.",
            "content": "A measles outbreak in South Carolina that began in October is now wildly accelerating, doubling in just the past week to a total of 434 cases, with 409 people currently in quarantine.\nAmid the outbreak, South Carolina health officials have been provi... [2052 chars]",
            "url": "https://arstechnica.com/health/2026/01/sc-measles-outbreak-has-gone-berserk-124-cases-since-friday-409-quarantined/",
            "image": "https://cdn.arstechnica.net/wp-content/uploads/2020/05/misinfoTOP-1152x648.jpg",
            "publishedAt": "2026-01-14T23:08:44Z",
            "lang": "en",
            "source": {
                "id": "344add8dabb753d03641ce9f246787ad",
                "name": "Ars Technica",
                "url": "https://arstechnica.com"
            }
        },
        {
            "id": "2113288383f4dd7e9181f3c720ce5aaf",
            "title": "Crew-11 astronauts undock in 1st-ever medical evacuation from the International Space Station (video)",
            "description": "SpaceX's Crew-11 astronauts left the International Space Station today (Jan. 14) in the first-ever medical evacuation from the orbiting lab.",
            "content": "Four astronauts aboard the International Space Station are returning to Earth today (Jan. 14), more than a month earlier than originally planned.\nNASA made the decision to cut SpaceX's Crew-11 mission short due to an undisclosed medical concern with ... [1907 chars]",
            "url": "https://www.space.com/space-exploration/international-space-station/watch-crew-11-astronauts-undock-in-1st-ever-medical-evacuation-from-the-international-space-station-today",
            "image": "https://cdn.mos.cms.futurecdn.net/oVAGqs2yxUxS4cq4kDzziC-2560-80.jpg",
            "publishedAt": "2026-01-14T22:57:58Z",
            "lang": "en",
            "source": {
                "id": "024dd4370bda9e6e6791231c2a935d20",
                "name": "Space",
                "url": "https://www.space.com"
            }
        }
    ]
}

Categories