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": 240282,
    "articles": [
        {
            "id": "8fc1c3e93981c5b6efc5f4d787c472cf",
            "title": "Poor in an oil-rich country: Republic of Congo’s youth hope for change",
            "description": "In an oil-producing country where 60 percent of people are under 25, nearly half the population lives in poverty.",
            "content": "Pointe-Noire and Brazzaville, Republic of Congo – In Pointe-Noire, the economic capital of the Republic of Congo, the aisles of the Grand Marche come alive in the early hours of the morning. Among the market stalls, street vendors, and shoppers pushi... [12088 chars]",
            "url": "https://www.aljazeera.com/features/2026/3/13/poor-in-an-oil-rich-country-republic-of-congos-youth-hope-for-change",
            "image": "https://www.aljazeera.com/wp-content/uploads/2026/03/2026-03-11T080643Z_1097799262_RC2S1KAU5ST4_RTRMADP_3_CONGOREPUBLIC-ELECTION-CANDIDATES-1773325545.jpg?resize=1920%2C1440",
            "publishedAt": "2026-03-13T11:08:22Z",
            "lang": "en",
            "source": {
                "id": "7530d90c9af769eda4cb548f32ed381d",
                "name": "Al Jazeera",
                "url": "https://www.aljazeera.com"
            }
        },
        {
            "id": "0ebc35205111c4f27aae3746f7d958ad",
            "title": "Drone Strike Has Cyprus, and Europe, on Edge",
            "description": "Allies have rushed to defend the Mediterranean nation, where the drone hit a British base. Some Cypriots wonder why the bases are still there.",
            "content": "When a drone hit a British air base in Cyprus around midnight on the second night of the war in Iran, it caused a chaotic scramble that is still reverberating across Europe.\nSirens blasted until dawn as military families were evacuated to hotels and ... [864 chars]",
            "url": "https://www.nytimes.com/2026/03/13/world/middleeast/cyprus-iran-drone-strike.html",
            "image": "https://static01.nyt.com/images/2026/03/12/multimedia/00int-cyprus-jztl/00int-cyprus-jztl-facebookJumbo-v2.jpg",
            "publishedAt": "2026-03-13T09:50:28Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "04a31fa9be65f89c3b92217a0ea5abf3",
            "title": "How Iran’s Naval Mines Work",
            "description": "Iran’s arsenal of some 5,000 mines could further complicate efforts to restart shipping in the Persian Gulf.",
            "content": "Floating on\nor just below\nthe sea surface\nFloating on\nor just below\nthe sea surface\nFloating on\nor just below\nthe sea surface\nFloating on\nor just below\nthe sea surface\nTankers travel along narrow lanes that are susceptible to mining.\nU.A.E.\nTankers t... [1678 chars]",
            "url": "https://www.nytimes.com/interactive/2026/03/13/world/middleeast/iran-mines-strait-hormuz.html",
            "image": "https://static01.nyt.com/images/2026/03/13/multimedia/2026-03-11-iran-mines-index/2026-03-11-iran-mines-index-facebookJumbo-v3.jpg",
            "publishedAt": "2026-03-13T08:45:30Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories