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": 530784,
    "articles": [
        {
            "id": "c324dd4c4882160214393842bd1a3dee",
            "title": "Evacuation orders issued in California city over chemical tank: 'It fails or it blows up'",
            "description": "Officials said Friday there is no active gas leak or plume, but that the tank is \"actively in crisis\" and is unable to be \"secured.\"",
            "content": "In what is being called an \"unprecedented\" situation, tens of thousands of people in Southern California were told to leave their homes Friday, with officials issuing a dire warning that a chemical tank at an aerospace facility is in \"crisis\" and wil... [4047 chars]",
            "url": "https://abcnews.com/US/evacuation-orders-issued-california-city-chemical-tank-fails/story?id=133234846",
            "image": "https://i.abcnewsfe.com/a/0c782de0-c00d-4962-bd59-bd0810e03212/CALIFORNIA-CHEMICAL-GARDENGROVE_1779500275947_hpMain_16x9.jpg?w=1600",
            "publishedAt": "2026-05-23T06:20:04Z",
            "lang": "en",
            "source": {
                "id": "d35e5701ba890c345f47dc0dd5522375",
                "name": "ABC News - Breaking News, Latest News and Videos",
                "url": "https://abcnews.com"
            }
        },
        {
            "id": "306fee981a76a4daa7e9ade53f04db8a",
            "title": "Xi Calls for All-Out Rescue After Coal Mine Explosion Kills at Least 90 in China",
            "description": "The death count rose drastically on Saturday as the Chinese leader, Xi Jinping, called for an investigation and emphasized the need to “hold those responsible to account.”",
            "content": "China’s top leader, Xi Jinping, called on Saturday for a redoubled rescue mission in northern China after a gas explosion in a mine there killed at least 90 people, the Chinese state news agency said, in what appeared to be one of the deadliest Chine... [2683 chars]",
            "url": "https://www.nytimes.com/2026/05/23/world/asia/xi-coal-mine-explosion-rescue.html",
            "image": "https://static01.nyt.com/images/2026/05/23/multimedia/23int-china-mine-fjkw/23int-china-mine-fjkw-facebookJumbo.jpg",
            "publishedAt": "2026-05-23T05:24:07Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "75e70bea88878ca44577887d0449e591",
            "title": "At least 82 dead in Chinese coal mine explosion, state media reports",
            "description": "The explosion took place at 19:29 local time on Friday at a coal mine in northern China.",
            "content": "At least 82 people have been killed in a coal mine blast in northern China with nine people still missing, the country's state media has reported.\n\"Reporters learned from the scene of the gas explosion at the Liushenyu Coal Mine of the Tongzhou Group... [1080 chars]",
            "url": "https://www.bbc.com/news/articles/c5y0ve18qlko",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/42bc/live/26de5e00-566c-11f1-b6cc-4175dfd9c219.jpg",
            "publishedAt": "2026-05-23T05:19:01Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Categories