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": 191600,
    "articles": [
        {
            "id": "fbe47c75e3a5f97c8449db9144f164ec",
            "title": "Finland detains ship after critical undersea cable damaged",
            "description": "Finland has detained a ship after a critical undersea telecommunication cable running between the country and Estonia was damaged Wednesday, Finnish authorities said.",
            "content": "Finland has detained a ship after a critical undersea telecommunication cable running between the country and Estonia was damaged Wednesday, Finnish authorities said.\nFinnish police said in a statement that the vessel suspected of causing the damage ... [1011 chars]",
            "url": "https://www.cnn.com/2025/12/31/europe/finland-estonia-undersea-cable-ship-detained-intl",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/breaking-news-1-5x.png?c=16x9&q=w_800,c_fill",
            "publishedAt": "2025-12-31T12:24:38Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "c7eff014acac1d50cd1651d4ed92bc46",
            "title": "Heavy police presence in Sydney for New Year's celebrations after Bondi attack",
            "description": "Thousands of officers are deployed around Sydney Harbour and across the city, with some carrying high-grade weapons as part of heightened security measures.",
            "content": "7 minutes ago\nHafsa Khalil\nThousands of heavily armed police officers are patrolling the streets of Sydney as people mark the new year - a rare and stark sight in Australia, following the Bondi Beach mass shooting.\nSome officers were authorised to ca... [2170 chars]",
            "url": "https://www.bbc.com/news/articles/clye3xz52e5o",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/14e1/live/c1f9f5b0-e633-11f0-a76c-07ff70ccfd82.jpg",
            "publishedAt": "2025-12-31T11:49:13Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "c516f2c04af6af928556fa867e0673ff",
            "title": "How Russia Is Brutalizing Its Own Soldiers, and More Than 5 Million Pages of Epstein Files",
            "description": "Plus, the viral video that got the White House’s attention.",
            "content": "Listen to and follow ‘The Headlines’\nApple Podcasts | Spotify | Amazon Music | YouTube | iHeartRadio\nSign up for our weekly audio newsletter. Unlock full access to New York Times podcasts and explore everything from politics to pop culture. Subscribe... [259 chars]",
            "url": "https://www.nytimes.com/2025/12/31/podcasts/the-headlines/russia-soldiers-5-million-pages-epstein-files.html",
            "image": "https://static01.nyt.com/images/2025/12/22/multimedia/31headlines/22Russia-soldiers-01-pcmj-facebookJumbo.jpg",
            "publishedAt": "2025-12-31T11:00:10Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories