Flag of United States

United States World News API

Get the live top world headlines from United States with our JSON API.

Get API key for the United States World 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=world&apikey=API_KEY
{
    "totalArticles": 201292,
    "articles": [
        {
            "id": "5d38e5403083f5a1bb22f8dea13dd997",
            "title": "ABC de España denuncia presión legal en su contra por parte del \"nuevo chavismo\"",
            "description": "El diario español ABC ha denunciado una escalada de presión por parte del entorno del régimen venezolano, en lo que se ha denominado como el accionar del \"nuevo chavismo\"",
            "content": "El diario español ABC ha denunciado una escalada de presión por parte del entorno del régimen venezolano, en lo que se ha denominado como el accionar del \"nuevo chavismo\" tras la detención de Nicolás Maduro por parte de fuerzas estadounidenses a prin... [2818 chars]",
            "url": "https://www.elnacional.com/2026/01/abc-de-espana-denuncia-presion-legal-en-su-contra-por-parte-del-nuevo-chavismo/",
            "image": "https://elnacional-uploads.nyc3.digitaloceanspaces.com/wp-content/uploads/2026/01/17202230/delcy-rodriguez-4.jpg",
            "publishedAt": "2026-01-24T17:01:29Z",
            "lang": "es",
            "source": {
                "id": "22d1e067add8b55a3825ac5cfebbd088",
                "name": "El Nacional",
                "url": "https://www.elnacional.com"
            }
        },
        {
            "id": "f9fdc95a9454efd727d8c521a466019d",
            "title": "Pope Leo warns of ‘overly affectionate’ AI chatbots",
            "description": "Beware of the AI chatbot that becomes more than just a friend, or worse, an emotional crutch. Pope Leo XIV has warned about overly “affectionate” chatbots, urging regulation to prevent humans from forming serious emotional bonds with their AI companions.",
            "content": "Beware of the AI chatbot that becomes more than just a friend, or worse, an emotional crutch. Pope Leo XIV has warned about overly “affectionate” chatbots, urging regulation to prevent humans from forming serious emotional bonds with their AI compani... [2527 chars]",
            "url": "https://www.cnn.com/2026/01/24/europe/pope-leo-ai-chatbots-warning-intl",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2252143922.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-01-24T16:26:40Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "237331670bea448378cfc31d4926f27d",
            "title": "¿Por qué el régimen de los ayatolás en Irán no termina de caer?",
            "description": "Irán experimenta cada vez con más frecuencia multitudinarias protestas que piden el fin de la República Islámica.",
            "content": "Irán experimenta cada vez con más frecuencia multitudinarias protestas que piden el fin de la República Islámica. El pasado mes de diciembre, concretamente el día 28, los comerciantes del Gran Bazar de Teherán –normalmente afines a las autoridades– c... [4455 chars]",
            "url": "https://www.elnacional.com/2026/01/por-que-el-regimen-de-los-ayatolas-en-iran-no-termina-de-caer/",
            "image": "https://elnacional-uploads.nyc3.digitaloceanspaces.com/wp-content/uploads/2026/01/24114708/ayatolas-1.jpg",
            "publishedAt": "2026-01-24T15:56:27Z",
            "lang": "es",
            "source": {
                "id": "22d1e067add8b55a3825ac5cfebbd088",
                "name": "El Nacional",
                "url": "https://www.elnacional.com"
            }
        }
    ]
}

Categories