Flag of United States

United States News API

Get the live top headlines from United States with our JSON API.

Get API key for the United States 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=general&apikey=API_KEY
{
    "totalArticles": 423062,
    "articles": [
        {
            "id": "461b0acc46cbb514c71bf6272cec6ecc",
            "title": "Live updates: Trump warns of more US casualties in war with Iran, Hezbollah joins conflict",
            "description": "There could be more US casualties as part of the military operations against Iran, President Donald Trump acknowledged Sunday. Three American troops have been killed so far, according to the US military. Follow for live updates.",
            "content": "As hostilities in the Middle East intensify, escalating attacks have triggered widespread travel paralysis, leaving nations scrambling to devise evacuation strategies for stranded citizens.\nDubai International Airport, one of the world’s busiest, was... [10181 chars]",
            "url": "https://www.cnn.com/world/live-news/us-israel-iran-attack-03-01-26-intl",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/1-20260301092855135.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-03-02T03:26:00Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "e1d107c856d2c30804d7a29360a5dec3",
            "title": "Iran’s retaliatory strikes in the Middle East in photos and video",
            "description": "Iran intensified its strikes against countries in the Persian Gulf and Israel on Sunday, attacking at least nine countries since the start of the joint U.S.-Israeli attack.",
            "content": "Iran intensified its retaliatory strikes against American allies in the Persian Gulf and Israel on Sunday, attacking sites in at least nine countries since the start of the joint U.S.-Israeli attack.\nWithin 36 hours, the regime had hit every member o... [287 chars]",
            "url": "https://www.washingtonpost.com/investigations/2026/03/01/where-iran-strikes-middle-east-images-video/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://cloudfront-us-east-1.images.arcpublishing.com/wapo/AKEB3SHV4N5DGARXO4XLIB62BE.JPG&w=1440",
            "publishedAt": "2026-03-02T02:58:57Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        },
        {
            "id": "7188c55b38b06b45a7b27bb7a7bfcf06",
            "title": "Welcome To March: Ohio State pulls it together for 82-74 upset of No. 8 Purdue",
            "description": "John Mobley Jr. had 21 points and Bruce Thornton scored 20 for Ohio State in an 82-74 win over No. 8 Purdue.",
            "content": "The calendar just switched to March and, lo and behold, there may be some Madness in Ohio State's future after all.\nThe Buckeyes snapped a two-game losing streak and nailed down an enduring Quad 1 victory with its hard fought 82-74 win over No. 8 Pur... [6860 chars]",
            "url": "https://247sports.com/college/ohio-state/longformarticle/ohio-state-buckeyes-mens-basketball-knocks-off-purdue-boilermakers-276055167/",
            "image": "https://s3media.247sports.com/Uploads/Assets/701/632/13632701.JPG?width=1200&height=628&crop=1.91:1&fit=cover",
            "publishedAt": "2026-03-02T02:27:55Z",
            "lang": "en",
            "source": {
                "id": "510f5cd043c2fc5a79c650d27f721aef",
                "name": "247Sports",
                "url": "https://247sports.com"
            }
        }
    ]
}

Categories