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": 567732,
    "articles": [
        {
            "id": "47f9843327ff740d7fbb58882ee28381",
            "title": "Iran-US war latest: Trump warns ‘I’ll do what I have to do’ if Tehran breaks agreement as US waives sanctions on oil",
            "description": "Iran will be able to export oil in US dollars for the first time in decades",
            "content": "Swipe for next article\nLiveupdated\nIran-US war latest: Trump warns ‘I’ll do what I have to do’ if Tehran breaks agreement as US waives sanctions on oil\nIran will be able to export oil in US dollars for the first time in decades\nPresident Donald Trump... [8203 chars]",
            "url": "https://www.independent.co.uk/news/world/middle-east/iran-us-war-live-trump-vance-strait-of-hormuz-israel-b3000928.html",
            "image": "https://static.independent.co.uk/2026/06/23/02/2282299237..?trim=0,0,0,0&width=1200&height=800&crop=1200:800",
            "publishedAt": "2026-06-23T06:31:33Z",
            "lang": "en",
            "source": {
                "id": "0d5c0adfb0e84da759fe48296b9f6e55",
                "name": "The Independent",
                "url": "https://www.independent.co.uk"
            }
        },
        {
            "id": "6133e29669d0f7509e6ff2f49b542cbf",
            "title": "With Starfall, SpaceX eyes an edge in global cargo delivery from orbit",
            "description": "The purpose of Starfall is to support the \"transport and delivery of goods through space.\"",
            "content": "A SpaceX Falcon 9 rocket is set to launch Tuesday to test a new reentry vehicle designed to deliver cargo anywhere in the world from low-Earth orbit.\nThe company developed the new saucer-shaped reentry pod, called Starfall, under a veil of secrecy. I... [3857 chars]",
            "url": "https://arstechnica.com/space/2026/06/with-starfall-spacex-eyes-an-edge-in-global-cargo-delivery-from-orbit/",
            "image": "https://cdn.arstechnica.net/wp-content/uploads/2026/06/starfallillustration2-1152x609.jpg",
            "publishedAt": "2026-06-23T05:25:35Z",
            "lang": "en",
            "source": {
                "id": "344add8dabb753d03641ce9f246787ad",
                "name": "Ars Technica",
                "url": "https://arstechnica.com"
            }
        },
        {
            "id": "91567a2ade4d8c868d8f00876a877830",
            "title": "Giannis Antetokounmpo traded to Heat in blockbuster deal that spells the end of an era for Bucks",
            "description": "The trade of Giannis Antetokounmpo marks a bitter end to one of the best eras in Bucks history.",
            "content": "Giannis Antetokounmpo is being traded from the Milwaukee Bucks to the Miami Heat in a blockbuster deal that finally ends the perennial All-Star forward's turbulent relationship with the franchise he led to the 2021 NBA championship.\nThe Bucks are als... [5602 chars]",
            "url": "https://sports.yahoo.com/nba/breaking-news/article/giannis-antetokounmpo-traded-to-heat-in-blockbuster-deal-that-spells-the-end-of-an-era-for-bucks-035417099.html",
            "image": "https://s.yimg.com/ny/api/res/1.2/vwlWnsyAKBj_JsnYT0VmHQ--/YXBwaWQ9aGlnaGxhbmRlcjt3PTEyMDA7aD04MDA7Y2Y9d2VicA--/https://d29szjachogqwa.cloudfront.net/images/2026-06/9de80446-2ca5-40ce-b89a-48b2f64aab93",
            "publishedAt": "2026-06-23T05:14:00Z",
            "lang": "en",
            "source": {
                "id": "1213ab3f5e360256b89d3b205e3e8e48",
                "name": "Yahoo Sports",
                "url": "https://sports.yahoo.com"
            }
        }
    ]
}

Categories