Flag of United States

United States Nation News API

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

Get API key for the United States Nation 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=nation&apikey=API_KEY
{
    "totalArticles": 4704608,
    "articles": [
        {
            "id": "00428f4f35e580745b9b9b156e5612fe",
            "title": "Off-duty DC firefighter was shot and dialed 911. After minutes with no response, he took matters into his own hands",
            "description": "Under dim Capitol Hill streetlights on September 20, Gary Dziekan headed down 8th Street Northeast dressed in lederhosen, walking home from the Oktoberfest party he co-hosted five blocks away. Dziekan, who goes by “Zeek,” crossed at the intersection with C Street, zeroing in on the short iron gate separating a colorful row of two-story homes from the quiet Washington, DC, street.",
            "content": "Under dim Capitol Hill streetlights on September 20, Gary Dziekan headed down 8th Street Northeast dressed in lederhosen, walking home from the Oktoberfest party he co-hosted five blocks away. Dziekan, who goes by “Zeek,” crossed at the intersection ... [9773 chars]",
            "url": "https://www.cnn.com/2025/09/28/us/dc-911-firefighter-shooting",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/still-21975532-15644-667-still.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2025-09-28T09:30:51Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com",
                "country": "us"
            }
        },
        {
            "id": "12bc4bb23db667b94bb65b2c24c868ce",
            "title": "Portland, Oregon, is affirming its sanctuary city identity as Trump pledges to send in troops",
            "description": "A day after President Donald Trump’s second inauguration, the mayor of Portland, Oregon, knew that a “sanctuary city” like his was going to have a bumpy four years ahead.",
            "content": "A day after President Donald Trump’s second inauguration, the mayor of Portland, Oregon, knew that a “sanctuary city” like his was going to have a bumpy four years ahead.\n“We must come together to live our city’s shared values of freedom from fear an... [10567 chars]",
            "url": "https://www.cnn.com/2025/09/28/us/portland-ice-antifa-trump-wwk",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/sipausa-62273384.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2025-09-28T09:00:51Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com",
                "country": "us"
            }
        },
        {
            "id": "65421781f7b839fb0000b5e7e8bbe1f5",
            "title": "Russell M. Nelson, oldest-ever president of The Church of Jesus Christ of Latter-day Saints, dies",
            "description": "Russell M. Nelson, the oldest-ever president of The Church of Jesus Christ of Latter-day Saints, has died at the age of 101.",
            "content": "SALT LAKE CITY (AP) — Russell M. Nelson, the oldest-ever president of The Church of Jesus Christ of Latter-day Saints, died Saturday night at the age of 101, church officials announced.\nNelson died at his home in Salt Lake City, church spokesperson C... [5417 chars]",
            "url": "https://apnews.com/article/mormon-president-russell-m-nelson-obituary-d23fed7544364adf8453613fa761981d",
            "image": "https://dims.apnews.com/dims4/default/7c7f447/2147483647/strip/true/crop/5400x3038+0+263/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fa3%2Fb2%2F169b5adc616c3dd230523acd6790%2F1631bc3f2ec64ea8bf85f6cfcfc1784b",
            "publishedAt": "2025-09-28T07:08:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com",
                "country": "us"
            }
        }
    ]
}

Categories