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": 385724,
    "articles": [
        {
            "id": "9e2064964a56bdb00ed8e2f6c9476a0f",
            "title": "Kenan Thompson Sued By Landlord Over Breach of Lease",
            "description": "Kenan Thompson is being dragged to court by a landlord, who claims he owes over $34,000 for breaking his lease on a rental home.",
            "content": "UPDATE\n7:32 PM PT -- Sources close to Kenan tell TMZ ... this was a contractual disagreement and not about him choosing to not pay rent. Our sources tell us Kenan never received the keys to the property and had never even stepped foot on the property... [1195 chars]",
            "url": "https://www.tmz.com/2026/01/28/kenan-thompson-sued-breach-of-lease/",
            "image": "https://imagez.tmz.com/image/fe/16by9/2026/01/29/fe90d08c9d234417b2b6e6a5a174d96a_xl.jpg",
            "publishedAt": "2026-01-29T02:30:00Z",
            "lang": "en",
            "source": {
                "id": "3539b82bbf6242ee8b4c1fbed4ea5ec7",
                "name": "TMZ",
                "url": "https://www.tmz.com"
            }
        },
        {
            "id": "9dad7c2c397cf66751660b2b08f73b96",
            "title": "Judge Orders Release of Minnesota Refugees Targeted in ICE Crackdown",
            "description": "A federal judge granted a temporary restraining order, which halts a Trump administration operation that has swept up at least 100 people so far.",
            "content": "A federal judge on Wednesday evening ordered federal agents to stop detaining and deporting refugees in Minnesota who were lawfully admitted to the United States, and to immediately release those currently held for re-examination of their cases.\nThe ... [1268 chars]",
            "url": "https://www.nytimes.com/2026/01/28/us/politics/minnesota-refugees-ice-crackdown.html",
            "image": "https://static01.nyt.com/images/2026/01/28/multimedia/28dc-refugees-fvgt/28dc-refugees-fvgt-facebookJumbo.jpg",
            "publishedAt": "2026-01-29T02:10:43Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "798c3b738466243d78d203c608b2dc81",
            "title": "Live updates: CNN hosts town hall with Minneapolis community leaders, including Mayor Frey",
            "description": "CNN is hosting a Minneapolis town hall with officials and community leaders, including Mayor Jacob Frey. Follow for live news updates.",
            "content": "Federal immigration authorities frequently tout their efforts to capture “the worst of the worst.” But in the span of just a few weeks, photos and videos of four people in Minnesota have changed the way many Americans see the administration’s crackdo... [16777 chars]",
            "url": "https://www.cnn.com/us/live-news/minneapolis-ice-trump-01-28-26",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2258420554.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-01-29T00:33:00Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        }
    ]
}

Categories