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": 206080,
    "articles": [
        {
            "id": "1ebd481194d60b810fcae73ca082082f",
            "title": "’The Interview’: Gisèle Pelicot Shares Her Story",
            "description": "In her first interview with an American media outlet, Pelicot opens up about surviving years of secret abuse — and a trial that shocked the world.",
            "content": "It is one of the most heinous sexual-abuse stories in history. Gisèle Pelicot was drugged and raped repeatedly by the person she trusted most in the world — her husband, Dominique Pelicot — who also invited dozens of men into their bedroom to rape Pe... [1367 chars]",
            "url": "https://www.nytimes.com/2026/02/13/magazine/gisele-pelicot-france-rape-case-story.html",
            "image": "https://static01.nyt.com/images/2026/02/14/magazine/14mag-interview-pelicot/14mag-interview-pelicot-facebookJumbo-v2.jpg",
            "publishedAt": "2026-02-13T17:41:22Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "8ff59f3f6302f5fe2ea4d58272775cd8",
            "title": "As Diplomats Talk, Pentagon Prepares for Possible War With Iran",
            "description": "President Trump threatened to strike Iran, but the military has needed time to build up its forces in the region.",
            "content": "When President Trump threatened last month to strike Iran if its government did not agree to a deal to curb its nuclear program, the Pentagon was in a poor position to back him up.\nThe 30,000 to 40,000 American troops scattered around the Middle East... [1600 chars]",
            "url": "https://www.nytimes.com/2026/02/13/us/politics/trump-iran-pentagon.html",
            "image": "https://static01.nyt.com/images/2026/02/13/multimedia/13DC-Iran_Military-fptg/13DC-Iran_Military-fptg-facebookJumbo.jpg",
            "publishedAt": "2026-02-13T17:15:58Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "9c9d24abb196b279c1fde1c7406f3dca",
            "title": "High Court dismisses challenge to single-sex toilet guidance",
            "description": "Campaigners claimed the guidance for employers, such as hospitals, shops and restaurants, was \"legally flawed\" and \"overly simplistic\".",
            "content": "A High Court judge has dismissed a legal challenge to the equality watchdog's guidance on which public or workplace toilets and changing rooms transgender people should use.\nThe judgment urged businesses and services to follow the law, seek specialis... [2874 chars]",
            "url": "https://www.bbc.com/news/articles/c2lrd0ey074o",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/92b6/live/4e37c900-08ce-11f1-bed4-8368e91e11b3.jpg",
            "publishedAt": "2026-02-13T16:57:01Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Categories