
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": 3525694, "articles": [ { "title": "Submarine USS Connecticut Severely Damaged In Pacific Crash To Return To Service In 2026", "description": "Getting USS Connecticut, one of just three prized Seawolf class submarines, back to the fleet has been an important priority for the Navy.", "content": "The TWZ Newsletter Weekly insights and analysis on the latest developments in military technology, strategy, and foreign policy. Email address Sign Up Thank you! Terms of Service and Privacy Policy\nThe USS Connecticut, one of the U.S. Navy’s prized S... [6823 chars]", "url": "https://www.twz.com/sea/submarine-uss-connecticut-severely-damaged-in-pacific-crash-to-return-to-service-in-2026", "image": "https://www.twz.com/wp-content/uploads/2025/07/USS-Connecticut-repairs-1.jpg", "publishedAt": "2025-07-15T17:13:18Z", "source": { "name": "The War Zone", "url": "https://www.twz.com" } }, { "title": "Thousands of Afghans have been brought to Britain in secrecy after a data leak", "description": "Thousands of Afghans, including many who worked with British forces, have been secretly resettled in the U.K. after a leak of data on their identities raised fears that the Taliban could target them.", "content": "LONDON (AP) — Thousands of Afghans, including many who worked with British forces, have been secretly resettled in the U.K. after a leak of data on their identities raised fears that the Taliban could target them, the British government revealed Tues... [4078 chars]", "url": "https://apnews.com/article/britain-afghanistan-refugees-31c4e3c2746ba409fa72f76430b93020", "image": "https://dims.apnews.com/dims4/default/ff5f52f/2147483647/strip/true/crop/4962x2791+0+150/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Ffd%2F1d%2Fe153871f8d11b0bbfe3eb16828bf%2F9a9d6f5a2ed545cbbeeffc3c3fc9b671", "publishedAt": "2025-07-15T16:16:00Z", "source": { "name": "AP News", "url": "https://apnews.com" } }, { "title": "Erotic mosaic stolen by Nazi captain in second world war returned to Pompeii", "description": "Wehrmacht officer gave relic to German citizen whose family contacted Italian heritage officials after his death", "content": "An erotic mosaic panel stolen from Pompeii by a German Nazi captain during the second world war has been returned to the site of the ancient Roman ruins.\nThe relic, which depicts a pair of lovers and dates from between the middle of the last century ... [2583 chars]", "url": "https://www.theguardian.com/world/2025/jul/15/pompeii-mosaic-stolen-nazi-second-world-war-return", "image": "https://i.guim.co.uk/img/media/c59318d1c1b92d584bf3c9570e97a80969b65cc1/1399_0_7200_5760/master/7200.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=d62a4021db6276ec1737b6aadf17cf3a", "publishedAt": "2025-07-15T16:00:00Z", "source": { "name": "The Guardian", "url": "https://www.theguardian.com" } } ] }