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": 365042,
    "articles": [
        {
            "id": "a941f42a13923a5c7af6a28b42b327f9",
            "title": "Donald Trump dijo que el espacio aéreo de Venezuela debe considerarse “cerrado en su totalidad”",
            "description": "El presidente de Estados Unidos dirigió el mensaje “a todas las aerolíneas, pilotos, narcotraficantes y traficantes de personas”",
            "content": "El presidente de Estados Unidos, Donald Trump, expresó este sábado que el espacio aéreo de Venezuela debe considerarse “cerrado en su totalidad”.\nA través de su cuenta en la red social Truth, el mandatario manifestó: “A todas las aerolíneas, pilotos,... [5690 chars]",
            "url": "https://www.infobae.com/venezuela/2025/11/29/donald-trump-dijo-que-el-espacio-aereo-de-venezuela-debe-considerarse-cerrado-en-su-totalidad/",
            "image": "https://www.infobae.com/resizer/v2/7YYR25I7WVH3PEOOTBRKK2NK6I.JPG?auth=dc108c47797beb67c6dd7e3026e4a7b7553c3fdeb80b90f7362dc65e650d8223&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2025-11-29T13:00:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        },
        {
            "id": "69ed013ef99858bf13a84464d41d06b9",
            "title": "Three-loss Texas is alive, and so is the College Football Playoff debate of SEC dreams",
            "description": "A lot of uncomfortable conversations the CFP committee has been avoiding are about to take center stage.",
            "content": "The Athletic has live coverage of Ohio State vs. Michigan from college football rivalry week.\nAUSTIN, Texas — Arch Manning found a hole, found space, found the end zone. And with the dagger touchdown, Texas found itself back in the College Football P... [7087 chars]",
            "url": "https://www.nytimes.com/athletic/6846960/2025/11/29/texas-college-football-playoff-resume-sec/",
            "image": "https://static01.nyt.com/athletic/uploads/wp/2025/11/29062808/GettyImages-2248967208-scaled-e1764415717547.jpg?width=1200&height=630&fit=cover",
            "publishedAt": "2025-11-29T11:33:15Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "f21464a962365f9677e00e90e98d15c2",
            "title": "Pope Leo removes shoes but does not appear to pray in first mosque visit",
            "description": "Pope Leo XIV has made his first visit to a mosque since his election, and while he removed his shoes as a sign of respect, he did not appear to pray.",
            "content": "Pope Leo XIV has made his first visit to a mosque since his election, and while he removed his shoes as a sign of respect, he did not appear to pray.\nOn Saturday, Leo went to the Blue Mosque in Istanbul, a 17th-century place of worship considered an ... [2142 chars]",
            "url": "https://www.cnn.com/2025/11/29/europe/pope-leo-istanbul-blue-mosque-intl",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/ap25333241006367.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2025-11-29T10:28:18Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        }
    ]
}

Categories