Flag of the 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": 7150878,
    "articles": [
        {
            "title": "115+ best Prime Day deals LIVE: The best sales still available on Apple, Kindles, TVs and more",
            "description": "There's only two days left to shop epic Prime Day deals",
            "content": "Refresh\nSoothe sore muscles for less (Image credit: Bob and Brad) I just bought this small but mighty massage gun for my parents — mind, I paid closer to full price — and they’ve been nothing short of obsessed. Offering five speeds, a long-lasting in... [10080 chars]",
            "url": "https://www.tomsguide.com/live/news/prime-day-2025-best-deals-live-apparel-tvs-apple-yeti",
            "image": "https://cdn.mos.cms.futurecdn.net/ssSgpQEP5Vmp99XACp4GxX.jpg",
            "publishedAt": "2025-07-11T03:24:01Z",
            "source": {
                "name": "Tom's Guide",
                "url": "https://www.tomsguide.com"
            }
        },
        {
            "title": "Cooper Flagg wins Summer League debut despite uneven showing",
            "description": "Cooper Flagg made his professional debut Thursday night in the NBA Summer League and celebrated an 87-85 win over Bronny James and the Lakers.",
            "content": "Cooper Flagg goes 5-of-21 from the field and puts up 10 points, 6 rebounds and 4 assists in his summer league debut for the Mavericks. (1:23)\nOpen Extended Reactions\nLAS VEGAS -- Cooper Flagg made his professional debut Thursday night in the NBA summ... [3435 chars]",
            "url": "https://www.espn.com/nba/story/_/id/45713427/cooper-flagg-wins-summer-league-debut-uneven-showing",
            "image": "https://a1.espncdn.com/combiner/i?img=%2Fphoto%2F2025%2F0711%2Fr1517527_1296x729_16%2D9.jpg",
            "publishedAt": "2025-07-11T02:25:00Z",
            "source": {
                "name": "ESPN",
                "url": "https://www.espn.com"
            }
        },
        {
            "title": "Trump threatens 35% tariffs on Canadian goods",
            "description": "Trump also threatened blanket tariffs of 15% or 20% on most trade partners, and said he will soon announce new tariffs on the EU.",
            "content": "Trump threatens 35% tariffs on Canadian goods\nThe letter to Canada is among more than 20 that Trump had posted this week to US trade partners.\nThe US has already imposed a blanket 25% tariff on some Canadian goods, and the country is feeling the pain... [3509 chars]",
            "url": "https://www.bbc.com/news/articles/cvg819n954mo",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/c392/live/d7a4dfd0-5df6-11f0-870f-597d22515ef1.jpg",
            "publishedAt": "2025-07-11T02:20:18Z",
            "source": {
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}                        

Categories