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": 411842,
    "articles": [
        {
            "id": "bdf9b724fac9cd5317001a1fcc2a33dd",
            "title": "Missing Oklahoma boy found safe after mom, stepfather arrested on suspicion of child abuse",
            "description": "A 12-year-old Oklahoma boy whose disappearance prompted a massive search has been found safe.",
            "content": "A 12-year-old Oklahoma boy whose disappearance prompted a massive search has been found safe just days after his mother and stepfather were arrested on suspicion of child abuse, authorities said.\n\"After days of searching, after hope and prayer, we ca... [1922 chars]",
            "url": "https://abcnews.go.com/US/missing-oklahoma-boy-found-safe-after-mom-stepfather/story?id=129108940",
            "image": "https://i.abcnewsfe.com/a/96a9961f-e89a-4202-801f-421c321dfee0/mugshots-parents-ht-jt-260109_1767982601916_hpMain_16x9.jpg?w=1600",
            "publishedAt": "2026-01-12T16:00:24Z",
            "lang": "en",
            "source": {
                "id": "5ca536331c246cd7f693cdb2cceaff8c",
                "name": "ABC News",
                "url": "https://abcnews.go.com"
            }
        },
        {
            "id": "e7d35b77ed137039206be392fa671706",
            "title": "Two low-cost airlines are merging in $1.5 billion deal",
            "description": "The merger between two budget carriers is the first major airline deal of 2026.",
            "content": "In a first of such deals since the start of the year, Las Vegas-based Allegiant Air announced plans to purchase rival Sun Country Airlines for $1.5 billion and form a single low-cost airline.\nThe deal includes both cash and stock and takes on approxi... [3055 chars]",
            "url": "https://www.thestreet.com/travel/two-low-cost-airlines-are-merging-in-1-5-billion-deal",
            "image": "https://www.thestreet.com/.image/w_1200,h_630,g_auto,c_fill/NDA6MDAwMDAwMDAyNzU1Mzk0/blue-and-white-passenger-plane-on-airport-during-daytime-stockpack-unsplash.jpg",
            "publishedAt": "2026-01-12T15:44:17Z",
            "lang": "en",
            "source": {
                "id": "6194c08bbdf9b4ce58c3e3557fa2c159",
                "name": "thestreet.com",
                "url": "https://www.thestreet.com"
            }
        },
        {
            "id": "6cda4e260a4959f02cce191e06f6e7f8",
            "title": "Iran ‘prepared’ for war but open to US talks as hundreds reported killed in protests",
            "description": "Iran says it is ready to negotiate with the US after President Donald Trump said Tehran had called his administration to negotiate. Follow for live updates",
            "content": "The European Parliament will ban all Iranian diplomatic staff and representatives from its premises amid widespread anti-regime protests in Iran, according to the assembly’s president Roberta Metsola.\nMetsola said the parliament, which is the Europea... [18444 chars]",
            "url": "https://www.cnn.com/world/live-news/iran-protests-01-12-26",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/ap26011338635181.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-01-12T14:32:00Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        }
    ]
}

Categories