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": 413186,
    "articles": [
        {
            "id": "210a4cb3d259c54b18600ea38af4f312",
            "title": "British Police Arrest Former Prince Andrew Amid Scrutiny Over Epstein Ties",
            "description": "Andrew Mountbatten-Windsor, a longtime associate of Jeffrey Epstein, is being investigated on suspicion of misconduct in public office.",
            "content": "Andrew Mountbatten-Windsor, once regarded as a dashing war hero and the favorite son of Queen Elizabeth II, was arrested by the British police on Thursday amid widening scrutiny over his ties to the disgraced financier Jeffrey Epstein.\nMr. Mountbatte... [1563 chars]",
            "url": "https://www.nytimes.com/2026/02/19/world/europe/prince-andrew-arrest-epstein.html",
            "image": "https://static01.nyt.com/images/2026/02/19/multimedia/19int-andrew-ledeall01-gtwk/19int-andrew-ledeall01-gtwk-facebookJumbo.jpg",
            "publishedAt": "2026-02-20T07:36:00Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "371393fc830a8362b184ce29c9c6dcb8",
            "title": "Eric Dane, McSteamy on ‘Grey’s Anatomy,’ Dies at 53",
            "description": "His breakout role came in 2006 as the handsome Dr. Mark Sloan, nicknamed McSteamy, the head of plastic surgery at a Seattle hospital. He died 10 months after announcing his A.L.S. diagnosis.",
            "content": "Eric Dane, the actor best known as the charming plastic surgeon nicknamed McSteamy on the wildly successful ABC medical drama “Grey’s Anatomy,” has died. He was 53.\nHis death was confirmed by his publicist Melissa Bank. He had been treated for A.L.S.... [1598 chars]",
            "url": "https://www.nytimes.com/2026/02/19/arts/eric-dane-mcsteamy-dead.html",
            "image": "https://static01.nyt.com/images/2025/09/30/multimedia/00xp-eric-dane-jvbk/00xp-eric-dane-jvbk-facebookJumbo.jpg",
            "publishedAt": "2026-02-20T06:28:08Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "130c26066a5de8ff9bcf785db14896f9",
            "title": "Gable Steveson dominates Hugo Lezama for yet another early finish at Mexico Fight League 3",
            "description": "MMA's top heavyweight prospect kicked off 2026 by picking up right where he left off in 2025.",
            "content": "Gable Steveson kicked off 2026 by picking up right where he left off in 2025. Widely considered to be the No. 1 prospect in heavyweight MMA, Steveson dominated Hugo Lezama en route to another first-round stoppage victory Thursday in the main event of... [3609 chars]",
            "url": "https://sports.yahoo.com/mma/breaking-news/article/gable-steveson-dominates-hugo-lezama-for-yet-another-early-knockout-at-mexico-fight-league-3-230018468.html",
            "image": "https://s.yimg.com/ny/api/res/1.2/IcV58kvn4gdKKO1mZ8q85g--/YXBwaWQ9aGlnaGxhbmRlcjt3PTEyMDA7aD04MDA7Y2Y9d2VicA--/https://s.yimg.com/os/creatr-uploaded-images/2026-02/ce7bd9d0-0d1a-11f1-bdf7-9b844558e035",
            "publishedAt": "2026-02-20T05:39:15Z",
            "lang": "en",
            "source": {
                "id": "1213ab3f5e360256b89d3b205e3e8e48",
                "name": "Yahoo Sports",
                "url": "https://sports.yahoo.com"
            }
        }
    ]
}

Categories