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": 550552,
    "articles": [
        {
            "id": "2320e5cb8c963513310e0d3bc7babee4",
            "title": "Apple Memorial Day sales are here: We found sweet deals on MacBooks, AirPods, iPads and more",
            "description": "We're digging up the best deals on Apple devices we can find from this year's crop of Memorial Day sales.",
            "content": "Apple's entry-level AirPods remain a good buy for iPhone owners who don't need active noise cancellation and hate the feeling of earbuds that jut all the way into their ear canal. They still sound more pleasant than most open-style earbuds you can bu... [5476 chars]",
            "url": "https://tech.yahoo.com/deals/breaking-news/article/apple-memorial-day-sales-are-here-we-found-sweet-deals-on-macbooks-airpods-ipads-and-more-134656841.html",
            "image": "https://s.yimg.com/lo/mysterio/api/726864c024ee8cf7821f5b2477f6904669ddf69232129921f4f5e0484c66ccf0/lightyear_networkapi/resizefill_w1200;quality_80;format_webp/https:%2F%2Fd29szjachogqwa.cloudfront.net%2Fimages%2Fuser-uploaded%2Fapple-memorial-day-sales_3295.png",
            "publishedAt": "2026-05-25T18:25:00Z",
            "lang": "en",
            "source": {
                "id": "714a98fc9d03fbcb80a1f7a89e443342",
                "name": "Yahoo Tech",
                "url": "https://tech.yahoo.com"
            }
        },
        {
            "id": "2ad68c145b8367700cd0007c32f88e2c",
            "title": "Russia threatens more Kyiv strikes and tells foreign nationals to leave",
            "description": "It comes after the Ukrainian capital suffered one of the biggest aerial assaults of the war overnight on Saturday.",
            "content": "Russia has threatened to launch a fresh wave of \"systematic strikes\" against Kyiv, days after carrying out one of its largest attacks on the Ukrainian capital since the start of the war.\nThe new strikes will target \"decision-making centres and comman... [2467 chars]",
            "url": "https://www.bbc.com/news/articles/c1e22n55zn4o",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/e77a/live/157edd60-585b-11f1-9a33-c313bd26e03f.jpg",
            "publishedAt": "2026-05-25T17:42:26Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "ba9b862dc95292351e19fbcd398d078a",
            "title": "Iran War Live Updates: Top Iranian Negotiators Arrive in Qatar for Talks on Peace Deal",
            "description": "President Trump gave conflicting signals over how much progress had been made in the talks. Both the United States and Iran suggested that a breakthrough was not imminent.",
            "content": "Nor was the timing certain. Mr. Trump vowed on Monday that either the deal would be “great and meaningful” or “there will be no deal,” after saying that his negotiators were in no rush to close the agreement.\nHe also called on countries like Qatar an... [28144 chars]",
            "url": "https://www.nytimes.com/live/2026/05/25/world/iran-war-trump",
            "image": "https://static01.nyt.com/images/2026/05/25/multimedia/-25mideast-promo-0945EST/25mideast-header--glfc-facebookJumbo.jpg",
            "publishedAt": "2026-05-25T17:01:41Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        }
    ]
}

Categories