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": 248912,
    "articles": [
        {
            "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"
            }
        },
        {
            "id": "f4e26d869121a1c247ce0fce2376409d",
            "title": "Iran War Live Updates: Peace Deal Nearer, But Could Take Days to Nail Down, U.S. Official Says",
            "description": "The official said the sides had agreed in principle to reopen the Strait of Hormuz and commit Iran to disposing of its highly enriched uranium, but stressed that a deal had not yet been signed.",
            "content": "Iran’s leaders and official state media have not publicly commented on what is in any potential agreement or what is being discussed. Officials from both countries have said any agreement would be an initial framework that would lead to further negot... [40220 chars]",
            "url": "https://www.nytimes.com/live/2026/05/24/world/iran-war-trump",
            "image": "https://static01.nyt.com/images/2026/05/24/multimedia/24mideast-400-fgkh/24mideast-400-fgkh-facebookJumbo.jpg",
            "publishedAt": "2026-05-24T20:45:05Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "72efe2a43d8ecfe8060d779aae4933d3",
            "title": "Shark kills spearfisher in front of friends in Australia: \"Terrifying thing to see\"",
            "description": "A spearfisher was killed on the Great Barrier Reef on Sunday in Australia's second fatal shark attack in just over a week, police said.",
            "content": "A man spearfishing with friends was killed by a shark on the Great Barrier Reef on Sunday, police said, in Australia's second fatal shark attack in just over a week.\nThe 39-year-old man was with three friends diving from a boat at Kennedy Shoal off t... [2492 chars]",
            "url": "https://www.cbsnews.com/news/shark-kills-spearfisher-australia-terrifying-thing-to-see/",
            "image": "https://assets3.cbsnewsstatic.com/hub/i/r/2025/07/17/4852630b-394e-4389-9b68-03f4aebc11c6/thumbnail/1200x630g7/2afbc24a71aa93ac89b57f4473ff1141/gettyimages-1169324847.jpg",
            "publishedAt": "2026-05-24T18:26:00Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        }
    ]
}

Categories