Flag of the 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": 78770,
    "articles": [
        {
            "title": "Italy’s famous ‘Path of Love’ reopens after more than 12 years",
            "description": "One of the most iconic and romantic trails in the world — Italy’s Via dell’Amore (“Path of Love”) – will reopen Saturday, July 27, after a lengthy refurbishment and an overall investment of more than $24 million, the Italian Tourism Ministry announced Friday.",
            "content": "CNN —\nOne of the most iconic and romantic trails in the world — Italy’s Via dell’Amore (“Path of Love”) – will reopen Saturday, July 27, after a lengthy refurbishment and an overall investment of more than $24 million, the Italian Tourism Ministry an... [3031 chars]",
            "url": "https://www.cnn.com/travel/italy-cinque-terre-path-of-love-reopens/index.html",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/c-gettyimages-2162885262.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2024-07-27T00:01:00Z",
            "source": {
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "title": "Why French authorities fear Russia may attempt to disrupt Paris Olympics",
            "description": "Just hours before the Olympic opening ceremony, saboteurs launched a coordinated arson attack on French train lines. It stranded nearly a million travelers and sparked even more concerns about potential threats to the games which are being protected by unprecedented security. Nick Schifrin discussed more with Javed Ali.",
            "content": "Nick Schifrin:\nIn Paris train stations this morning, crowds in confusion after coordinated attacks on France's high-speed rail lines.\nThe overnight sabotage severed signaling cables that controlled the northbound, westbound and eastbound lines. A fou... [345 chars]",
            "url": "https://www.pbs.org/newshour/show/why-french-authorities-fear-russia-may-attempt-to-disrupt-paris-olympics",
            "image": "https://d3i6fh83elv35t.cloudfront.net/static/2024/07/olympics-1024x683.jpg",
            "publishedAt": "2024-07-26T22:55:29Z",
            "source": {
                "name": "PBS NewsHour",
                "url": "https://www.pbs.org"
            }
        },
        {
            "title": "Gaza: US physicians pen letter to Biden and Harris",
            "description": "A group of 45 American doctors and nurses describe bloodshed in Gaza in an open letter to the White House, and demand immediate ceasefire.",
            "content": "CNN —\nA group of 45 American physicians and nurses who volunteered in hospitals across Gaza have sent an open letter to US President Joe Biden and Vice President Kamala Harris sharing their experiences and demanding an immediate ceasefire and arms em... [7605 chars]",
            "url": "https://edition.cnn.com/2024/07/26/world/open-letter-45-us-physicians-gaza/index.html",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/c-gettyimages-2156163946.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2024-07-26T18:29:00Z",
            "source": {
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        }
    ]
}

Categories