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": 250462,
    "articles": [
        {
            "id": "051469b33f16435c891a5a0ff8ee85e4",
            "title": "Silicon Valley takes its AI pitch to the pope",
            "description": "As Leo XIV prepares his first encyclical, technology firms and Western diplomats have worked to make their case inside the Vatican.",
            "content": "On a recent sunny spring day, Father Eric Salobir led a delegation through St. Peter’s Square, past the crowds and toward Pope Leo XIV.\nWith him were representatives of Meta, Google and Amazon, part of a small group gathered in Rome to discuss child ... [7710 chars]",
            "url": "https://www.politico.eu/article/pope-leo-xiv-ai-meetings-silicon-valley-vatican/",
            "image": "https://www.politico.eu/cdn-cgi/image/width=1200,height=630,fit=crop,quality=80,onerror=redirect/wp-content/uploads/2026/05/22/WhatsApp-Image-2026-05-20-at-12.38.00-1.jpeg",
            "publishedAt": "2026-05-25T03:00:00Z",
            "lang": "en",
            "source": {
                "id": "3ba3d17ed2b9c7b829a43e4ec3f59eb0",
                "name": "politico.eu",
                "url": "https://www.politico.eu"
            }
        },
        {
            "id": "f937afa580db77c1b6045908d10f1b81",
            "title": "In Ukraine, a Divisive 20th-Century Hero Comes Home",
            "description": "Andriy Melnyk, criticized as a Nazi collaborator and lionized as an anti-Soviet resistance leader, was given state honors for his reburial near Kyiv.",
            "content": "With a Ukrainian military honor guard standing ramrod straight beside his coffin, Andriy Melnyk, a leader of a Ukrainian nationalist movement who died six decades ago — and who has been no less divisive after death than in life — lay in state in Kyiv... [1603 chars]",
            "url": "https://www.nytimes.com/2026/05/24/world/europe/ukraine-melnyk-nationalist-collaborator.html",
            "image": "https://static01.nyt.com/images/2026/05/24/world/24-int-ukraine-reburial/24-int-ukraine-reburial-facebookJumbo.jpg",
            "publishedAt": "2026-05-24T23:35:33Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "2a18c47a46961adb2239aba73ad63216",
            "title": "What to Know About the Potential U.S.-Iran Peace Deal",
            "description": "President Trump said on Saturday that an agreement to end the war was “largely negotiated,” but neither the United States nor Iran released many details of the proposal.",
            "content": "President Trump said on Saturday that the United States was close to reaching an agreement with Iran to end the war and reopen the Strait of Hormuz. He offered few details in a post on social media but said the preliminary agreement had been “largely... [1637 chars]",
            "url": "https://www.nytimes.com/2026/05/24/world/middleeast/us-iran-peace-deal-proposal.html",
            "image": "https://static01.nyt.com/images/2026/05/24/multimedia/24xp-mideast-agreement-wwk-1-hwml/24xp-mideast-agreement-wwk-1-hwml-facebookJumbo.jpg",
            "publishedAt": "2026-05-24T23:06:12Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories