Flag of the 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": 197664,
    "articles": [
        {
            "title": "Ukrainian Drones Target Moscow",
            "description": "The mayor of the Russian capital called the attack the war’s largest against the city. It appeared to be a reminder of Ukraine’s power to strike as its president proposes an air truce.",
            "content": "Russian officials said Ukraine attacked Moscow before dawn on Tuesday with its largest long-range drone bombardment of the war, as both sides stepped up attacks ahead of talks intended to end three years of fighting.\nMoscow’s mayor, Sergei Sobyanin, ... [731 chars]",
            "url": "https://www.nytimes.com/2025/03/11/world/europe/ukraine-russia-moscow-war-drones.html",
            "image": "https://static01.nyt.com/images/2025/03/11/multimedia/11int-ukraine-strikes-bkph/11int-ukraine-strikes-bkph-facebookJumbo.jpg",
            "publishedAt": "2025-03-11T08:58:22Z",
            "source": {
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "title": "Who is Mahmoud Khalil? A look at the Columbia University protestor detained by ICE",
            "description": "Mahmoud Khalil, a 29-year-old legal resident of the United States, was arrested and detained by federal agents Sunday, after his green card was revoked by the Trump administration.",
            "content": "CNN —\nPresident Donald Trump has likened Mahmoud Khalil to a terrorist sympathizer. Others portray him as a Palestinian activist, singled out for his outspoken support for his own people.\nBut long before he was arrested by federal agents Saturday nig... [7212 chars]",
            "url": "https://www.cnn.com/2025/03/11/us/mahmoud-khalil-columbia-ice-green-card-hnk/index.html",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/ap25069542691613.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2025-03-11T08:03:00Z",
            "source": {
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "title": "Moscow region hit by 'massive' drone attack, Russian officials say",
            "description": "At least one person is killed, Russian officials say, in what appears to be the largest attack on Moscow of the war.",
            "content": "Largest drone attack of war hits Moscow region, Russian officials say\n56 minutes ago Share Save Jaroslav Lukiv & Rachel Hagan BBC News Share Save\nWatch: At the scene of drone attack on Moscow\nAt least two people have been killed and three injured in ... [1880 chars]",
            "url": "https://www.bbc.com/news/articles/ce8y655p52do",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/4ebd/live/bffb5b00-fe4e-11ef-b50e-9d086302645f.jpg",
            "publishedAt": "2025-03-11T08:00:37Z",
            "source": {
                "name": "BBC.com",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Categories