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": 433576,
    "articles": [
        {
            "id": "67ae96c4766150582c11ef5c56c4ffdb",
            "title": "NASA Unveils 1st Earth Photos From Artemis II Moon Mission: ‘You Look Beautiful.’",
            "description": "The pictures were released on the third day of the first mission since 1972 to send people around the moon.",
            "content": "The astronauts of Artemis II were 107,243 miles from Earth at the time this article was updated.\nAs the Artemis II astronauts fly farther from Earth, they’re taking the opportunity to look back home.\nOn Friday morning, NASA shared a partial view of o... [1431 chars]",
            "url": "https://www.nytimes.com/2026/04/03/science/nasa-artemis-moon-photos.html",
            "image": "https://static01.nyt.com/images/2026/04/03/multimedia/03HS-moon-daily-promo/03HS-moon-daily-promo-facebookJumbo.jpg",
            "publishedAt": "2026-04-03T18:59:16Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "nytimes.com",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "0ef56b9acb809d12417db4208588e7cb",
            "title": "Strong Jobs Numbers Make the Fed’s Job Easier",
            "description": "Robust job growth in March suggests that the labor market remains relatively healthy, allowing officials at the central bank to focus on fighting inflation.",
            "content": "The latest jobs numbers are likely to make the Federal Reserve’s job easier, at least for now.\nFor most of last year, the Fed has found itself in wait-and-see mode as it has assessed the economic fallout from the sweeping policy changes imposed by Pr... [1652 chars]",
            "url": "https://www.nytimes.com/2026/04/03/business/economy/jobs-unemployment-inflation-fed-rates.html",
            "image": "https://static01.nyt.com/images/2026/04/03/multimedia/03biz-jobs-fed-mptl/03biz-jobs-fed-mptl-facebookJumbo.jpg",
            "publishedAt": "2026-04-03T18:03:28Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "e14eadb39b131f04ed6bb16c179dacb4",
            "title": "UFC Vegas 115 weigh-in results: Undefeated bantamweight misses for 3rd time",
            "description": "The UFC Vegas 115 official weigh-ins featured two fighters coming in heavy for Saturday’s show.",
            "content": "The UFC Vegas 115 official weigh-ins got messy at the end, with a familiar face involved.\nAt the close of the first weigh-in window, three of the last four fighters to step to the scale missed weight for Saturday’s event at Meta Apex. Abdul Rakhman Y... [2247 chars]",
            "url": "https://www.mmafighting.com/ufc/480210/ufc-vegas-115-weigh-in-results-undefeated-bantamweight-misses-for-3rd-time",
            "image": "https://platform.mmafighting.com/wp-content/uploads/sites/109/2026/04/gettyimages-2269682245.jpg?quality=90&strip=all&crop=0%2C7.3924768108493%2C100%2C78.539472696188&w=1200",
            "publishedAt": "2026-04-03T18:00:50Z",
            "lang": "en",
            "source": {
                "id": "50619ed61a9c377689926fae945c9257",
                "name": "MMA Fighting",
                "url": "https://www.mmafighting.com"
            }
        }
    ]
}

Categories