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": 232240,
    "articles": [
        {
            "id": "c214b5b4f295722d8fd1142f8a9bcade",
            "title": "Jewish Londoners describe \"utter horror\" and living in fear after latest attack, demand government action",
            "description": "\"We've been warning about this for a long time,\" one local resident told CBS News. \"It's like a tsunami — you see the smaller waves before the big one hits.\"",
            "content": "London — British Prime Minister Keir Starmer was heckled Thursday during a visit to North London, a day after two Jewish men were wounded in a stabbing attack — the latest in a series of incidents that one of Starmer's cabinet members has called an a... [6069 chars]",
            "url": "https://www.cbsnews.com/news/london-antisemitic-attacks-jewish-residents-describe-horror-fear/",
            "image": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/04/30/c502985a-5fef-4108-8976-0c8b737f4021/thumbnail/1200x630/6197ce63c4cf53594b99333a6d03839f/gettyimages-2273134961.jpg",
            "publishedAt": "2026-05-01T06:36:17Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        },
        {
            "id": "5667504f8917f0a9f300c92d041d8e0c",
            "title": "Violence Erupts in Australian Town After Arrest of Suspect in Girl’s Killing",
            "description": "Police in Alice Springs fired rubber bullets and tear gas to disperse an angry crowd demanding justice.",
            "content": "Violence erupted across a rural town in northern Australia on Thursday night, after a crowd of people assaulted a man suspected of killing a five-year-old Indigenous girl and then clashed with the police officers who were arresting him.\nOfficers tran... [1324 chars]",
            "url": "https://www.nytimes.com/2026/05/01/world/australia/alice-springs-jefferson-lewis-girl-kumanjayi.html",
            "image": "https://static01.nyt.com/images/2026/05/01/multimedia/01int-Oz-crime-ltkp/01int-Oz-crime-ltkp-facebookJumbo.jpg",
            "publishedAt": "2026-05-01T06:28:28Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "f867a2410502178b8a7371e029828ef4",
            "title": "China and America Are Courting Nuclear Catastrophe",
            "description": "The consequences of Beijing’s weapons buildup.",
            "content": "Over the past decade, China has been steadily reshaping the global nuclear order. According to U.S. government assessments, Beijing has almost tripled its stockpile of nuclear warheads since 2019. It has rapidly increased its nuclear capabilities on ... [15749 chars]",
            "url": "https://www.foreignaffairs.com/united-states/china-and-america-are-courting-nuclear-catastrophe",
            "image": "https://cdn-live.foreignaffairs.com/sites/default/files/styles/social_share/public/images/2026/04/17/2025-09-03T062414Z_765189748_RC22KGAD2D1O_RTRMADP_3_WW2-ANNIVERSARY-CHINA.JPG?itok=fw9Uu84c",
            "publishedAt": "2026-05-01T04:00:00Z",
            "lang": "en",
            "source": {
                "id": "77c0adef2394adebf95bf458030ba8ea",
                "name": "Foreign Affairs",
                "url": "https://www.foreignaffairs.com"
            }
        }
    ]
}

Categories