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": 382920,
    "articles": [
        {
            "id": "999ec0881842917ddf5ba88bcaf97284",
            "title": "No. 1 Arizona holds off BYU comeback to stay unbeaten",
            "description": "Brayden Burries poured in 29 points, five rebounds, four assists and three steals, and Jaden Bradley scored 26 with three assists and two steals as No. 1 Arizona remained unbeaten.",
            "content": "PROVO — Big Monday was on the verge of becoming Arizona's big blowout Monday night at the Marriott Center.\nThen it was almost the Big Comeback.\nIn the end, Arizona was breathing a big sigh of relief.\nBrayden Burries poured in a career-high 29 points,... [3583 chars]",
            "url": "https://www.ksl.com/article/51438776/no-1-arizona-holds-off-byu-comeback-to-stay-unbeaten",
            "image": "https://img.ksl.com/slc/3142/314217/31421751.jpeg?filter=kslv2/responsive_story_lg",
            "publishedAt": "2026-01-27T09:00:00Z",
            "lang": "en",
            "source": {
                "id": "6486035d1c6580e0b37c6e3b271d2d50",
                "name": "KSL.com",
                "url": "https://www.ksl.com"
            }
        },
        {
            "id": "8aef554c88ee77463125cbc6b70b0212",
            "title": "India and European Union have closed a 'landmark' free trade deal, Prime Minister Modi says",
            "description": "Goods traded between India and the EU in 2024 amounted to over 120 billion euros (about $140 billion), making it New Delhi's largest trading partner.",
            "content": "India and the European Union on Monday closed a \"landmark\" free trade agreement, touted as the 'mother of all deals,' Indian Prime Minister Narendra Modi said during a speech at the India Energy Week on Tuesday.\nThe FTA with the EU, which represents ... [3212 chars]",
            "url": "https://www.cnbc.com/2026/01/27/india-eu-trade-deal-trump-tariffs.html",
            "image": "https://image.cnbcfm.com/api/v1/image/108256077-1769130512349-gettyimages-2201750008-AFP_36YV72E.jpeg?v=1769130529&w=1920&h=1080",
            "publishedAt": "2026-01-27T05:45:30Z",
            "lang": "en",
            "source": {
                "id": "32c2ad3fb41cb87b5b847d750028dff0",
                "name": "CNBC",
                "url": "https://www.cnbc.com"
            }
        },
        {
            "id": "ea32eebd72f404aa7f799eab3522524d",
            "title": "3 takeaways from BYU’s dramatic loss to No. 1 Arizona",
            "description": "BYU couldn’t complete a wild comeback effort Monday night, falling 86-83 to No. 1 Arizona.",
            "content": "Heartbreak at the Marriott Center.\nBYU couldn’t complete a wild comeback effort Monday night, falling 86-83 to No. 1 Arizona.\nThe Cougars, who suffered their first loss in Provo since February of 2025, are now 17-3 on the season and 5-2 in Big 12 pla... [3750 chars]",
            "url": "https://www.deseret.com/sports/2026/01/26/byu-cougars-fall-against-arizona-wildcats-marriott-center-2026-3-takeaways/",
            "image": "https://www.deseret.com/resizer/v2/U3IUOBK4UFAI7FGH52YPZGVMO4.JPG?focal=0%2C0&auth=1538d20118043ee7bd6ed6920bb472fc44e277e364af44a851deefc22fa36e96&width=630",
            "publishedAt": "2026-01-27T05:09:00Z",
            "lang": "en",
            "source": {
                "id": "2bde5457fc5efcf659e4e07f8842f6f7",
                "name": "deseret.com",
                "url": "https://www.deseret.com"
            }
        }
    ]
}

Categories