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": 525690,
    "articles": [
        {
            "id": "637ea713c233c53ec04762d243863adb",
            "title": "Cameron Diaz and Benji Madden welcome third child",
            "description": "Hollywood star Cameron Diaz and her musician husband Benji Madden have annouced the birth of their third child, a boy named Nautas.",
            "content": "Hollywood star Cameron Diaz and her musician husband Benji Madden have annouced the birth of their third child, a boy named Nautas.\n“Cameron and I are Happy, Excited, and feeling so BLESSED to announce the birth of our third Child, Nautas Madden. Wel... [1550 chars]",
            "url": "https://www.cnn.com/2026/05/04/entertainment/cameron-diaz-benji-madden-third-child-scli-intl",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2235306000.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-05-04T11:53:58Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "1c8e6f4a33864478b8e0ddaa230c1710",
            "title": "Rubio to Visit Rome, Vatican Says, After Trump’s Feud With Pope and Meloni",
            "description": "Secretary of State Marco Rubio’s trip will come after President Trump criticized Pope Leo XIV and then turned on Prime Minister Giorgia Meloni of Italy for defending the pontiff.",
            "content": "Secretary of State Marco Rubio will meet with Pope Leo XIV on Thursday, according to the Vatican, in a trip that will take place amid tensions between Washington, Rome and the Vatican.\nMr. Rubio will also meet separately with Antonio Tajani, the Ital... [2339 chars]",
            "url": "https://www.nytimes.com/2026/05/04/world/europe/rubio-rome-trump-pope-italy.html",
            "image": "https://static01.nyt.com/images/2026/05/04/multimedia/04int-vatican-rubio-ptcq/04int-vatican-rubio-ptcq-facebookJumbo.jpg",
            "publishedAt": "2026-05-04T11:46:21Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "fda3604239ed542375c55ac48167debe",
            "title": "Shooting at lake near Oklahoma City leaves at least 13 injured, police and hospital officials say",
            "description": "At least 13 people were at hospitals following a shooting at a party at Arcadia Lake, near Oklahoma City, police say.",
            "content": "Edmund, Oklahoma — A shooting Sunday night at a party at a lake near Oklahoma City sent at least 13 people to hospitals, according to police and hospital officials.\nAuthorities received reports of shots being fired at about 9 p.m. at a gathering of y... [1788 chars]",
            "url": "https://www.cbsnews.com/news/shooting-at-lake-near-oklahoma-city-leaves-at-least-10-wounded/",
            "image": "https://assets3.cbsnewsstatic.com/hub/i/r/2026/05/04/eddefd93-9929-4555-b2c8-3b6874aa47c8/thumbnail/1200x630/26f16cd1c8ec161f1fd456345d5b3e0f/ap26124165390903-1.jpg",
            "publishedAt": "2026-05-04T11:19:00Z",
            "lang": "en",
            "source": {
                "id": "f2f2ed82d991515dcc85d86a1374a9ae",
                "name": "CBS News",
                "url": "https://www.cbsnews.com"
            }
        }
    ]
}

Categories