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. Headlines are based on Google News rankings and returned as JSON.

Get 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);
}

On the Free plan, browsers can only call the API from localhost: see Using the API in the FAQ.

<?php

$apiKey = "YOUR_API_KEY";

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

$response = file_get_contents("https://gnews.io/api/v4/top-headlines?" . $params);
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": 296124,
    "articles": [
        {
            "id": "d4b296c13ffd51ab82498f430875efa9",
            "title": "Bombardeo contra el Eln en Venezuela: los otros detalles desconocidos de la operación contra esa guerrilla",
            "description": "EL TIEMPO conoció que, tras el ataque, se han detectado movimientos de armados dentro del territorio venezolano, pero no hacia Colombia.",
            "content": "El bombardeo contra un campamento del Ejército de Liberación Nacional (Eln) en territorio venezolano, ocurrido el pasado 30 de octubre, habría tenido como uno de sus objetivos provocar el desplazamiento de integrantes de esa guerrilla que permanecen ... [3728 chars]",
            "url": "https://www.eltiempo.com/justicia/conflicto-y-narcotrafico/bombardeo-contra-el-eln-en-venezuela-los-otros-detalles-desconocidos-de-la-operacion-contra-esa-guerrilla-3598257",
            "image": "https://imagenes2.eltiempo.com/files/og_thumbnail/files/fp/uploads/2026/10/31/6ae6863309851.r_d.233-151-0.png",
            "publishedAt": "2026-11-04T00:29:22Z",
            "lang": "es",
            "source": {
                "id": "58dd8560c9b69789426e2f65cf9472fd",
                "name": "El Tiempo",
                "url": "https://www.eltiempo.com"
            }
        },
        {
            "id": "128ab382e059ee6499bbbab1630eba65",
            "title": "Temblor hoy 3 de noviembre en México: se reporta sismo de magnitud 4.9 en Guadalupe Victoria, Baja California",
            "description": "Sigue en vivo todas las actualizaciones sobre movimientos telúricos a lo largo y ancho del país",
            "content": "El Servicio Sismológico Nacional (SSN) de la UNAM informó que entre el 26 de octubre y el 1 de noviembre de 2026 se registraron 713 sismos en México.\nEl movimiento de mayor magnitud fue de 4.6 y ocurrió el 27 de octubre, a las 6:01 horas, con epicent... [2066 chars]",
            "url": "https://www.infobae.com/mexico/2026/11/03/temblor-hoy-en-mexico-noticias-actividad-sismica-3-de-noviembre-de-2026/",
            "image": "https://www.infobae.com/resizer/v2/STQDGTFSXNETTP7W7OC5CLVX7M.png?auth=b6b9a3cb36fae2363555e5cfd82e9a79ee976627aa2a90b8ec97320dcf8394ab&smart=true&width=1200&height=630&quality=85",
            "publishedAt": "2026-11-03T23:33:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        },
        {
            "id": "24276cf92c7c1bcb3b01af0b22995e2a",
            "title": "2 helicopters collided near Mount Everest base camp, killing one tourist",
            "description": "Two helicopters, one from Air Dynasty and one from Fishtail Air, collided near Mount Everest base camp in Nepal's Pheriche area, killing one tourist and injuring others as well.",
            "content": "NEWYou can now listen to Fox News articles!\nTwo helicopters collided while attempting to land just below Mount Everest base camp in Nepal.\nThe accident happened at about 8:12 a.m. Tuesday in the Pheriche area of Solukhumbu District, according to a tr... [2695 chars]",
            "url": "https://www.foxnews.com/travel/two-helicopters-collide-mount-everest-during-rescue-flight-killing-one-injuring-others",
            "image": "https://static.foxnews.com/foxnews.com/content/uploads/2026/11/nepal-helicopter-crash.jpg",
            "publishedAt": "2026-11-03T22:05:31Z",
            "lang": "en",
            "source": {
                "id": "a8408ad388422503ac33101396026891",
                "name": "Fox News",
                "url": "https://www.foxnews.com"
            }
        }
    ]
}

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

United States World News API

Categories

Request and live response