
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": 3207306, "articles": [ { "title": "What We Know About the Power Outages in Spain and Portugal", "description": "Much of Spain’s power grid was operating normally on Tuesday, a day after a blackout affected critical infrastructure across the Iberian Peninsula.", "content": "Widespread power outages upended life for millions across Spain and Portugal (and, briefly, parts of France) on Monday.\nTraffic lights went dark at busy intersections. Trains stopped in the middle of a workday. And long lines formed at A.T.M.s and gr... [346 chars]", "url": "https://www.nytimes.com/2025/04/28/world/europe/spain-portugal-power-outage-what-we-know.html", "image": "https://static01.nyt.com/images/2025/04/28/multimedia/28xp-wwk-europe-outage2-wpbl/28xp-wwk-europe-outage2-wpbl-facebookJumbo.jpg", "publishedAt": "2025-04-29T06:45:00Z", "source": { "name": "The New York Times", "url": "https://www.nytimes.com" } }, { "title": "A look at vehicle ramming attacks across the globe", "description": "An SUV crashed into a crowd at a Filipino heritage festival in Vancouver over the weekend, killing 11 people and injuring dozens of others in the latest vehicle attack around the world.", "content": "An SUV crashed into a crowd at a Filipino heritage festival in Vancouver over the weekend, killing 11 people and injuring dozens of others in the latest deadly car ramming attack across the globe.\nOther such attacks in recent decades have been inspir... [6590 chars]", "url": "https://apnews.com/article/vancouver-vehicle-ramming-deadly-1ca0117b8ba92f4a5f65383f13e77bc7", "image": "https://dims.apnews.com/dims4/default/0a18104/2147483647/strip/true/crop/3600x2025+0+241/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F8d%2F82%2F8eef8d9050d9ffb8b301853a6065%2Faf0e9232ab0e42368c8d7f6804762aec", "publishedAt": "2025-04-29T01:23:00Z", "source": { "name": "AP News", "url": "https://apnews.com" } }, { "title": "Spain and Portugal begin recovering from a massive blackout. Here's what to know", "description": "Spanish prime minister Pedro Sánchez said a nationwide blackout of this scale had never happened before in Spain. He added that the underlying cause remains unclear.", "content": "Spain and Portugal begin recovering from a massive blackout. Here's what to know\ntoggle caption Manu Fernandez/AP\nParts of Spain, Portugal and southern France were plunged into darkness on Monday by a massive power outage. The lights are coming back ... [3089 chars]", "url": "https://www.npr.org/2025/04/28/g-s1-63175/power-outage-spain-portugal-blackout-france", "image": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/7862x4422+0+410/resize/1400/quality/100/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F49%2F76%2F5f5d1da441c88e66c324d1cdd716%2Fap25118443354651.jpg", "publishedAt": "2025-04-28T23:32:07Z", "source": { "name": "NPR", "url": "https://www.npr.org" } } ] }