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": 202976,
    "articles": [
        {
            "id": "2064aef44f9144fb080220ccaf77a52a",
            "title": "American rock climber ascends Taipei 101 without any ropes",
            "description": "American rock climber Alex Honnold has ascended the Taipei 101 skyscraper without any ropes or protective equipment.",
            "content": "TAIPEI, Taiwan (AP) — American rock climber Alex Honnold ascended the Taipei 101 skyscraper on Sunday without any ropes or protective equipment.\nCheers erupted from a street-level crowd as he reached the top of the spire of the 508-meter (1,667-foot)... [1367 chars]",
            "url": "https://apnews.com/article/alex-honnold-taipei-101-solo-climb-netflix-cfe8960237290086cdee581075056fbf",
            "image": "https://dims.apnews.com/dims4/default/074eb36/2147483647/strip/true/crop/5728x3817+136+0/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F7d%2Fca%2F66ad3acd419e8a6cf81cc05b161c%2Fap26025092978764.jpg",
            "publishedAt": "2026-01-25T03:23:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "38f6e87d1d0aaac5f5ea9a5ed8bdd84a",
            "title": "Climber Alex Honnold free solos Taipei 101 skyscraper",
            "description": "Alex Honnold also famously climbed Yosemite's El Capitan without any ropes or safety gear in 2017.",
            "content": "Climber Alex Honnold has completed a free solo ascent of Taipei 101 in Taiwan, not using any ropes to scale the massive 1,667-foot skyscraper — and he did it live, as the world watched on with bated breath and hearts racing.\nIt took Honnold 1 hour an... [2571 chars]",
            "url": "https://www.cbsnews.com/news/alex-honnold-free-solo-climbs-taipei-101-skyscraper/",
            "image": "https://assets1.cbsnewsstatic.com/hub/i/r/2026/01/25/72c3b433-0191-4eef-8335-368763571f2a/thumbnail/1200x630/ab82304f802d78ca814b4ec4e2706fbd/gettyimages-2257492518.jpg",
            "publishedAt": "2026-01-25T02:59:10Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        },
        {
            "id": "ab0a9d4eda40af2883d066a82b9382fb",
            "title": "Alex Honnold Finishes Taipei 101 Climb During Netflix Skyscraper Live",
            "description": "Alex Honnold",
            "content": "World-renowned free solo climber Alex Honnold has successfully summited Taiwan’s Taipei 101 in just over an hour and thirty minutes, accomplishing his lifelong dream and setting a record for the tallest urban free solo climb in the world. The athlete... [4547 chars]",
            "url": "https://deadline.com/2026/01/alex-honnold-skyscraper-live-netflix-completed-1236695749/",
            "image": "https://deadline.com/wp-content/uploads/2026/01/SKYSCAPER_LIVE_14.jpg?w=1024",
            "publishedAt": "2026-01-25T02:52:00Z",
            "lang": "en",
            "source": {
                "id": "079303dd146f0fcdde881d709e8dbdf4",
                "name": "Deadline",
                "url": "https://deadline.com"
            }
        }
    ]
}

Categories