Come ottenere i prezzi di Decathlon Italia con una API, passo dopo passo

Per ottenere i prezzi di Decathlon Italia con una API, invia un POST a https://api.scavio.dev/api/v1/decathlon/search con {"query": "tenda campeggio", "country": "it"}. La risposta contiene 40 prodotti di decathlon.it, ognuno con prezzo in centesimi di euro, marca, disponibilità, valutazione, numero di recensioni e URL. Per il prezzo barrato, il GTIN e le varianti, passa quell'URL a /api/v1/decathlon/product. Ogni chiamata costa 2 crediti. Decathlon non offre una API pubblica per il catalogo, quindi questo è il modo più diretto di avere quei dati in JSON senza mantenere uno scraper.

Questa guida usa risposte reali della API Decathlon di Scavio acquisite il 2 novembre 2026.

Cosa ti serve

• Una API key di Scavio. Alla registrazione ricevi 50 crediti gratuiti, senza carta e senza account Decathlon: 25 chiamate.
• Qualsiasi linguaggio che faccia richieste HTTP. Gli esempi usano cURL e Python.

Passo 1: cerca i prodotti su decathlon.it

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": "tenda campeggio", "country": "it"}'

La risposta, ridotta a 1 dei 40 prodotti e senza alcun valore modificato:

{
  "data": {
    "query": "tenda campeggio",
    "page": 1,
    "country": "it",
    "count": 40,
    "products": [
      {
        "position": 2,
        "id": "4123",
        "name": "Tenda campeggio ARPENAZ 4.1 | 4 posti 1 camera",
        "brand": "QUECHUA",
        "url": "https://www.decathlon.it/p/tenda-campeggio-arpenaz-4-1-4-posti-1-camera/4123/c98c241m8648383",
        "image": "https://contents.mediadecathlon.com/p2583236/k$e0e84ad4bf3bc0e371a631b0bd364884/picture.jpg",
        "price": 12999,
        "currency": "EUR",
        "availability": "InStock",
        "rating": 4.67,
        "review_count": 2038
      }
    ]
  },
  "response_time": 2755,
  "fetched_at": "2026-11-02T18:18:19.486Z",
  "credits_used": 2
}

Passo 2: pagina e separa il marketplace

Aggiungi "page": 2 per i 40 prodotti successivi, fino a 50 pagine. decathlon.it vende anche prodotti di negozi terzi: hanno /p/mp/ nell'URL e un id lungo al posto del numero di modello. Nella ricerca "tenda campeggio" erano 10 righe su 40 (Outsunny, Aktive, KingCamp, VidaXL e altri), mentre 28 erano Quechua:

import requests

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

r = requests.post(API, headers=HEADERS, timeout=90,
                  json={"query": "tenda campeggio", "country": "it"})
righe = r.json()["data"]["products"]
decathlon = [p for p in righe if "/p/mp/" not in p["url"]]
print(len(decathlon), "su", len(righe))  # 30 su 40
for p in decathlon[:5]:
    print(p["name"], p["price"] / 100, "EUR")

Ogni colore compare come riga a sé con lo stesso id: usa l'url come chiave. Nella ricerca "scarpe running" le 40 righe erano di 9 marche, da Kiprun (15) e Decathlon (8) ad adidas (7) e ASICS (5).

Passo 3: apri la scheda prodotto

Passa l'url di un risultato all'endpoint di prodotto:

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_url": "https://www.decathlon.it/p/tenda-campeggio-arpenaz-4-1-4-posti-1-camera/4123/c98c241m8648383", "country": "it"}'

Ridotta (descrizione e 10 immagini omesse, 2 dei 6 livelli del percorso), senza valori modificati:

{
  "id": "4123",
  "name": "Tenda campeggio ARPENAZ 4.1 | 4 posti 1 camera",
  "brand": "QUECHUA",
  "url": "https://www.decathlon.it/p/tenda-campeggio-arpenaz-4-1-4-posti-1-camera/4123/c98c241m8648383",
  "country": "it",
  "sku": "4327058",
  "gtin": "3608439287916",
  "mpn": null,
  "color": null,
  "price": 12999,
  "list_price": null,
  "currency": "EUR",
  "availability": "InStock",
  "offers": null,
  "rating": 4.67,
  "review_count": 2039,
  "best_rating": 5,
  "category": "Tende",
  "breadcrumbs": [
    {
      "position": 3,
      "name": "Campeggio",
      "url": "https://www.decathlon.it/tutti-gli-sport/campeggio"
    },
    {
      "position": 6,
      "name": "Tende 4 posti",
      "url": "https://www.decathlon.it/tutti-gli-sport/campeggio/tende-4-posti"
    }
  ]
}

list_price è il prezzo barrato e vale null quando non c'è promozione, come qui. Compare solo nella scheda, non nella ricerca. gtin è il codice EAN, la chiave per ritrovare la stessa variante in un altro negozio o nel tuo catalogo. offers elenca un prezzo per variante quando il prodotto ne ha più d'una; per questa tenda era null.

Passo 4: confronta con Spagna, Francia o Portogallo

Il numero di modello è lo stesso ovunque. Per la stessa variante, passa l'URL con il dominio dell'altro paese (il codice finale c98c241m8648383 non cambia) e confronta per 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_url": "https://www.decathlon.es/es/p/producto/4123/c98c241m8648383", "country": "es"}'

decathlon.es ha restituito lo stesso GTIN, 3608439287916, a 114,99 euro con list_price 129,99: in Spagna la Arpenaz 4.1 era in promozione, in Italia no. Su 6 articoli confrontati in 4 paesi, l'Italia aveva sempre gli stessi prezzi della Francia, fino al 24% sopra la Spagna. I risultati completi sono nelle migliori API per i prezzi Decathlon.

I due endpoint

Entrambi funzionano su decathlon.it con "country": "it" e su altri 6 negozi Decathlon con il rispettivo codice. La documentazione della ricerca e quella della scheda prodotto descrivono ogni parametro.

Limiti da conoscere

• La ricerca non restituisce list_price: per scoprire le promozioni serve la scheda (altri 2 crediti a prodotto).
• Per i prodotti del marketplace seller vale null: la API non indica il venditore terzo.
• Niente testo delle recensioni, solo media e numero.
• Al massimo 50 pagine per ricerca; per cataloghi grandi, dividi in ricerche più specifiche.

Quanto costa

Ricerca e scheda costano 2 crediti ciascuna. Sul piano Growth annuale (2 dollari ogni 1.000 crediti) una ricerca da 40 prodotti costa 0,004 dollari, quindi 1.000 righe costano circa 0,10 dollari. Monitorare 100 schede al giorno sono 6.000 crediti al mese, circa 12 dollari. I 50 crediti della registrazione bastano per 25 chiamate. I piani sono nella pagina prezzi.

Per iniziare

1. Registrati su dashboard.scavio.dev: 50 crediti gratuiti, senza carta.
2. Copia la tua API key dalla dashboard.
3. Invia un POST a /api/v1/decathlon/search con "country": "it".

Prova gratis la API Decathlon oppure provala senza registrazione nella pagina della API Decathlon Italia. La stessa key funziona con la API Amazon per amazon.it.