Cómo obtener precios de Decathlon España con una API, paso a paso

Para obtener precios de Decathlon España con una API, envía un POST a https://api.scavio.dev/api/v1/decathlon/search con {"query": "zapatillas running", "country": "es"}. La respuesta trae 40 productos de decathlon.es, cada uno con precio en céntimos de euro, marca, disponibilidad, valoración, número de opiniones y URL. Para el precio tachado, el GTIN y las variantes, pasa esa URL a /api/v1/decathlon/product. Cada llamada cuesta 2 créditos. Decathlon no ofrece una API pública de catálogo, así que esta es la forma más directa de tener esos datos en JSON sin mantener un scraper.

Esta guía usa respuestas reales de la API de Decathlon de Scavio capturadas el 2 de noviembre de 2026.

Lo que necesitas

• Una API key de Scavio. Al registrarte recibes 50 créditos gratis, sin tarjeta y sin cuenta de Decathlon: 25 llamadas.
• Cualquier lenguaje que haga peticiones HTTP. Los ejemplos usan cURL y Python.

Paso 1: busca productos en decathlon.es

curl -X POST 'https://api.scavio.dev/api/v1/decathlon/search' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"query": "zapatillas running", "country": "es"}'

La respuesta, recortada a 1 de sus 40 productos y sin alterar ningún valor:

{
  "data": {
    "query": "zapatillas running",
    "page": 1,
    "country": "es",
    "count": 40,
    "products": [
      {
        "position": 2,
        "id": "353286",
        "name": "Zapatillas de Running Hombre Kiprun Kipcore - negro y blanco",
        "brand": "KIPRUN",
        "url": "https://www.decathlon.es/es/p/zapatillas-de-running-hombre-kiprun-kipcore-blanco-amarillo/353286/c183c269c276m8913729",
        "image": "https://contents.mediadecathlon.com/p3031060/k$aea4484e033c5d4fe8840d93ee62a46e/picture.jpg",
        "price": 2899,
        "currency": "EUR",
        "availability": "InStock",
        "rating": 4.71,
        "review_count": 5614
      }
    ]
  },
  "response_time": 1518,
  "fetched_at": "2026-11-02T17:59:29.815Z",
  "credits_used": 2
}

Ojo con los colores: Decathlon lista cada color como una fila con el mismo id, y cada color tiene su precio. En esta búsqueda las Kipcore de hombre aparecían a 28,99 euros en negro y blanco, y a 59,99 en blanco y beige y en azul y blanco.

Paso 2: pagina y deduplica

Añade "page": 2 para los siguientes 40 productos, hasta un máximo de 50 páginas. La página 2 de "zapatillas running" trajo otros 40, con position empezando de nuevo en 1, y 10 de sus URL ya habían salido en la página 1. Guarda los resultados con la url como clave:

import requests

API = "https://api.scavio.dev/api/v1/decathlon/search"
HEADERS = {"Authorization": "Bearer sk_live_your_key"}

productos = {}
for page in (1, 2, 3):
    r = requests.post(API, headers=HEADERS, timeout=60,
                      json={"query": "zapatillas running", "country": "es", "page": page})
    for p in r.json()["data"]["products"]:
        productos[p["url"]] = p  # misma URL = misma variante

for p in productos.values():
    print(p["name"], p["price"] / 100, "EUR")

En las 80 filas de las dos primeras páginas, 74 eran de Kiprun y 6 de adidas.

Paso 3: abre la ficha para ver el precio tachado y el GTIN

curl -X POST 'https://api.scavio.dev/api/v1/decathlon/product' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"product_id": "353286", "country": "es"}'

Recortada (las 10 imágenes a 2 y los 6 breadcrumbs a 2), sin alterar valores:

{
  "id": "353286",
  "name": "Zapatillas de Running Hombre Kiprun Kipcore - negro y blanco",
  "brand": "KIPRUN",
  "url": "https://www.decathlon.es/es/p/zapatillas-de-running-hombre-kiprun-kipcore-negro-y-blanco/353286/c381c183m8873071",
  "country": "es",
  "sku": "5166646",
  "gtin": "3608392040849",
  "color": "negro grafito/blanco algodón",
  "price": 2899,
  "list_price": 4499,
  "currency": "EUR",
  "availability": "InStock",
  "offers": [
    { "price": 2899, "currency": "EUR", "availability": "InStock", "seller": null },
    { "price": 5999, "currency": "EUR", "availability": "InStock", "seller": null },
    { "price": 5999, "currency": "EUR", "availability": "InStock", "seller": null }
  ],
  "rating": 4.71,
  "review_count": 5617,
  "best_rating": 5,
  "category": "zapatillas de deporte",
  "images": [
    "https://contents.mediadecathlon.com/p3031060/k$aea4484e033c5d4fe8840d93ee62a46e/picture.jpg",
    "https://contents.mediadecathlon.com/p3030978/k$c4414307b520287c66e114f85bf026fb/picture.jpg"
  ],
  "breadcrumbs": [
    { "position": 3, "name": "Running", "url": "https://www.decathlon.es/es/deportes/running" },
    { "position": 4, "name": "Marcas", "url": "https://www.decathlon.es/es/deportes/running/marcas" }
  ]
}

list_price es el precio tachado: 44,99 euros frente a los 28,99 actuales, un 35,6% de descuento. Es null cuando no hay rebaja, y solo aparece en la ficha, no en la búsqueda. offers trae un precio por variante, y gtin es el código de barras EAN, útil para cruzar con tu catálogo o con otras tiendas. La ficha también acepta product_url con la URL de la búsqueda tal cual.

Paso 4: separa Decathlon de su marketplace

decathlon.es vende también productos de otras tiendas. Se reconocen porque la URL lleva /p/mp/ y el id es un identificador largo en lugar de un número de modelo. En la búsqueda "esterilla yoga", 27 de las 40 filas eran del marketplace, con marcas como Indigo Sports, Mobiclinic o Trex Sport:

r = requests.post(API, headers=HEADERS, timeout=60,
                  json={"query": "esterilla yoga", "country": "es"})
filas = r.json()["data"]["products"]
marketplace = [p for p in filas if "/p/mp/" in p["url"]]
print(len(marketplace), "de", len(filas))  # 27 de 40

En la ficha de esos productos, gtin, sku y seller llegaron a null: la API no nombra al vendedor externo. Si comparas precios con tu catálogo, filtra primero esas filas.

Paso 5: compara con Portugal, Francia o Italia

El id de modelo es el mismo en todos los países, así que con la misma key basta con cambiar country:

curl -X POST 'https://api.scavio.dev/api/v1/decathlon/product' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"product_id": "353286", "country": "pt"}'

decathlon.pt devolvió la misma variante (GTIN 3608392040849) a 35,95 euros, un 24% más que en España. Compara siempre por gtin: con el id de modelo, Francia e Italia devolvieron por defecto otro color. Para fijar la variante, pasa la URL de la variante con el dominio de ese país. Con ese método comparamos 6 artículos en 4 países y 9 bicicletas Rockrider entre España y Portugal: las 9 eran más baratas en Portugal. Los resultados están en las mejores APIs de precios de Decathlon.

Los dos endpoints

Los dos funcionan en decathlon.es con "country": "es" y en otras 6 tiendas de Decathlon con su código. La documentación de búsqueda y la de ficha de producto describen cada parámetro.

Límites que conviene conocer

• La búsqueda no trae list_price; para saber si algo está rebajado hace falta la ficha (2 créditos más por producto).
• En los productos del marketplace no llegan el GTIN ni el nombre del vendedor.
• No devuelve el texto de las opiniones, solo la valoración media y el número.
• Como máximo 50 páginas por búsqueda; para catálogos grandes, divide en búsquedas más concretas.

Cuánto cuesta

Búsqueda y ficha cuestan 2 créditos cada una. En el plan Growth con pago anual (US$2 por 1.000 créditos), una búsqueda de 40 productos cuesta US$0,004, así que 1.000 filas salen por unos US$0,10. Vigilar 100 fichas al día son 6.000 créditos al mes, unos US$12. Los 50 créditos del registro alcanzan para 25 llamadas. Detalle de planes en precios.

Para empezar

1. Regístrate en dashboard.scavio.dev: 50 créditos gratis, sin tarjeta.
2. Copia tu API key del dashboard.
3. Envía un POST a /api/v1/decathlon/search con "country": "es".

Prueba la API de Decathlon gratis o pruébala sin registro en la página de la API de Decathlon España. Si también trabajas con otras tiendas, la misma key sirve para la API de Amazon en Amazon España.