
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 APIAPI 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": 3323548, "articles": [ { "id": "f3f6a5d25a421de1adcacd005115bdd0", "title": "India casts doubt on Trump’s claims that it has agreed to stop buying Russian oil", "description": "The US president claimed Modi had assured him of deal, but Indian officials insist no such conversation took place", "content": "India has cast doubt on claims by Donald Trump that its prime minister, Narendra Modi, had agreed to stop buying Russian oil.\nOn Wednesday, Trump claimed that Modi had assured him “today” that India would put an end to its purchase of Russian oil.\n“I... [2252 chars]", "url": "https://www.theguardian.com/world/2025/oct/16/india-casts-doubt-on-trumps-claims-that-it-has-agreed-to-stop-buying-russian-oil", "image": "https://i.guim.co.uk/img/media/6075b72a217452981d2ada9b594c8c259d7bd149/530_0_5281_4228/master/5281.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=748a9a4be65d8d364b5a894b69db2520", "publishedAt": "2025-10-16T21:42:00Z", "lang": "en", "source": { "id": "558a003a7a0164e924408edec7e99f99", "name": "The Guardian", "url": "https://www.theguardian.com", "country": "us" } }, { "id": "49a0899ea7c7cf628db0451c60ffb432", "title": "Trump says he will meet Putin again after 'great progress' during call", "description": "The call comes a day before Ukrainian President Volodymyr Zelensky visits the White House.", "content": "US President Donald Trump says \"great progress\" was made during a phone call with Russian President Vladimir Putin on Thursday, with the pair agreeing to face-to-face talks in Hungary.\nHe said the call, the first with Putin since mid-August, was \"ver... [4076 chars]", "url": "https://www.bbc.com/news/articles/crmxz37nv3zo", "image": "https://ichef.bbci.co.uk/news/1024/branded_news/06e7/live/eab30620-aabc-11f0-b2a1-6f537f66f9aa.jpg", "publishedAt": "2025-10-16T20:42:04Z", "lang": "en", "source": { "id": "f331a5ed3965fb59761dfcecfc7e7a34", "name": "BBC", "url": "https://www.bbc.com", "country": "us" } }, { "id": "792decdd3cd7ef7e4b4c7e86e0ec867f", "title": "Maccabi Tel Aviv fans not allowed to attend Aston Villa game in Europa League", "description": "When Maccabi Tel Aviv travelled to face Ajax last year, 62 people were arrested and five hospitalised after violent clashes.", "content": "Supporters of Israeli club Maccabi Tel Aviv will not be allowed to attend the Europa League game against Aston Villa in Birmingham on November 6 due to “a number of physical and safety factors”.\nEarlier on Thursday, sources briefed on the matter had ... [4985 chars]", "url": "https://www.nytimes.com/athletic/6722327/2025/10/16/aston-villa-maccabi-tel-aviv-uefa/", "image": "https://static01.nyt.com/athletic/uploads/wp/2025/10/16065854/GettyImages-2182720232-scaled-e1760613067469.jpg?width=1200&height=630&fit=cover", "publishedAt": "2025-10-16T18:04:11Z", "lang": "en", "source": { "id": "2f580dc49292a1caf59cd86dd3c9e60b", "name": "The New York Times", "url": "https://www.nytimes.com", "country": "us" } } ] }