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": 241816,
    "articles": [
        {
            "id": "7e2a3310062432c3c80969bd15dbb110",
            "title": "Live Updates: Trump touts US action as CENTCOM says troops are working to destroy Iranian Navy",
            "description": "Operation Epic Fury enters a seventh day Friday as new video released by CENTCOM shows Iranian targets are being “decimated” by U.S. forces, who continue mission to “sink the entire Iranian Navy.”",
            "content": "Breaking News4 hours ago\nPinned\nIDF says Iran launches missiles toward Israel as air defenses activate\nThe Israel Defense Forces said Friday that missiles were launched from Iran toward Israeli territory as the conflict between the two countries cont... [48479 chars]",
            "url": "https://www.foxnews.com/live-news/us-iran-israel-war-latest-march-6",
            "image": "https://assets.foxnews.com/liveblog/fn/prod/images/2026/03/79f2e605a950d4e17add18d5bbc62315.jpg",
            "publishedAt": "2026-03-07T06:46:02Z",
            "lang": "en",
            "source": {
                "id": "a8408ad388422503ac33101396026891",
                "name": "Fox News",
                "url": "https://www.foxnews.com"
            }
        },
        {
            "id": "91b456e1148f2c29565607cd623932fd",
            "title": "Russia gave Iran information that could help strikes on US military",
            "description": "Russia has provided Iran with information that could help Tehran strike American warships, aircraft and other assets in the region.",
            "content": "WASHINGTON (AP) — Russia has provided Iran with information that could help Tehran strike American warships, aircraft and other assets in the region, according to two officials familiar with U.S. intelligence on the matter.\nThe officials, who were no... [4815 chars]",
            "url": "https://apnews.com/article/trump-iran-russia-intelligence-35afae34198408d670941f971d383378",
            "image": "https://dims.apnews.com/dims4/default/9d1119f/2147483647/strip/true/crop/4918x3277+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F36%2Faf%2Fd45e93579e92b9fd442b51d654e6%2Fa6bbbca2b9a143d49b81c28b7504f0db",
            "publishedAt": "2026-03-07T05:03:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "f5ed7a5ad381804e7daabbe82ea67327",
            "title": "El petróleo, la losa que aplasta a Cuba y da alas a Trump",
            "description": "La falta de combustible paraliza la economía, mientras Estados Unidos incentiva al sector privado de la isla",
            "content": "Nadie sabe quién fue, porque sucedió en medio del apagón, y si algo tiene el apagón es que el vecino podrías ser tú mismo, igualando a todos bajo un terrible manto negro. Lo cierto es que alguien en el barrio de Poey, La Habana, prendió fuego un post... [15437 chars]",
            "url": "https://elpais.com/us/2026-03-07/el-petroleo-la-losa-que-aplasta-a-cuba-y-da-alas-a-trump.html",
            "image": "https://imagenes.elpais.com/resizer/v2/RHLD4R64LZO6JH25FPY4FGW564.jpg?auth=52b7866ab5314e44601b13408eb0ec8b004af13c49f66cc2941d8a28487557c4&width=1200",
            "publishedAt": "2026-03-07T04:30:00Z",
            "lang": "es",
            "source": {
                "id": "eb1bfc7349a10fd1bd06d9ecfaa8b438",
                "name": "EL PAÍS",
                "url": "https://elpais.com"
            }
        }
    ]
}

Categories