Spain News API

Get the live top 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 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=general&country=es&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --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": "general", "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: "general",
    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" => "general",
    "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=general&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": 270690,
    "articles": [
        {
            "id": "4cd10a6a670189c8caf79f5a03fc9114",
            "title": "\"És insuficient\"",
            "description": "Des de Promoció pel Transport Públic exigeixen millorar els espais d'espera per dignificar als viatgers i alhora resoldre els problemes d'aglomeracions.",
            "content": "Ni 24 hores després de la seva entrada en funcionament, la configuració definitiva de l’intercanviador urbà la Sagrera-Meridiana ja ha despertat les primeres crítiques. Provenen d’entitats com Promoció del Transport Públic, qui veu en la definició d’... [1967 chars]",
            "url": "https://beteve.cat/mobilitat/intercanviador-meridiana-punt-mira-entitats-usuaris-es-insuficient/",
            "image": "https://img.beteve.cat/wp-content/uploads/2026/11/intercanviador-meridiana-1-2026-11-03.jpg",
            "publishedAt": "2026-11-04T06:47:47Z",
            "lang": "ca",
            "source": {
                "id": "8c8fd3dfe097e72257216f1b736a6f6e",
                "name": "Betevé",
                "url": "https://beteve.cat"
            }
        },
        {
            "id": "6dd681cb353ebf2309e3649f39857a27",
            "title": "Sonic Racing Crossworlds recibe su gran actualización 2.0.0 con todas estas novedades",
            "description": "¡Ya tenemos aquí la actualización de segundo aniversario! Tras conocer plantilla de personajes inicial, ahora tenemos más novedades. Hablamos del nuevo",
            "content": "¡Ya tenemos aquí la actualización de segundo aniversario! Tras conocer plantilla de personajes inicial, ahora tenemos más novedades. Hablamos del nuevo juego de carreras de Sonic para Nintendo Switch y Nintendo Switch 2. ¡Estamos comentando Sonic Rac... [2955 chars]",
            "url": "https://www.nintenderos.com/nintendo-switch-2/sonic-racing-crossworlds-recibe-su-gran-actualizacion-2-0-0-con-todas-estas-novedades/",
            "image": "https://www.nintenderos.com/wp-content/uploads/2026/11/Sonic-Racing-fdf-1200x630.jpg",
            "publishedAt": "2026-11-04T06:25:55Z",
            "lang": "es",
            "source": {
                "id": "f63b77d069b810ca4bfdc54396023e6f",
                "name": "Nintenderos",
                "url": "https://www.nintenderos.com"
            }
        },
        {
            "id": "96c30651092e78c833e1b13f5289526a",
            "title": "Madrid celebra una Cumbre Iberoamericana descafeinada",
            "description": "La presencia de la derecha latinoamericana contrasta con la ausencia de las primeras espadas de la izquierda en un evento que se celebra en plena campaña del 29 - N",
            "content": "La XXX Cumbre Iberoamericana, que España organiza por cuarta vez, se inaugura este miércoles en Madrid con la asistencia confirmada del máximo exponente de la derecha latinoamericana, el presidente de Argentina, Javier Milei, pero con las ausencias d... [10712 chars]",
            "url": "https://www.rtve.es/noticias/20261104/madrid-cumbre-iberoamericana-descafeinada-milei-ausentan-lula-sheinbaum/17298187.shtml",
            "image": "https://img.rtve.es/imagenes/madrid-cumbre-iberoamericana-descafeinada-milei-ausentan-lula-sheinbaum/01793726129547.jpg",
            "publishedAt": "2026-11-04T06:23:49Z",
            "lang": "es",
            "source": {
                "id": "53aa49c642c418c57e62ba95e9734e2d",
                "name": "RTVE.es",
                "url": "https://www.rtve.es"
            }
        }
    ]
}

Missing a source from Spain? Suggest a source.

Spain News API

Categories

Request and live response