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": 405740,
    "articles": [
        {
            "id": "00d138f6288da93978b075d9708819d4",
            "title": "US military used laser to take down Border Protection drone, lawmakers say",
            "description": "Members of Congress say the U.S. military used a laser to shoot down a Customs and Border Protection drone.",
            "content": "The U.S. military used a laser Thursday to shoot down a “seemingly threatening” drone flying near the U.S.-Mexico border. It turned out the drone belonged to Customs and Border Protection, lawmakers said.\nThe case of mistaken identity prompted the Fe... [4800 chars]",
            "url": "https://apnews.com/article/military-laser-border-drone-texas-airport-55aaab7093f7d6dd174f909f3875001c",
            "image": "https://dims.apnews.com/dims4/default/ec2f005/2147483647/strip/true/crop/4032x2687+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F30%2Fe4%2Faf6f0a321d98dcb655f5c362f5cd%2F1521c4230c8248c1ba74b1685842f7e7",
            "publishedAt": "2026-02-27T06:08:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "87941561d4ae1896af9bf9e0d18bd452",
            "title": "U.S. and Iran wrap round of talks as Trump weighs diplomacy against strikes",
            "description": "The latest round of talks unfolded against the backdrop of the largest U.S. military buildup in the Middle East since the 2003 Iraq invasion.",
            "content": "The sides made “significant progress” and agreed to meet next week, said the foreign minister of Oman, which is mediating the negotiations in Geneva.\nFebruary 26, 2026 at 5:21 p.m. ESTYesterday at 5:21 p.m. EST\nU.S. and Iranian officials completed a ... [278 chars]",
            "url": "https://www.washingtonpost.com/world/2026/02/26/iran-nuclear-talks-trump-strikes-geneva-oman/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://arc-anglerfish-washpost-prod-washpost.s3.amazonaws.com/public/3Y3WO5WY56WNA4522CEOSV2L3U_size-normalized.jpg&w=1440",
            "publishedAt": "2026-02-27T06:00:32Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        },
        {
            "id": "26cc2efe438d72051354c5d9d4142cac",
            "title": "China removes nine military officials ahead of key political meeting",
            "description": "No official reason for the removal was given, but it comes ahead of the country's key Two Sessions meeting.",
            "content": "China has removed 19 officials, including nine from the military, from its list of lawmakers ahead of its biggest annual political meeting next week.\nNo official reason for the removal has been given, but it comes just weeks after President Xi Jinpin... [1820 chars]",
            "url": "https://www.bbc.com/news/articles/c6270z0dr6no",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/68e7/live/2331aec0-1386-11f1-93b0-b93a7c0c5701.jpg",
            "publishedAt": "2026-02-27T04:29:01Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Categories