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": 208504,
    "articles": [
        {
            "id": "ddd7c710cd8b06261fcd65ca37c36458",
            "title": "NATO to Hold Military Exercise Without U.S., Its Largest Member",
            "description": "The operation, Steadfast Dart, comes as President Trump has been accused of undermining the alliance and will be watched closely to see how well the allies manage without their most important partner.",
            "content": "At a Spanish port 50 miles northwest of Gibraltar, four Turkish Navy ships, including a brand-new amphibious assault ship that doubles as an aircraft carrier, were set to arrive Friday to take part in NATO military exercises.\nHeavy winds had delayed ... [1569 chars]",
            "url": "https://www.nytimes.com/2026/01/29/world/europe/nato-military-exercise-spain-germany.html",
            "image": "https://static01.nyt.com/images/2026/01/29/multimedia/29int-germany-nato-gpcl/29int-germany-nato-gpcl-facebookJumbo.jpg",
            "publishedAt": "2026-01-29T21:54:01Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "7a0c0d892439999be6b1ee9d2606c699",
            "title": "Iran warns of ‘hazardous consequences’ after EU designates Revolutionary Guard as a terrorist organization",
            "description": "Iran threatened Thursday to unleash “hazardous consequences” after the European Union formally designated the Islamic Revolutionary Guard Corps (IRGC) as a terrorist organization, amid escalating tensions between Tehran and Western powers.",
            "content": "Iran threatened Thursday to unleash “hazardous consequences” after the European Union formally designated the Islamic Revolutionary Guard Corps (IRGC) as a terrorist organization, amid escalating tensions between Tehran and Western powers.\nEU foreign... [5048 chars]",
            "url": "https://www.cnn.com/2026/01/29/middleeast/iran-warns-eu-designate-irgc-terrorist-organization-intl-latam",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2256522701.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-01-29T21:15:23Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "41b065baf14c86f9174713e1092a119e",
            "title": "Israel returns 15 Palestinian bodies to Gaza",
            "description": "A Gaza Health Ministry official says Israel has turned over the bodies of 15 Palestinians just days after recovering the remains of the last Israeli hostage.",
            "content": "DEIR AL-BALAH, Gaza Strip (AP) — Israel turned over the bodies of 15 Palestinians on Thursday, just days after recovering the remains of the last Israeli hostage, a Gaza Health Ministry official said.\nIt marks the last hostage-detainee exchange betwe... [3874 chars]",
            "url": "https://apnews.com/article/israel-hamas-hostages-ceasefire-d7976d765e233c89368f14fdf76b376c",
            "image": "https://dims.apnews.com/dims4/default/5d20166/2147483647/strip/true/crop/8640x5757+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fc2%2F13%2Fa4ec45ffc1cc32a2bb94b43d7d7a%2Ff9b4463ab55947688db996f59f120eed",
            "publishedAt": "2026-01-29T21:01:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        }
    ]
}

Categories