Flag of the 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": 6304436,
    "articles": [
        {
            "title": "Peru celebrates Pope Leo XIV as one of their own",
            "description": "Robert Prevost is a source of pride for many Peruvians, who say he represents their country.",
            "content": "'God loves Peru': Country celebrates new Pope as one of their own\n3 hours ago Share Save Guillermo D Olmo • @BBCgolmo BBC News Mundo Helen Sullivan BBC News Share Save\nReuters People celebrate at the Cathedral of Saint Mary in Chiclayo, Peru with a b... [5157 chars]",
            "url": "https://www.bbc.com/news/articles/cewdl4e57v7o",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/8092/live/1993e140-2c90-11f0-8683-9b1503cf649e.jpg",
            "publishedAt": "2025-05-09T04:46:58Z",
            "source": {
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "title": "Pakistan claims China-made jets in India clash, boy given wine: SCMP’s 7 highlights",
            "description": "From Pakistan claiming Chinese-made J-10Cs in India clash to a Cathay Pacific oversight, here are highlights from SCMP’s recent reporting.",
            "content": "We have selected seven stories from this week’s news across Hong Kong, mainland China, the wider Asia region and beyond that resonated with our readers and shed light on topical issues. If you would like to see more of our reporting, please consider ... [746 chars]",
            "url": "https://www.scmp.com/news/world/article/3309640/pakistan-claims-china-made-jets-india-clash-boy-given-wine-scmps-7-highlights",
            "image": "https://cdn.i-scmp.com/sites/default/files/styles/og_image_scmp_generic/public/d8/images/canvas/2025/05/09/91c88e55-2a07-4809-a0d7-5c440a9e8820_c60cdde9.jpg?itok=50cof9_z&v=1746765789",
            "publishedAt": "2025-05-09T04:12:07Z",
            "source": {
                "name": "South China Morning Post",
                "url": "https://www.scmp.com"
            }
        },
        {
            "title": "China’s He Lifeng: Xi Jinping’s ally leading trade talks with US",
            "description": "Vice-premier with close links to leader seen as ‘more difficult interlocutor’ for Washington",
            "content": "Roula Khalaf, Editor of the FT, selects her favourite stories in this weekly newsletter.\nIn Donald Trump’s first term, US trade negotiators encountered a familiar interlocutor in China: Liu He, a Harvard-educated, English-speaking adviser to Xi Jinpi... [5417 chars]",
            "url": "https://www.ft.com/content/30688480-58a1-4eeb-8c38-a4d62336f309",
            "image": "https://www.ft.com/__origami/service/image/v2/images/raw/https%3A%2F%2Fd1e00ek4ebabms.cloudfront.net%2Fproduction%2F8e2f76aa-b426-433c-aad4-10dca1039e9e.jpg?source=next-article&fit=scale-down&quality=highest&width=700&dpr=1",
            "publishedAt": "2025-05-09T04:05:20Z",
            "source": {
                "name": "Financial Times",
                "url": "https://www.ft.com"
            }
        }
    ]
}

Categories