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": 519588,
    "articles": [
        {
            "id": "88ad94fc2a0b5572765e31af4b6fe531",
            "title": "Elon Musk v. Sam Altman trial Day 3",
            "description": "Elon Musk sued OpenAI, Sam Altman and Greg Brockman in 2024, claiming they reneged on their promise to keep the artificial intelligence lab a nonprofit.",
            "content": "watch now\nWhat you need to know\nElon Musk said he had concerns about the nonprofit being \"stolen\" in 2018.\nMusk said Microsoft's $10 billion investment in the nonprofit was a tipping point and he lost trust in Sam Altman by late 2022.\nMusk said he \"w... [13569 chars]",
            "url": "https://www.cnbc.com/2026/04/29/musk-altman-live-updates-day-3-open-ai-trial.html",
            "image": "https://image.cnbcfm.com/api/v1/image/108299329-17774844982026-04-29t174052z_1503926160_rc21zka40miz_rtrmadp_0_musk-openai-court.jpeg?v=1777484582&w=1920&h=1080",
            "publishedAt": "2026-04-29T18:12:00Z",
            "lang": "en",
            "source": {
                "id": "32c2ad3fb41cb87b5b847d750028dff0",
                "name": "CNBC",
                "url": "https://www.cnbc.com"
            }
        },
        {
            "id": "45702c089f1bd88cbc0421be5402d684",
            "title": "OpenAI Trial Live Updates: Elon Musk's Testimony Continues in Legal Standoff With Sam Altman",
            "description": "Elon Musk, who split from OpenAI years after cofounding it as a nonprofit, said in his second day of testimony that its other founders duped him, turning it into a major commercial entity.",
            "content": "“I was a fool who provided them free funding to create a start-up,” he said. “I gave them 38 million dollars of essentially free funding to create what would become an $800 billion company.”\nMr. Musk left the start-up three years later after a power ... [6112 chars]",
            "url": "https://www.nytimes.com/live/2026/04/29/technology/openai-trial-sam-altman-elon-musk",
            "image": "https://static01.nyt.com/images/2026/04/29/multimedia/29open-ai-update-bhkq/29open-ai-update-bhkq-facebookJumbo.jpg",
            "publishedAt": "2026-04-29T17:46:44Z",
            "lang": "en",
            "source": {
                "id": "2f580dc49292a1caf59cd86dd3c9e60b",
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "id": "fae850e1ae3abbbf4fe673c4cba5d658",
            "title": "Comey surrenders over charge of threatening Trump's life in Instagram post",
            "description": "Prosecutors say a 2025 seashell photo posted by the former FBI director was a call for violence against Trump.",
            "content": "Former FBI Director James Comey surrendered to authorities on Wednesday to face a charge alleging that an image he briefly shared on social media posed a threat to the life of President Donald Trump.\nIt stems from an Instagram post shared by Comey, w... [2436 chars]",
            "url": "https://www.bbc.com/news/articles/c70vzj1nrddo",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/31bf/live/5e13d260-43f2-11f1-9113-1988573e8ff7.jpg",
            "publishedAt": "2026-04-29T17:32:01Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Categories