Spain Sports News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=sports" \
  --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": "sports", "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: "sports",
    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" => "sports",
    "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=sports&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": 190480,
    "articles": [
        {
            "id": "53d9adcfef8fe544273d516a485a7948",
            "title": "Àlex Márquez, operat de la clavícula i de la mà esquerra",
            "description": "El pilot de Cervera Àlex Márquez (Ducati Desmosedici GP26) va confirmar ahir l’èxit de la intervenció quirúrgica a la qual es va haver de sotmetre en la seva clavícula dreta i a la mà esquerra a l’Hospital Ruber Internacional de Madrid. El petit dels germans Márquez, que va ser sotmès a la citada intervenció per […]",
            "content": "El pilot de Cervera Àlex Márquez (Ducati Desmosedici GP26) va confirmar ahir l’èxit de la intervenció quirúrgica a la qual es va haver de sotmetre en la seva clavícula dreta i a la mà esquerra a l’Hospital Ruber Internacional de Madrid.\nEl petit dels... [1025 chars]",
            "url": "https://lamanyana.cat/alex-marquez-operat-de-la-clavicula-i-de-la-ma-esquerra/",
            "image": "https://lamanyana.cat/wp-content/uploads/2026/11/FOTOAPERTURA1-1-scaled-e1793736892296.jpg",
            "publishedAt": "2026-11-04T02:13:10Z",
            "lang": "ca",
            "source": {
                "id": "40885bed91aa7e111b803e2051231a5d",
                "name": "La Mañana",
                "url": "https://lamanyana.cat"
            }
        },
        {
            "id": "f0589813f6644fc73a963d2f42c09dcb",
            "title": "L’Ajuntament de Tàrrega homenatja el Club Esportiu Alba per la seva participació als Special Olympics",
            "description": "L’Ajuntament de Tàrrega ha ofert aquest dimarts una recepció institucional al Club Esportiu Alba arran dels resultats obtinguts el passat octubre en les competicions dels Special Olympics celebrats a Tarragona. L’alcaldessa Rosa Maria Perelló i la regidora d’Acció Social, Marta Torre, junt amb altres regidors del consistori, han rebut els esportistes i altres representants de l’entitat a la Sala de Plens en […]",
            "content": "L’Ajuntament de Tàrrega ha ofert una recepció institucional al Club Esportiu Alba arran dels resultats obtinguts el passat octubre en les competicions dels Special Olympics celebrats a Tarragona. L’alcaldessa Rosa Maria Perelló i la regidora d’Acció ... [4239 chars]",
            "url": "https://lamanyana.cat/lajuntament-de-tarrega-homenatja-el-club-esportiu-alba-per-la-seva-participacio-als-special-olympics/",
            "image": "https://lamanyana.cat/wp-content/uploads/2026/11/Foto-de-familia-a-la-Sala-de-Plens-de-lAjuntament-de-Tarrega.jpg",
            "publishedAt": "2026-11-04T02:04:33Z",
            "lang": "ca",
            "source": {
                "id": "40885bed91aa7e111b803e2051231a5d",
                "name": "La Mañana",
                "url": "https://lamanyana.cat"
            }
        },
        {
            "id": "68aece7d2f95493e29d9ab8cf5c104bc",
            "title": "Èxit de la UGE al Campionat de Catalunya de Cros per equips",
            "description": "2 podis i una alta particpació badalonina al Campionat de Catalunya celebrat a Vic",
            "content": "Vic va acollir aquest diumenge 1 de novembre el Campionat de Catalunya de Cros per equips i Badalona hi va aportar més d'una cinquantena d'atletes, tots ells de la Unió Gimnàstica Esportiva de Badalona, des de categoria sub10 a màster. Els èxits van ... [507 chars]",
            "url": "https://www.bdncom.cat/poliesportiu/exit-uge-al-campionat-catalunya-cros-per-equips",
            "image": "https://cdn-bdncom.watchity.net/bdn/nearline/images/3b881b61-4b39-4deb-8ecb-fe61172a8384/577c93c5-aa04-4012-9717-b36ffd27cf36-vo-uge-gran/577c93c5-aa04-4012-9717-b36ffd27cf36_VO_uge-gran_medium.jpeg",
            "publishedAt": "2026-11-03T23:36:22Z",
            "lang": "ca",
            "source": {
                "id": "6e76ea7db1b016529a2fd1ff87c0f929",
                "name": "Badalona Comunicació",
                "url": "https://www.bdncom.cat"
            }
        }
    ]
}

Missing a source from Spain? Suggest a source.

Spain Sports News API

Categories

Request and live response