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": 228798,
    "articles": [
        {
            "id": "00c4255d8cf27de6b3dd47025bee499a",
            "title": "Japan scraps its ban on lethal weapons exports",
            "description": "Japan is scrapping a ban on lethal weapons exports, a major change of its postwar pacifist policy as the country seeks to build up its arms industry and deepen cooperation with defense partners.",
            "content": "TOKYO (AP) — Japan on Tuesday scrapped a ban on lethal weapons exports, a major change in its postwar pacifist policy as the country seeks to build up its arms industry amid worries over Chinese and North Korean aggression.\nThe approval by Prime Mini... [5210 chars]",
            "url": "https://apnews.com/article/japan-lethal-weapons-export-takaichi-767250e58084ea3d585ab736372deeac",
            "image": "https://dims.apnews.com/dims4/default/9e0f35c/2147483647/strip/true/crop/8000x5331+0+94/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fbb%2Fab%2F1eb12853af5d7d9dcdbc4e6088ab%2Fb96d0085b22f4b7aa26e6e86a3c4c7ce",
            "publishedAt": "2026-04-21T12:59:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "758f13beca99adab5b18c23e790d6b32",
            "title": "Mass trial for 486 alleged MS-13 gang leaders begins in El Salvador",
            "description": "The group are collectively accused of committing more than 47,000 crimes, including murder.",
            "content": "A mass trial of 486 suspected MS-13 gang leaders has begun in El Salvador, the country's attorney general's office has said.\nThe group are collectively accused of committing more than 47,000 crimes - including murder, extortion, drug and arms traffic... [1694 chars]",
            "url": "https://www.bbc.com/news/articles/c20ql985gryo",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/aa3c/live/c2007f40-3d70-11f1-bb8a-374117ea6afa.jpg",
            "publishedAt": "2026-04-21T12:48:09Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "65d12ef9008dcf5adae62d97a75cd9f1",
            "title": "2 Cruise Ships Clear Strait of Hormuz After Being Stranded for Weeks",
            "description": "The ships carried skeleton crews and no passengers, the cruise company said.",
            "content": "Two cruise ships passed through the Strait of Hormuz over the weekend during a brief window when the waterway was open to ship traffic, according to the vessels’ German operator.\nThe two ships, Mein Schiff 4 and Mein Schiff 5, both staffed with skele... [1922 chars]",
            "url": "https://www.nytimes.com/2026/04/21/world/middleeast/cruise-ships-strait-hormuz-iran.html",
            "image": "https://static01.nyt.com/images/2026/04/21/multimedia/21israel-iran-cruise-ships-ftbp/21israel-iran-cruise-ships-ftbp-facebookJumbo.jpg",
            "publishedAt": "2026-04-21T12:29:55Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories