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": 409688,
    "articles": [
        {
            "id": "62b60af467e1fb356b765df77502b444",
            "title": "Authorities say NYC explosives suspects claimed Islamic State sympathies",
            "description": "A court complaint says two men who brought explosives to a protest outside New York City’s mayoral mansion said they were inspired by the Islamic State extremist group.",
            "content": "NEW YORK (AP) — Two men who brought explosives to a protest outside New York City’s mayoral mansion said they were inspired by the Islamic State extremist group, a court complaint said.\nEmir Balat and Ibrahim Kayumi were being held without bail after... [5336 chars]",
            "url": "https://apnews.com/article/explosives-protest-mamdani-434928cf6fa8771bc3dfa5c260ee7b03",
            "image": "https://dims.apnews.com/dims4/default/158184d/2147483647/strip/true/crop/5770x3845+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F13%2F13%2F4183d0ccdee29fbcd76dd65b9e93%2Fb1747d77ab264f2faf64b2430c2cef81",
            "publishedAt": "2026-03-09T18:08:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "52dcd1c59fa5a51f80cad2e37df1ffa3",
            "title": "Oil prices rise and markets dip as Iran digs in with new leader",
            "description": "Oil prices roared upward and stock markets fell further after Iran fired more drones and missiles across the Persian Gulf and beyond in response to U.S. and Israeli airstrikes, after defiantly choosing hard-line Ayatollah Mojtaba Khamenei to succeed his late father as Iran's supreme leader.",
            "content": "DUBAI, United Arab Emirates (AP) — Oil prices surged and stock markets slid Monday after hard-line Ayatollah Mojtaba Khamenei was chosen to succeed his late father as Iran’s supreme leader. His appointment, and new strikes on regional oil infrastruct... [6839 chars]",
            "url": "https://apnews.com/article/iran-israel-us-march-9-2026-b2aa51ef51d4b57103ffee0c95bc2ff7",
            "image": "https://dims.apnews.com/dims4/default/55e8690/2147483647/strip/true/crop/6000x3998+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F26%2Fa7%2F388ba1dc5823399341b10f7b3b7c%2Febc593fc001c4b95b8c990db9071d8cf",
            "publishedAt": "2026-03-09T17:37:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "3d780ed53ae0477566037a2649957ea1",
            "title": "Source: Super Bowl MVP Kenneth Walker agrees to sign with Chiefs",
            "description": "Super Bowl MVP Kenneth Walker III has agreed to sign with the Kansas City Chiefs, a source told ESPN's Adam Schefter.",
            "content": "Super Bowl MVP Kenneth Walker III has agreed to sign with the Kansas City Chiefs, a source told ESPN's Adam Schefter.\nWalker is receiving a three-year deal with a $43.05 million base value and $28.7 million fully guaranteed, sources told ESPN's Brady... [3395 chars]",
            "url": "https://www.espn.com/nfl/story/_/id/48153654/source-super-bowl-mvp-kenneth-walker-agrees-sign-chiefs",
            "image": "https://a1.espncdn.com/combiner/i?img=%2Fphoto%2F2026%2F0122%2Fr1604271_1296x729_16%2D9.jpg",
            "publishedAt": "2026-03-09T17:28:00Z",
            "lang": "en",
            "source": {
                "id": "0207e330d5d787ce8251900411dd488d",
                "name": "ESPN",
                "url": "https://www.espn.com"
            }
        }
    ]
}

Categories