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": 421308,
    "articles": [
        {
            "id": "72336aedeb3c81e6f3a2c41b4004cd1b",
            "title": "World Baseball Classic news, live updates: Mexico faces U.S.; South Korea, Dominican Republic, Venezuela reach quarterfinals",
            "description": "Follow along with the latest news and updates from the 2026 World Baseball Classic.",
            "content": "The 2026 World Baseball Classic gets one of its marquee games on Monday when the United States takes on rival Mexico. Both teams are 2-0 in Pool B.\nIn the first WBC game on Monday, South Korea beat Australia 7-2 to reach the quarterfinals from Pool C... [1420 chars]",
            "url": "https://sports.yahoo.com/mlb/live/world-baseball-classic-news-live-updates-mexico-faces-us-south-korea-dominican-republic-venezuela-reach-quarterfinals-145506041.html",
            "image": "https://s.yimg.com/ny/api/res/1.2/wtpHpeyVJrCmrkH6hte1fw--/YXBwaWQ9aGlnaGxhbmRlcjt3PTEyMDA7aD04MDA7Y2Y9d2VicA--/https://d29szjachogqwa.cloudfront.net/images/2026-03/c066a7f5-2871-466e-9669-b38a8e1068fe",
            "publishedAt": "2026-03-10T01:26:20Z",
            "lang": "en",
            "source": {
                "id": "1213ab3f5e360256b89d3b205e3e8e48",
                "name": "Yahoo Sports",
                "url": "https://sports.yahoo.com"
            }
        },
        {
            "id": "fbdb5193461262813bde7b3251457b1c",
            "title": "Hilary Duff on Haylie Duff, Parents Estrangements",
            "description": "Hilary Duff detailed her difficult relationship with her parents as well as her sister Haylie Duff, admitting that her family strain has taken a significant emotional toll.",
            "content": "Bobby (pictured second from left) addressed rumors of a falling out with Tan (middle) in January 2024, two months after he announced his exit from Queer Eye after eight seasons.\n\"I want people to know that Tan and I—we will be fine,\" he told Vanity F... [7230 chars]",
            "url": "https://www.eonline.com/news/1429496/hilary-duff-on-haylie-duff-parents-estrangements",
            "image": "https://akns-images.eonline.com/eol_images/Entire_Site/20260309/1c975693-d1c8-4b86-ae78-6c5b5e4fa06c_1773092461.jpg?fit=around%7C1080:1080&output-quality=90&crop=1080:1080;center,top",
            "publishedAt": "2026-03-10T00:35:40Z",
            "lang": "en",
            "source": {
                "id": "7b6e0f1f22b17d1d6dcf578c3dd216a3",
                "name": "E! Online",
                "url": "https://www.eonline.com"
            }
        },
        {
            "id": "e1bcd1903b8b97cdd3c6fbe0d6ed6580",
            "title": "Iran’s Women’s Soccer Team Offered Asylum by President Trump",
            "description": "The dissonance between the president’s hard-line immigration policies and his offer of asylum to the athletes was striking. Australia took in five players.",
            "content": "President Trump, who closed down the U.S. asylum system at the start of his second term, made an unusual offer on Monday.\nHe said the 26-member Iranian women’s soccer team could come to the United States as refugees if Australia refused to take them ... [1468 chars]",
            "url": "https://www.nytimes.com/2026/03/09/us/politics/iran-womens-soccer-team-asylum-trump.html",
            "image": "https://static01.nyt.com/images/2026/03/09/multimedia/09dc-trump-asylum-zmcv/09dc-trump-asylum-zmcv-facebookJumbo.jpg",
            "publishedAt": "2026-03-09T23:59:21Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories