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": 402196,
    "articles": [
        {
            "id": "fd3d2c96b437c5160fa8b0e5ddf9f340",
            "title": "US-Israel war on Iran live updates: Netanyahu says war will take ‘some time’; IDF issues evacuation warnings in Lebanon",
            "description": "Israeli PM adds that it will not be an ‘endless war’; Israeli military lists dozens of locations in Lebanon that could be targeted – follow the latest news",
            "content": "Further to the last post, travellers stranded by the widening war in the Middle East began departing the United Arab Emirates aboard a small number of evacuation flights on Monday, while governments around the world work to extract their citizens fro... [5484 chars]",
            "url": "https://www.theguardian.com/world/live/2026/mar/03/us-israel-war-iran-live-updates-attacks-strikes-trump-netanyahu-lebanon-middle-east-latest-news",
            "image": "https://i.guim.co.uk/img/media/9ca0dc7fae733b62b84a15ff9a379a7f0d1ce58a/475_0_4696_3757/master/4696.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctbGl2ZS5wbmc&enable=upscale&s=977adfea53575c2e964b9ff9f884ff85",
            "publishedAt": "2026-03-03T05:18:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "0865d94cac0fbd3dc6b719cb46d4e6e4",
            "title": "Death toll rises to 3 in Austin mass shooting on West 6th Street",
            "description": "Federal and local officials continue to investigate the mass shooting on Austin's West Sixth Street that left four people dead and 14 injured Sunday morning.",
            "content": "Local and federal officials continue to investigate a mass shooting that left four people dead — including the shooter — and 13 others injured in the area surrounding Buford’s, a bar in Austin’s popular West Sixth Street entertainment district, early... [22961 chars]",
            "url": "https://www.statesman.com/news/article/bufords-austin-6th-street-shooting-live-updates-21949513.php",
            "image": "https://s.hdnux.com/photos/01/63/43/61/30293091/5/rawImage.jpg",
            "publishedAt": "2026-03-03T03:45:16Z",
            "lang": "en",
            "source": {
                "id": "2baebf2efec2c61d01912c4ca7a8a5de",
                "name": "Austin American-Statesman",
                "url": "https://www.statesman.com"
            }
        },
        {
            "id": "bbf3bc4b1282b13671fe474e76ee52d2",
            "title": "Threat from Iran conflict spreads across Middle East in 72 hours",
            "description": "In less than three days, the conflict ricocheted beyond the original targets in Iran, Israel and Iraq to threaten some 300 million civilians across more than a dozen nations.",
            "content": "In less than three days, the conflict ricocheted beyond the original targets in Iran, Israel and Iraq to threaten some 300 million civilians across more than a dozen nations.\nUpdated\nMarch 2, 2026 at 3:49 p.m. ESTyesterday at 3:49 p.m. EST\nBEIT SHEME... [442 chars]",
            "url": "https://www.washingtonpost.com/world/2026/03/02/mideast-iran-israel-war-civilians/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://arc-anglerfish-washpost-prod-washpost.s3.amazonaws.com/public/YWPHXRR4WWNNBSQOQFBSAZPUXY_size-normalized.JPG&w=1440",
            "publishedAt": "2026-03-03T03:26:53Z",
            "lang": "en",
            "source": {
                "id": "aa250375ed4d1652ad2c07377b69f537",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        }
    ]
}

Categories