Keepa API: Guida Completa per Venditori e Sviluppatori Amazon (2026)

## Indice

1. [Cos'è Keepa?](#cos-e-keepa)
2. [Cos'è l'API Keepa?](#cos-e-l-api-keepa)
3. [Prezzi dell'API Keepa](#prezzi-dell-api-keepa)
4. [Endpoint principali dell'API](#endpoint-principali-dell-api)
5. [Iniziare con Python](#iniziare-con-python)
6. [Casi d'uso reali](#casi-d-uso-reali)
7. [Limiti di frequenza, token e peculiarità](#limiti-di-frequenza-token-e-peculiarita)
8. [Alternative all'API Keepa](#alternative-all-api-keepa)
9. [Domande frequenti](#domande-frequenti)

---

Se vendi su Amazon — o sviluppi strumenti per chi lo fa — probabilmente hai sentito parlare di Keepa. L'estensione del browser che mostra i grafici della cronologia dei prezzi sulle pagine dei prodotti di Amazon è diventata il compagno di ricerca predefinito per milioni di venditori in tutto il mondo. Ma Keepa è più di un'estensione del browser. Sotto il cofano si trova una potente API che monitora prezzi, posizione nelle vendite (BSR), offerte e dati di categoria in tutti i principali marketplace di Amazon.

Questa guida copre tutto ciò che devi sapere sull'API Keepa nel 2026: quanto costa, quali endpoint sono disponibili, come scrivere la tua prima integrazione in Python e dove l'API presenta limiti. Che tu sia un venditore Amazon FBA che automatizza il flusso di lavoro di ricerca o uno sviluppatore che costruisce il prossimo strumento di ricerca prodotti, questo è il tuo punto di partenza.

## Cos'è Keepa?

Keepa è un servizio di monitoraggio dei prezzi di Amazon fondato in Germania. Monitora i prezzi dei prodotti, la posizione nelle vendite (BSR), il numero di offerte, il numero di recensioni e la cronologia delle valutazioni in tutti i principali marketplace di Amazon — inclusi Stati Uniti, Regno Unito, Germania, Francia, Italia, Spagna e Giappone.

La maggior parte dei venditori Amazon incontra Keepa per la prima volta attraverso la sua estensione del browser, che incorpora grafici interattivi della cronologia dei prezzi direttamente nelle pagine dei prodotti di Amazon. Questi grafici mostrano come il prezzo di un prodotto, il BSR e il Buy Box sono cambiati nel corso di giorni, settimane, mesi o anni.

Oltre all'estensione, Keepa offre una suite di strumenti basata sul web:

- **Product Finder** — filtra il catalogo di Amazon per prezzo, BSR, categoria, numero di recensioni e dozzine di altri criteri
- **Product Viewer** — importa ASIN in blocco e recupera i dati correnti
- **Liste dei migliori venditori** — monitora i leader di categoria in tempo reale
- **Monitoraggio e avvisi** — ricevi notifiche quando un prodotto raggiunge il prezzo desiderato

Questi strumenti sono utili di per sé, ma il vero potere per venditori e sviluppatori orientati all'automazione è l'**API Keepa**.

## Cos'è l'API Keepa?

L'API Keepa è un'interfaccia HTTP RESTful che espone praticamente tutto ciò che Keepa monitora sui prodotti di Amazon. Invece di navigare manualmente sul sito web o sull'estensione di Keepa, puoi interrogare programmaticamente i dati dei prodotti, gli alberi delle categorie, i profili dei venditori, le offerte e le liste dei migliori venditori.

L'API restituisce risposte JSON e utilizza un sistema di autenticazione basato su token. Passi la tua chiave di accesso API come parametro di query, e Keepa deduce i token dal tuo saldo in base ai dati che richiedi.

Le principali funzionalità includono:

- **Dati dei prodotti** — prezzo corrente, BSR, numero di offerte, valutazione, numero di recensioni, dimensioni, peso e cronologia completa dei prezzi/BSR che risale a diversi anni
- **Analisi del Buy Box** — chi detiene il Buy Box, per quanto tempo e a quale prezzo
- **Monitoraggio delle offerte** — offerte di terze parti in tempo reale con prezzi, condizioni e informazioni sul venditore
- **Navigazione nelle categorie** — albero completo delle categorie di Amazon con ID nodo
- **Migliori venditori** — prodotti più venduti in tempo reale per categoria
- **Ricerca venditore** — dettagli del venditore, ASIN dello storefront e dati di inventario
- **Ricerca prodotti** — ricerca basata su parole chiave nel catalogo di Amazon
- **Offerte** — prodotti con recenti cali di prezzo che corrispondono a criteri configurabili
- **Monitoraggio** — avvisi di prezzo programmatici con supporto webhook

Se Amazon ha dati su qualcosa, Keepa probabilmente li monitora — e l'API ti permette di accedervi su larga scala.

## Prezzi dell'API Keepa

Keepa utilizza un sistema di prezzi basato su token. Ogni livello di sottoscrizione API genera un certo numero di token al minuto. Ogni token ti permette di richiedere dati per un prodotto, un venditore o una categoria. I token non utilizzati scadono dopo 60 minuti.

### Prerequisito: Sottoscrizione Keepa

Prima di poter utilizzare l'API, è necessaria una sottoscrizione base di Keepa:

- **Gratuito** — €0/mese. Solo estensione del browser e monitoraggio di base. Nessun accesso all'API.
- **A pagamento** — €19/mese (o €189/anno). Sblocca Product Finder, Product Viewer, Best Sellers e accesso API di base a 1 token/minuto.

Il piano da €19/mese ti dà accesso all'API, ma con 1 token al minuto puoi interrogare solo circa 60 prodotti all'ora — utile per i test, ma non per carichi di lavoro di produzione.

### Piani aggiuntivi per l'API

Per un utilizzo serio, acquisti un piano API oltre alla tua sottoscrizione base:

| Token/Minuto | Costo Mensile | Prodotti/Ora (circa) |
|---------------|-------------|------------------------|
| 20 | €49 | ~1.200 |
| 60 | €129 | ~3.600 |
| 250 | €459 | ~15.000 |
| 500 | €879 | ~30.000 |
| 1.000 | €1.499 | ~60.000 |
| 2.000 | €2.499 | ~120.000 |
| 3.000 | €3.499 | ~180.000 |
| 4.000 | €4.499 | ~240.000 |

La colonna "Prodotti/Ora" presuppone 1 token per richiesta di prodotto. In pratica, abilitare funzionalità come i dati del Buy Box (5 token per richiesta) o la cronologia delle offerte riduce proporzionalmente la velocità.

### Cosa compra un token?

- **1 token** — query di prodotto standard (cronologia dei prezzi, BSR, metadati di base)
- **~2 token** — query di prodotto con dati sulle offerte
- **~5 token** — query di prodotto con statistiche del Buy Box
- **1 token** — ricerca di categoria o lista dei migliori venditori
- **1 token** — profilo del venditore

Tutti i piani sono mensili, prepagati e possono essere cancellati in qualsiasi momento. Puoi accumulare più piani su un account e gli aggiornamenti hanno effetto immediato. I downgrade sono limitati a una volta al mese.

## Endpoint principali dell'API

L'API Keepa espone oltre 16 endpoint. Ecco quelli più rilevanti per i venditori Amazon e gli sviluppatori di strumenti:

### Richiesta prodotto

L'endpoint più utilizzato. Recupera dati dettagliati sui prodotti per un massimo di 100 ASIN per richiesta.

```
GET https://api.keepa.com/product?key=YOUR_KEY&domain=1&asin=B0088PUEPK
```

Restituisce: prezzo corrente (Amazon, marketplace, usato), posizione nelle vendite, numero di recensioni, valutazione, dimensioni, peso, categoria e array completi della cronologia dei prezzi/BSR. Aggiungi `&buybox=1` per le statistiche del Buy Box (costa 5 token invece di 1).

### Migliori venditori

Recupera gli ASIN più venduti per qualsiasi categoria di Amazon.

```
GET https://api.keepa.com/bestsellers?key=YOUR_KEY&domain=3&category=340846031
```

Restituisce una lista di ASIN classificati in base alla posizione corrente nelle vendite. Hai bisogno dell'ID del nodo della categoria, che puoi trovare tramite l'endpoint di ricerca delle categorie.

### Ricerca e ricerca di categorie

Trova gli ID dei nodi delle categorie di Amazon per parola chiave o esplora l'albero delle categorie.

```
GET https://api.keepa.com/search?key=YOUR_KEY&domain=3&type=category&term=kitchen
```

### Venditore

Recupera i dettagli del venditore e, opzionalmente, il suo storefront completo (tutti gli ASIN elencati).

```
GET https://api.keepa.com/seller?key=YOUR_KEY&domain=1&seller=A2R2RITDJNW1Q6
```

### Product Finder

L'equivalente API dello strumento Product Finder di Keepa. Filtra il catalogo di Amazon per dozzine di criteri: intervallo di prezzo, intervallo di BSR, numero di recensioni, valutazione, categoria e altro.

### Monitoraggio

Aggiungi prodotti programmaticamente alla tua lista di monitoraggio e configura avvisi. Supporta la consegna tramite webhook — Keepa invia una richiesta HTTP POST al tuo URL quando il prezzo di un prodotto monitorato supera la tua soglia.

```
POST https://api.keepa.com/tracking?key=YOUR_KEY&type=add
```

### Offerte

Trova prodotti con recenti cali di prezzo, cambiamenti di BSR o altri criteri che qualificano un'offerta. Utile per i venditori di arbitraggio e all'ingrosso che scansionano opportunità.

## Iniziare con Python

Il modo più semplice per interagire con l'API Keepa da Python è il pacchetto `keepa`, mantenuto da Alex Kaszynski.

### Installazione

```bash
pip install keepa
```

Richiede Python 3.10+. Le dipendenze includono `numpy`, `aiohttp` e `matplotlib`.

### Esempio 1: Interroga un singolo prodotto

```python
import keepa

api = keepa.Keepa("YOUR_API_KEY")

# Interroga un prodotto su Amazon.de (domain=3)
products = api.query("B0088PUEPK", domain="DE")
product = products[0]

print(f"Titolo: {product['title']}")
print(f"Posizione nelle vendite: {product['salesRankReference']}")
print(f"Valutazione: {product['csv'][16][-1] / 10 if product['csv'][16] else 'N/A'}")
print(f"Numero di offerte: {product['csv'][11][-1] if product['csv'][11] else 'N/A'}")

# La cronologia dei prezzi è negli array product['csv']
# Indice 0 = prezzo Amazon, 1 = Marketplace Nuovo, 2 = Usato, ecc.
amazon_prices = product['csv'][0]  # [tempo, prezzo, tempo, prezzo, ...]
if amazon_prices is not None:
    latest_price = amazon_prices[-1] / 100  # Prezzi in centesimi
    print(f"Prezzo Amazon corrente: €{latest_price:.2f}")
```

### Esempio 2: Trova i migliori venditori in una categoria

```python
import keepa

api = keepa.Keepa("YOUR_API_KEY")

# Prima, trova l'ID della categoria per "Cucina" su Amazon.de
categories = api.search_for_categories("kitchen", domain="DE")
for cat_id, cat_data in list(categories.items())[:3]:
    print(f"Categoria: {cat_data['name']} (ID: {cat_id})")

# Ottieni i migliori venditori per una categoria specifica
best_sellers = api.best_sellers_query(domain="DE", category="340846031")
print(f"\nTop 5 ASIN nella categoria:")
for asin in best_sellers[:5]:
    print(f"  {asin}")

# Ora interroga in blocco quegli ASIN per i dettagli
products = api.query(best_sellers[:5], domain="DE")
for p in products:
    print(f"  {p['asin']}: {p['title'][:60]}...")
```

### Esempio 3: Query asincrona in blocco con limitazione della frequenza

Per carichi di lavoro di produzione che interrogano migliaia di prodotti, utilizza l'API asincrona:

```python
import asyncio
import keepa

async def analyze_asins(asin_list: list[str]):
    api = await keepa.AsyncKeepa().create("YOUR_API_KEY")

    # La libreria gestisce automaticamente la limitazione dei token
    # Interroga in batch di 100 (massimo di Keepa per richiesta)
    all_products = []
    for i in range(0, len(asin_list), 100):
        batch = asin_list[i:i+100]
        products = await api.query(batch, domain="DE")
        all_products.extend(products)
        print(f"Interrogati {len(all_products)}/{len(asin_list)} prodotti")

    # Analizza i risultati
    for p in all_products:
        title = p.get("title", "N/A")
        bsr = p.get("salesRankReference", -1)
        print(f"{p['asin']} | BSR: {bsr:>8} | {title[:50]}")

    return all_products

# Esegui con una lista di ASIN
asins = ["B0088PUEPK", "B07XJ8C8F5", "B09V3KXJPB"]
results = asyncio.run(analyze_asins(asins))
```

La libreria Python `keepa` gestisce internamente la gestione dei token — interromperà automaticamente le richieste quando il saldo dei token è basso e riprenderà quando i token si rigenerano.

## Casi d'uso reali

### Monitoraggio BSR per la ricerca di prodotti

Il caso d'uso più comune. Interroga i prodotti quotidianamente e memorizza la cronologia del BSR nel tuo database. Tracciare il BSR nel tempo rivela stagionalità, traiettorie di lancio e dinamiche competitive che una singola istantanea non mostra mai. I venditori che fanno ricerca di prodotti per private label utilizzano questo per convalidare la domanda prima di impegnarsi con un fornitore.

### Monitoraggio dei prezzi e ricalcolo

Monitora i prezzi dei concorrenti su più marketplace. Quando un concorrente abbassa il prezzo, il tuo sistema viene notificato (tramite webhook o polling) e può regolare il tuo prezzo tramite l'SP-API di Amazon. I venditori all'ingrosso e di arbitraggio si affidano a questo per mantenere una posizione competitiva.

### Intelligence sui concorrenti

Utilizza l'endpoint Venditore per monitorare lo storefront di un concorrente. Traccia quanti ASIN elencano, in quali categorie si espandono e come cambia la loro strategia di prezzo nel tempo. Combina questo con le query di prodotto per costruire un panorama competitivo completo.

### Scansione automatizzata delle offerte

L'endpoint Offerte individua prodotti con recenti cali di prezzo o miglioramenti del BSR. I venditori di arbitraggio costruiscono script che scansionano le offerte corrispondenti a criteri specifici — categoria, intervallo di prezzo, soglia di ROI — e inviano avvisi su Slack, Telegram o email pochi minuti dopo l'apparizione di un'offerta.

### Analisi delle categorie

Interroga i migliori venditori in più categorie per identificare lacune di mercato. Confronta i prezzi medi, il numero di recensioni e le distribuzioni del BSR tra le categorie per trovare nicchie in cui la domanda è alta ma la competizione è gestibile.

## Limiti di frequenza, token e peculiarità

### Scadenza dei token

I token scadono 60 minuti dopo la generazione, che tu li usi o no. Non puoi accumulare token. Se la tua applicazione è a scatti — ad esempio, esegue un lavoro batch giornaliero — stai pagando per i token generati durante le 23 ore in cui il sistema è inattivo. Per carichi di lavoro a scatti, considera di mettere in coda le richieste e distribuirle durante la finestra di generazione dei token.

### I dati del Buy Box sono costosi

Abilitare `buybox=True` in una query di prodotto costa 5 token invece di 1. Se hai bisogno di dati del Buy Box per 10.000 prodotti, sono 50.000 token — che con il piano da 250 token al minuto richiedono oltre 3 ore. Pianifica di conseguenza la tua pipeline di dati.

### Formato dei dati di prezzo

Keepa memorizza i prezzi in centesimi (interi) e i timestamp in "tempo Keepa" — minuti dal 1 gennaio 2011. Devi convertire entrambi in formati standard. La libreria Python gestisce gran parte di questo, ma se usi l'API HTTP raw, tieni presente queste conversioni:

```python
from datetime import datetime, timedelta

KEEPA_EPOCH = datetime(2011, 1, 1)

def keepa_time_to_datetime(keepa_minutes: int) -> datetime:
    return KEEPA_EPOCH + timedelta(minutes=keepa_minutes)

def keepa_price_to_float(price_cents: int) -> float:
    if price_cents < 0:
        return None  # -1 significa "non disponibile"
    return price_cents / 100
```

### Freschezza dei dati

Keepa non esegue il crawling di ogni prodotto continuamente. I prodotti popolari (BSR basso) vengono aggiornati più frequentemente — a volte ogni ora. I prodotti di nicchia potrebbero aggiornarsi solo ogni pochi giorni. Se hai bisogno di freschezza garantita, puoi passare il parametro `update` nella tua query per attivare un crawl live, ma questo costa token aggiuntivi.

### Copertura dei marketplace UE

Keepa copre Amazon.de, .fr, .it, .es, .co.uk, .nl, .pl, .se e .be. La profondità della copertura varia — Germania e Regno Unito hanno i dati storici più estesi, mentre i marketplace più recenti come Svezia e Belgio hanno storie più brevi. Per i venditori focalizzati sull'UE, Keepa è attualmente la migliore fonte unica per i dati sui prezzi cross-marketplace.

## Alternative all'API Keepa

Keepa è il leader di mercato per il monitoraggio dei prezzi di Amazon, ma non è l'unica opzione. Ecco alternative da considerare in base alle tue esigenze:

### Rainforest API

Un'API più ampia per i dati di Amazon che copre dettagli dei prodotti, risultati di ricerca, recensioni e altro. Rainforest esegue scraping direttamente su Amazon invece di mantenere il proprio database storico, quindi ti fornisce istantanee in tempo reale ma manca della profonda cronologia dei prezzi offerta da Keepa. I prezzi partono da $75/mese per 500 richieste.

### Pangolin API

Progettata come un concorrente diretto di Keepa con un focus sulla flessibilità dei prezzi. Offre fatturazione per richiesta invece di piani token-per-minuto, che può essere più conveniente per carichi di lavoro a scatti o a basso volume. La copertura è più ristretta rispetto a Keepa.

### SP-API (Amazon Selling Partner API)

L'API di Amazon per i venditori. Ti dà accesso ai tuoi dati di vendita, inventario, ordini e informazioni sul catalogo. Non fornisce prezzi dei concorrenti o cronologia del BSR — puoi vedere solo i dati relativi al tuo account venditore. Gratuita da usare ma complessa da configurare e limitata nell'ambito.

### AgentXray

Se sei un venditore Amazon UE che desidera le informazioni fornite dai dati di Keepa ma non vuole costruire e mantenere la propria pipeline di dati, [AgentXray](https://agentxray.ai) adotta un approccio diverso. Ingestisce i dati di Keepa insieme ad altre fonti e utilizza agenti AI per individuare opportunità di prodotto, generare report di mercato e automatizzare i flussi di lavoro di ricerca — così ottieni l'analisi senza scrivere codice. Vale la pena esplorare se il tuo obiettivo è l'intelligence azionabile piuttosto che l'accesso API grezzo.

### Costruire il proprio scraper

Alcuni sviluppatori saltano completamente le API di terze parti e costruiscono i propri scraper per Amazon. Questo ti dà il massimo controllo e zero costi API continui, ma Amazon blocca attivamente gli scraper e mantenerne uno è un investimento ingegneristico significativo. Per la maggior parte dei team, l'API Keepa è più conveniente che mantenere un'infrastruttura di scraping.

## Domande frequenti

### L'API Keepa è gratuita?

L'API Keepa non è gratuita. Hai bisogno almeno di una sottoscrizione Keepa a pagamento (€19/mese) che ti dà accesso API di base a 1 token al minuto. Per un utilizzo pratico, i piani API dedicati partono da €49/mese per 20 token al minuto. Non c'è una prova gratuita specifica per l'API.

### Quanti prodotti posso interrogare al giorno con l'API Keepa?

Dipende dal tuo piano e dalle opzioni di query. Con il piano da €49/mese (20 token/minuto), puoi interrogare circa 28.800 prodotti al giorno utilizzando richieste standard (1 token ciascuna). Il piano da €459/mese (250 token/minuto) consente circa 360.000 query di prodotto standard al giorno. Abilitare opzioni come i dati del Buy Box riduce proporzionalmente la velocità.

### L'API Keepa supporta tutti i marketplace di Amazon?

Keepa supporta 13 marketplace di Amazon: Stati Uniti, Regno Unito, Germania, Francia, Italia, Spagna, Canada, Giappone, India, Messico, Brasile, Australia e Paesi Bassi. Sono coperti anche altri marketplace UE tra cui Polonia, Svezia e Belgio. Ogni marketplace è identificato da un ID di dominio numerico nelle richieste API.

### Posso usare l'API Keepa per progetti commerciali?

Sì. I termini dell'API Keepa consentono l'uso commerciale. Molti strumenti SaaS, servizi di ricalcolo e piattaforme di ricerca prodotti sono costruiti sull'API Keepa. Dovresti rivedere i termini di servizio attuali di Keepa per eventuali restrizioni specifiche sulla ridistribuzione dei dati.

### Qual è la differenza tra l'API Keepa e la libreria Python keepa?

L'API Keepa è l'interfaccia HTTP REST fornita da Keepa.com. La libreria Python `keepa` (installabile tramite `pip install keepa`) è un wrapper open-source mantenuto dalla comunità che semplifica l'interazione con l'API da Python. La libreria gestisce automaticamente l'autenticazione, la limitazione della frequenza, l'analisi dei dati e la conversione del tempo Keepa. Hai comunque bisogno di una chiave API Keepa per utilizzare la libreria Python.

---

*Questa guida si basa sulla documentazione e sui prezzi dell'API Keepa aggiornati all'inizio del 2026. Keepa potrebbe aggiornare i suoi livelli di prezzo o le specifiche degli endpoint — controlla sempre [keepa.com](https://keepa.com) per le informazioni più recenti.*

## Letture correlate

- [keepa data explained](https://agentxray.ai/it/blog/keepa-data-explained-eu-sellers)