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": 53683,
    "articles": [
        {
            "title": "Macron Cabinet Survives No-Confidence Vote: France Live Updates",
            "description": "The bill to increase the national retirement age to 64 from 62 now becomes law, but opponents vowed to continue their fight amid widespread fury against President Emmanuel Macron.",
            "content": "President Emmanuel Macron’s government was facing a crucial no-confidence vote in France’s lower house of Parliament on Monday after his government forced a pension overhaul through without a vote, incensing labor unions, sparking violent protests an... [7579 chars]",
            "url": "https://www.nytimes.com/live/2023/03/20/world/france-macron-no-confidence-vote",
            "image": "https://static01.nyt.com/images/2023/03/20/multimedia/20france-blog-promo-12pm-ckmq/20france-blog-promo-12pm-ckmq-facebookJumbo.jpg",
            "publishedAt": "2023-03-20T17:48:45Z",
            "source": {
                "name": "The New York Times",
                "url": "https://www.nytimes.com"
            }
        },
        {
            "title": "South Korea ditches 69-hour workweek plan after youth revolt",
            "description": "South Korea has backed off a plan to lengthen the workweek to 69 hours after a near-revolt by the country's young people.",
            "content": "South Korea has backed off a plan to lengthen the workweek to 69 hours after a near-revolt by the country’s young people.\nFive years ago, South Korea cut the number of hours that its labor-obsessed people were allowed to work to 52 in total — a regul... [2575 chars]",
            "url": "https://nypost.com/2023/03/20/south-korea-ditches-69-hour-workweek-plan-after-youth-revolt/",
            "image": "https://nypost.com/wp-content/uploads/sites/2/2023/03/NYPICHPDPICT000008534227.jpg?quality=75&strip=all&w=1024",
            "publishedAt": "2023-03-20T16:59:00Z",
            "source": {
                "name": "New York Post ",
                "url": "https://nypost.com"
            }
        },
        {
            "title": "Republicans tried to delay release of US hostages to sabotage Carter, ex-aide claims - report",
            "description": "Former Texas governor urged Middle Eastern leaders to convince Iran not to release hostages before 1980 election",
            "content": "A former Texas governor met Middle Eastern leaders in 1980 to convince Iran to delay releasing American hostages as part of a Republican effort to sabotage Jimmy Carter’s re-election campaign, according to a news report.\nThe New York Times reported o... [3192 chars]",
            "url": "https://www.theguardian.com/us-news/2023/mar/20/jimmy-carter-republican-sabotage-iran-hostage-john-connally",
            "image": "https://i.guim.co.uk/img/media/0e7530f34e9878182aef245fcc786d53c1ae9bcc/0_346_3000_1800/master/3000.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=ecf6a74f4acc91dbab82486a1df9f723",
            "publishedAt": "2023-03-20T15:31:00Z",
            "source": {
                "name": "The Guardian US",
                "url": "https://www.theguardian.com"
            }
        }
    ]
}

Categories