Spain World News API

Get the live top world headlines from Spain 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 Spain. 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=es&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --data-urlencode "country=es" \
  --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": "es", "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: "es",
    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"  => "es",
    "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=es&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": 164128,
    "articles": [
        {
            "id": "9cec5a2b916ae2203427b70f81b62161",
            "title": "Hutíes dicen haber atacado nuevamente el aeropuerto de Riad",
            "description": "El ataque contra la terminal aérea de la capital de Arabia Saudita fue \"preciso y directo\", aseguraron los rebeldes, sin aportar pruebas de daños o víctimas.",
            "content": "Los rebeldes hutíes del Yemen afirmaron este miércoles (14.10.2026) que atacaron nuevamente el aeropuerto internacional Rey Khaled de Riad con un misil balístico y aseguraron que golpearon con otros tres misiles a las fuerzas respaldadas por Arabia S... [1695 chars]",
            "url": "https://www.dw.com/es/hut%C3%ADes-dicen-haber-atacado-nuevamente-el-aeropuerto-de-riad/a-79664891",
            "image": "https://static.dw.com/image/79631917_6.jpg",
            "publishedAt": "2026-10-15T00:26:26Z",
            "lang": "es",
            "source": {
                "id": "67e0c40c5e24b3fec372ab75763abad9",
                "name": "DW.com",
                "url": "https://www.dw.com"
            }
        },
        {
            "id": "2cfb1ee9a5689d9fc8e16cedde5999b4",
            "title": "Escac a Occident",
            "description": "L’ofensiva houthi desafia el lideratge del príncep hereu saudita i posa a prova els seus aliats i l’estabilitat de la península Aràbiga",
            "content": "La treva auspiciada per les Nacions Unides el 2022 va reduir els combats i va permetre a l’Aràbia Saudita avançar en els plans de la Visió 2030 i iniciar el desenvolupament d’una economia amb menys dependència del petroli. Però aquella calma era fràg... [4142 chars]",
            "url": "https://www.elperiodico.cat/opinio/20261015/escac-occident-135348617",
            "image": "https://estaticos-cdn.prensaiberica.es/clip/dcf10adf-24a0-42ce-a197-1f97f0dd9156_16-9-aspect-ratio_default_0.jpg",
            "publishedAt": "2026-10-15T00:10:55Z",
            "lang": "ca",
            "source": {
                "id": "eb7b6aba0d4d93d7d9c730950908f5f2",
                "name": "El Periódico de Catalunya",
                "url": "https://www.elperiodico.cat"
            }
        },
        {
            "id": "b70ac6a61f58a81017aed0e9ea33a113",
            "title": "EE.UU. levanta las sanciones a Jorge Rodríguez",
            "description": "El Departamento del Tesoro de EE.UU. ha anunciado el levantamiento de las sanciones contra Jorge Rodríguez, presidente de la Asamblea Nacional de Venezuela.",
            "content": "El Departamento del Tesoro de Estados Unidos ha anunciado este miércoles el levantamiento de las sanciones contra Jorge Rodríguez, presidente de la Asamblea Nacional de Venezuela y hermano de la presidenta encargada del país, Delcy Rodríguez.\nEl nomb... [1160 chars]",
            "url": "https://www.rtve.es/noticias/20261015/venezuela-eeuu-levanta-sanciones-jorge-rodriguez-hermano-delcy/17267368.shtml",
            "image": "https://img.rtve.es/imagenes/venezuela-eeuu-levanta-sanciones-jorge-rodriguez-hermano-delcy/01792021497751.jpg",
            "publishedAt": "2026-10-14T23:51:12Z",
            "lang": "es",
            "source": {
                "id": "53aa49c642c418c57e62ba95e9734e2d",
                "name": "RTVE.es",
                "url": "https://www.rtve.es"
            }
        }
    ]
}

Missing a publisher from Spain? Suggest a source.

Spain World News API

Categories

Request and live response