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": 551106,
    "articles": [
        {
            "id": "a66d386e7bcf74870e8cc19c720a8648",
            "title": "Interim US-Iran agreement appears to take shape",
            "description": "A deal would extend the ceasefire and reopen the Strait of Hormuz, a source says, but Iran has yet to confirm despite President Donald Trump saying it may be signed soon. Follow here for live updates.",
            "content": "A signing ceremony for a memo of understanding with Iran would most likely be held in Geneva, Switzerland, three sources told CNN on Friday.\nThat comes after US President Donald Trump on Thursday touted a “great settlement” that could resolve the war... [11917 chars]",
            "url": "https://www.cnn.com/2026/06/12/world/live-news/iran-war-trump-israel",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/2026-06-11t193149z-113917332-rc2vrlaxbhrs-rtrmadp-3-usa-trump-20260611203208608.JPG?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-06-12T09:14:00Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "a789588e0143582f5a88567aed1d919f",
            "title": "World Cup Recap: Mexico reminds everyone why we love soccer but hydration breaks spark uproar",
            "description": "The co-hosts' opening day win sparked an explosion of joy - can the U.S. and Canada match them today?",
            "content": "The 2026 World Cup began Thursday with eruptions of joy in Mexico City.\nAt long last — after days, weeks, months, years of controversy over ticket prices, funding, visas and more — the grandest soccer tournament in human history started with pageantr... [7298 chars]",
            "url": "https://www.nytimes.com/athletic/7353586/2026/06/12/world-cup-mexico-win-hydration-breaks/",
            "image": "https://static01.nyt.com/athletic/uploads/wp/2026/06/12014720/GettyImages-2280463266-scaled.jpg?width=1200&height=630&fit=cover",
            "publishedAt": "2026-06-12T07:16:15Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "404481fe4d38ad9b9524625a66e3f20a",
            "title": "Kennedy Center board seeks pause of ruling ordering removal of Trump's name",
            "description": "President Trump's board at the Kennedy Center is mounting a last-minute effort to keep his name on the facade of the performing arts facility before a court-ordered deadline to remove it by Friday.",
            "content": "WASHINGTON — President Donald Trump's handpicked board at the Kennedy Center is mounting a last-minute effort to keep his name on the facade of the iconic performing arts facility before a court-ordered deadline to remove it by Friday.\nThe board vote... [3164 chars]",
            "url": "https://www.npr.org/2026/06/12/g-s1-127700/kennedy-center-trumps-name",
            "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/7988x4493+0+416/resize/1400/quality/85/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F46%2Fc8%2F7133d97d43c7be003bea2d24b173%2Fap26157582104467.jpg",
            "publishedAt": "2026-06-12T05:43:34Z",
            "lang": "en",
            "source": {
                "id": "0978beb86628acb239ee06cf0b116d2c",
                "name": "NPR",
                "url": "https://www.npr.org"
            }
        }
    ]
}

Categories