Spain World News API

Get the live top world headlines from Spain 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 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);
}

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"  => "es",
    "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=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": 166050,
    "articles": [
        {
            "id": "a509bf83d03e39d9b5a1ed4ad74a023e",
            "title": "Trump arremete contra Fox News por una encuesta en la que ve un \"ataque premeditado\"",
            "description": "Trump arremete contra Fox News por una encuesta en la que ve un \"ataque premeditado\"",
            "content": "Washington, 3 nov (EFE).- El presidente de Estados Unidos, Donald Trump, arremetió este martes contra Fox News por una encuesta publicada por la cadena sobre las elecciones de medio mandato en las que ve \"un ataque premeditado\" contra sus políticas.\n... [1427 chars]",
            "url": "https://www.infobae.com/america/agencias/2026/11/04/trump-arremete-contra-fox-news-por-una-encuesta-en-la-que-ve-un-ataque-premeditado/",
            "image": "https://www.infobae.com/assets/images/logos/fallback-promo-image-1200x630.png",
            "publishedAt": "2026-11-04T00:30:00Z",
            "lang": "es",
            "source": {
                "id": "32b61a562295a89bd1b5b9b4fc2ff364",
                "name": "Infobae",
                "url": "https://www.infobae.com"
            }
        },
        {
            "id": "67432cb5d6fabb2aa7b3639670f53ed1",
            "title": "Elecciones en EE.UU.: empiezan a llegar los primeros resultados de unos comicios vistos como un referendo a Trump",
            "description": "Estados Unidos elige a los miembros de toda la Cámara de Representantes y a un tercio del Senado en unas elecciones que marcarán los dos últimos años de mandato del presidente Donald Trump.",
            "content": "Autor,\nTítulo del autor, BBC News Mundo\nFecha de publicación 2 horas\nTiempo de lectura: 3 min\nEl presidente Donald Trump afronta este martes unas elecciones legislativas que son vistas como un referendo a su gestión tras casi dos años de gobierno y q... [3339 chars]",
            "url": "https://www.bbc.com/mundo/articles/cv62y9278jz0o",
            "image": "https://ichef.bbci.co.uk/news/1200/branded_mundo/003b/live/1a7a1d60-d7e1-11f1-9df2-bb2826d0b830.jpg",
            "publishedAt": "2026-11-04T00:11:47Z",
            "lang": "es",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "0c354e316074c5ff1bb56671a7dbfae0",
            "title": "Las elecciones de medio mandato, en directo: Estados Unidos decide quién controla el Congreso y si pone límites a Trump",
            "description": "Más de la mitad del país ya ha cerrado las urnas y empieza el recuento de votos al Congreso y al Senado. La jornada electoral discurrió sin graves incidentes y los principales problemas estuvieron relacionados con asuntos técnicos o condiciones meteorológicas",
            "content": "La Voz\nINTERNACIONAL\nLos colegios electorales comienzan a cerrar. La jornada de votación ha finalizado en varios estados y empieza el recuento para las elecciones de medio mandato. Esto es solo el inicio de una noche electoral que se prevé larga y qu... [23978 chars]",
            "url": "https://www.lavozdegalicia.es/retransmision/internacional/2026/11/03/elecciones-medio-mandato-directo-estados-unidos-decide-controla-congreso-pone-limites-trump/01071793739151296136150.htm",
            "image": "https://img.lavdg.com/sc/R9CePUKHRE3D3aq07gMIpB4hV40=/1280x/2026/11/03/00121793738581888979985/Foto/reu_20261103_203448785.jpg",
            "publishedAt": "2026-11-04T00:10:29Z",
            "lang": "es",
            "source": {
                "id": "7cab412f1ae102bfe9f2d1074728c5d6",
                "name": "La Voz de Galicia",
                "url": "https://www.lavozdegalicia.es"
            }
        }
    ]
}

Missing a source from Spain? Suggest a source.

Spain World News API

Categories

Request and live response