Spain News API

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

<?php

$apiKey = "YOUR_API_KEY";

$query = http_build_query([
    "category" => "general",
    "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=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": 279990,
    "articles": [
        {
            "id": "1c7361e86289419ab6626f5f995ae2dd",
            "title": "Judici a un exmilitar ucraïnès pel sabotatge de Nord Stream",
            "description": "Un tribunal d’Hamburg obre un procés per crim de guerra contra l’exoficial i apunta a \"organismes estatals\" de Kíiv",
            "content": "Serà un judici previsiblement llarg, fins al 2027, i la seva arrencada es produeix en un moment de màxima pressió, militar i política, sobre Volodímir Zelenski. Al president d’Ucraïna no se’l relaciona directament amb el sabotatge que va inhabilitar ... [2488 chars]",
            "url": "https://www.elperiodico.cat/internacional/20261015/judici-exmilitar-ucraines-pel-sabotatge-135349313",
            "image": "https://estaticos-cdn.prensaiberica.es/clip/b464aefc-46f2-47d2-b14e-ab0c5ce69f99_16-9-aspect-ratio_default_0.jpg",
            "publishedAt": "2026-10-14T23:33:35Z",
            "lang": "ca",
            "source": {
                "id": "eb7b6aba0d4d93d7d9c730950908f5f2",
                "name": "El Periódico de Catalunya",
                "url": "https://www.elperiodico.cat"
            }
        },
        {
            "id": "78c09ea67d82c1788a293db5855494c6",
            "title": "Una visita histórica; un gobierno culpable",
            "description": "La reparación de los perjuicios causados por el asalto y la negligencia de un Gobierno cuyas responsabilidades deben ser investigadas con la premura que la gravedad de los hechos que vamos conociendo demanda",
            "content": "Los Reyes han puesto punto final en Melilla a la histórica visita a las dos ciudades autónomas que se ha convertido en un éxtasis de cariño, respeto y agradecimiento a sus majestades y de apoteosis de la españolidad que en aquella tierra nuestra se r... [2745 chars]",
            "url": "https://www.larazon.es/editoriales/visita-historica-gobierno-culpable_202610156ad00a94b79b18452fc4c547.html",
            "image": "https://fotografias-2.larazon.es/clipping/cmsimages02/2026/10/14/C0E9DF6E-A958-4766-B0E7-05284867EB14/98.jpg?crop=4618,2598,x0,y240&width=1900&height=1069&optimize=low&format=webply",
            "publishedAt": "2026-10-14T23:04:52Z",
            "lang": "es",
            "source": {
                "id": "ab9458aed2562e4cdb7c679ec5c16c25",
                "name": "La Razón",
                "url": "https://www.larazon.es"
            }
        },
        {
            "id": "e8b5afc900977afbe0c747bedd17492e",
            "title": "El Rei s’acomiada de Ceuta i Melilla i demana més \"proximitat\" d’Espanya",
            "description": "Felip VI tanca a Melilla un viatge d’alt voltatge polític amb missatges al Marroc, la Unió Europea i una petició d’\"unitat institucional\"",
            "content": "El cap d’Estat va aprofitar la seva presència a les dues ciutats autònomes per reivindicar la sobirania espanyola, reclamar \"bona fe\" al país veí, recordar a Europa les seves responsabilitats en la protecció de les fronteres i demanar \"unitat institu... [3266 chars]",
            "url": "https://www.elperiodico.cat/politica/20261015/rei-s-acomiada-ceuta-melilla-135348399",
            "image": "https://estaticos-cdn.prensaiberica.es/clip/be27dbf0-8d3b-47dd-92dd-4605f49cde2e_16-9-aspect-ratio_default_0_x358y267.jpg",
            "publishedAt": "2026-10-14T22:19:45Z",
            "lang": "ca",
            "source": {
                "id": "eb7b6aba0d4d93d7d9c730950908f5f2",
                "name": "El Periódico de Catalunya",
                "url": "https://www.elperiodico.cat"
            }
        }
    ]
}

Missing a publisher from Spain? Suggest a source.

Spain News API

Categories

Request and live response