United States World News API

Get the live top world headlines from the United States with one request to the Top Headlines endpoint of GNews API. Stories are selected by Google News rankings and returned as clean JSON.

Get your free API key

Request and live response

This request returns the current top world headlines from the United States. The response below is live: it was fetched when this page loaded. Every parameter is described in the Top Headlines endpoint documentation.

GET https://gnews.io/api/v4/top-headlines?category=world&country=us&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --data-urlencode "country=us" \
  --data-urlencode "apikey=YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"

response = requests.get(
    "https://gnews.io/api/v4/top-headlines",
    params={"category": "world", "country": "us", "apikey": API_KEY},
    timeout=10,
)
response.raise_for_status()

for article in response.json()["articles"]:
    print(article["title"])

const API_KEY = "YOUR_API_KEY";

const params = new URLSearchParams({
    category: "world",
    country: "us",
    apikey: API_KEY,
});

const response = await fetch(`https://gnews.io/api/v4/top-headlines?${params}`);
if (!response.ok) {
    throw new Error(`Request failed: ${response.status}`);
}

const { articles } = await response.json();
for (const article of articles) {
    console.log(article.title);
}

<?php

$apiKey = "YOUR_API_KEY";

$query = http_build_query([
    "category" => "world",
    "country"  => "us",
    "apikey"   => $apiKey,
]);

$response = file_get_contents("https://gnews.io/api/v4/top-headlines?" . $query);
if ($response === false) {
    throw new RuntimeException("Request failed");
}

$data = json_decode($response, true);
foreach ($data["articles"] as $article) {
    echo $article["title"] . PHP_EOL;
}

using System.Net.Http.Json;

const string ApiKey = "YOUR_API_KEY";

using var client = new HttpClient();

var url = $"https://gnews.io/api/v4/top-headlines?category=world&country=us&apikey={ApiKey}";
var data = await client.GetFromJsonAsync<ApiResponse>(url)
           ?? throw new InvalidOperationException("Empty response");

foreach (var article in data.Articles)
{
    Console.WriteLine(article.Title);
}

record ApiResponse(List<Article> Articles);
record Article(string Title);

200 OK · Live JSON response

{
    "totalArticles": 292320,
    "articles": [
        {
            "id": "4935c5a8b05b57805479da9d2cc6e801",
            "title": "Mystery woman sought after American found dead in Costa Rican tourist destination",
            "description": "Costa Rican authorities are searching for a woman who is suspected of homicide after an American citizen was found dead in late September.",
            "content": "Costa Rican authorities are searching for a woman who is suspected of homicide after an American citizen was found dead in late September.\nThe Judicial Investigation Agency in Costa Rica, the country's equivalent of the FBI, said the agency is seekin... [1301 chars]",
            "url": "https://www.fox4news.com/news/mystery-woman-sought-after-american-found-dead-costa-rican-tourist-destination",
            "image": "https://images.foxtv.com/static.livenowfox.com/www.livenowfox.com/content/uploads/2026/10/1200/630/playas-del-coco.jpg?ve=1&tl=1",
            "publishedAt": "2026-10-14T23:24:00Z",
            "lang": "en",
            "source": {
                "id": "64b65b088633e67f8bce3e07a31a359a",
                "name": "FOX 4 News Dallas-Fort Worth",
                "url": "https://www.fox4news.com"
            }
        },
        {
            "id": "7efaf62a5a40b35243e409866642d4a4",
            "title": "Watchdog group sues Trump administration over Jared Kushner’s government work",
            "description": "A watchdog group filed suit Wednesday alleging President Donald Trump’s son-in-law Jared Kushner’s current role as a top envoy for the administration is unlawful and raises numerous conflict-of-interest concerns.",
            "content": "A watchdog group filed suit Wednesday alleging President Donald Trump’s son-in-law Jared Kushner’s current role as a top envoy for the administration is unlawful and raises numerous conflict-of-interest concerns.\nKushner is wielding tremendous influe... [3393 chars]",
            "url": "https://www.nbcnews.com/politics/trump-administration/watchdog-group-sues-trump-administration-jared-kushners-government-wor-rcna603563",
            "image": "https://media-cldnry.s-nbcnews.com/image/upload/t_nbcnews-fp-1200-630,f_auto,q_auto:best/rockcms/2025-11/251107-jared-kusher-gk-f3870d.jpg",
            "publishedAt": "2026-10-14T22:34:29Z",
            "lang": "en",
            "source": {
                "id": "3bab6463853c054dc51d2427c1a5b69e",
                "name": "NBC News",
                "url": "https://www.nbcnews.com"
            }
        },
        {
            "id": "e5d93b6dc8a87fa1d5d5152a7266cc7c",
            "title": "Wildlife influencer comes close to losing a wrestling match to a 19-foot reticulated python",
            "description": "Wildlife influencer Mike Holston, known as The Real Tarzann, wrestled a 19-foot reticulated python using his jiu-jitsu skills in a dangerous jungle encounter.",
            "content": "A wildlife influencer who goes by the name The Real Tarzann on social media put his blue belt jiu-jitsu skills up against a 19-foot reticulated python. Smart.\nHe realizes he's getting dangerously close to being in trouble when the snake wraps up one ... [1930 chars]",
            "url": "https://www.foxnews.com/outkick-sports/wildlife-influencer-comes-close-losing-wrestling-match-19-foot-reticulated-python",
            "image": "https://static.foxnews.com/foxnews.com/content/uploads/2026/10/reticulated-python-constrictor-snake.jpg",
            "publishedAt": "2026-10-14T21:50:21Z",
            "lang": "en",
            "source": {
                "id": "a8408ad388422503ac33101396026891",
                "name": "Fox News",
                "url": "https://www.foxnews.com"
            }
        }
    ]
}

Missing a publisher from the United States? Suggest a source.

United States World News API

Categories

Request and live response