Flag of United States

United States World News API

Get the live top world headlines from United States with our JSON API.

Get API key for the United States World 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=world&apikey=API_KEY
{
    "totalArticles": 206800,
    "articles": [
        {
            "id": "5048c895e46012c5f2141c82e84ddb68",
            "title": "In Talks, Trump Won’t Allow Iran to Have Any Enriched Uranium",
            "description": "Can the two sides get past Iran’s claim that it has a “right” to enrich uranium?",
            "content": "Zero.\nAs the Trump administration begins negotiations with Iran to avoid possible war, that number defines the diplomatic challenge.\nZero is how much uranium President Trump says he would allow Iran to enrich under any deal to defuse the latest crisi... [1173 chars]",
            "url": "https://www.nytimes.com/2026/02/06/us/politics/trump-iran-nuclear.html",
            "image": "https://static01.nyt.com/images/2026/02/06/multimedia/06dc-iran-uranium-mgpk/06dc-iran-uranium-mgpk-facebookJumbo.jpg",
            "publishedAt": "2026-02-07T02:06:59Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "9856bb14ed5f5d2fc8e49c315d30de4f",
            "title": "Death Row Reversal by China Is a Gesture to Canada",
            "description": "The ruling by China’s highest court followed a recent meeting between China and Canada’s top leaders led to a thaw in the two countries’ relations.",
            "content": "China’s highest court on Friday overturned a death sentence against a Canadian man convicted of drug smuggling, a sudden reversal in a case that has been a yearslong source of diplomatic friction between Beijing and Ottawa.\nThe case of the man, Rober... [1459 chars]",
            "url": "https://www.nytimes.com/2026/02/06/world/asia/china-canada-death-sentence-overturned.html",
            "image": "https://static01.nyt.com/images/2026/02/06/multimedia/06int-china-canada-phfb/06int-china-canada-phfb-facebookJumbo.jpg",
            "publishedAt": "2026-02-07T01:26:24Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "0860845c92e3d6b138e9e724a020b767",
            "title": "ISIS reivindicó el atentado terrorista en una mezquita en Pakistán que dejó 31 muertos más de 160 heridos",
            "description": "El ataque suicida durante la oración del viernes se convirtió en el más letal en la capital paquistaní desde 2008",
            "content": "Al menos 31 personas murieron y 169 resultaron heridas en un atentado suicida perpetrado durante la oración del viernes en la mezquita chiita Imam Bargah Qasr-e-Khadijatul Kubra, situada en el área de Tarlai, a las afueras de Islamabad. El ataque, re... [3117 chars]",
            "url": "https://www.infobae.com/america/mundo/2026/02/07/isis-reivindico-el-atentado-terrorista-en-una-mezquita-en-pakistan-que-dejo-31-muertos-mas-de-160-heridos/",
            "image": "https://www.infobae.com/resizer/v2/SLHUW3POMJBM5FQZSS4PCHUYOQ.JPG?auth=fa4a590419573a4cb3dddbbb84a31736184d5a69f7efcb4b11979bce7f3a35bf&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2026-02-07T00:14:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        }
    ]
}

Categories