Shopping · Amazon
Amazon Deals API
Amazon Deals API: ricevi dati Amazon live nel momento in cui li chiedi, in forma pulita e strutturata – pronti per la tua app, un foglio di calcolo o un assistente AI. Niente scraping, niente da mantenere.
100 richieste gratuite ogni mese · nessuna carta di credito · una chiave API per tutte le piattaforme
Dati chiave
Aggiornato il
La pagina delle offerte di Amazon raccoglie gli sconti a tempo del marketplace: offerte lampo con conto alla rovescia, Best Deals, offerte esclusive Prime e gli eventi stagionali costruiti su di esse. La Amazon Deals API di everydata.io legge quella griglia in tempo reale per qualsiasi marketplace e restituisce ogni offerta con prezzo attuale, prezzo di riferimento, risparmio e stato dell'offerta. I filtri per reparto, fascia di sconto, valutazione in stelle, fascia di prezzo e accesso Prime corrispondono direttamente ai filtri della pagina, e un endpoint complementare ti dice quali valori di filtro sono validi in questo momento.
- Piattaforma
- Amazon
- Endpoint principale
- /amazon-search-deals-v2
- Quota per chiamata
- 1 richiesta
- Piano gratuito
- 100 rich. / mesepoi da 30 € / mese
Dati Amazon pronti all'uso
Una risposta contiene currentPage, lastPage, countDeals, domainCode e usedFilter, cioè l'eco dei filtri effettivamente applicati, così puoi verificare che abbiano avuto effetto. deals è l'array delle schede offerta: id e dealType (BEST_DEAL, LIGHTNING_DEAL …), title, url, asin, price, retailPrice, savingAmount, savingPercentage, currency, dealState (AVAILABLE e gli stati successivi man mano che l'offerta procede), badgeMessage ("Offerta a tempo"), productRating, countReview, imgUrls e brand, se Amazon lo mostra.
GET /amz/amazon-deal-filter-v2 restituisce il vocabolario dei filtri attuale per un marketplace: reparti come coppie label/value ("Appliances" → 2619526011), livelli di discountRange ("10% off or more" → 1), minProductStarRating, fasce di priceRange, accessType per Prime Exclusive e Prime Early Access, marchi e raccolte attive come le offerte lampo. Passa questi valori all'endpoint delle offerte invece di inserirli a mano nel codice: ID dei reparti e fasce cambiano da un marketplace all'altro.
- Prezzo dell'offerta, prezzo di listino, savingAmount e savingPercentage come numeri, con valuta
- dealType, dealState e badgeMessage per distinguere le offerte lampo dai Best Deals continuativi
- ASIN, URL del prodotto, immagini, valutazione, numero di recensioni e marchio per ogni scheda offerta
- Filtri: departments, discountRange (1–5), minProductStarRating (1–4), priceRange (1–5), primeEarly, primeExclusive
- Endpoint di scoperta dei filtri con ID dei reparti, fasce e raccolte attive validi per ogni marketplace
- 30 offerte per pagina, come nella griglia di Amazon
- Tutti i marketplace tramite domainCode: com, de, co.uk, fr, it, es, ca, co.jp e altri
Cosa costruiscono i team
Aggregatori di offerte e servizi di avviso
Interroga la griglia delle offerte ogni pochi minuti durante il Prime Day o il Black Friday, filtra per savingPercentage e productRating e invia le nuove offerte lampo agli iscritti prima che si esauriscano.
Monitoraggio delle promozioni dei concorrenti
I brand osservano quali concorrenti lanciano offerte nel loro reparto, quanto è profondo lo sconto e per quanto tempo un'offerta resta AVAILABLE: dati utili per il proprio calendario promozionale.
Contenuti di affiliazione
Genera ogni giorno pagine "migliori offerte sotto i 25 in Elettronica" con i filtri priceRange e departments, collegando ogni ASIN con il tuo tag.
Analisi delle anomalie di prezzo
Salva retailPrice insieme ai dati dell'endpoint dello storico prezzi per verificare se i prezzi di riferimento delle offerte corrispondono a prezzi recenti reali.
Richiesta e risposta di esempio
Chiama GET /amz/amazon-search-deals-v2 con domainCode e page. Aggiungi departments con uno o più ID dall'endpoint dei filtri (separati da virgola), discountRange, minProductStarRating e priceRange come singole cifre, e primeEarly o primeExclusive come booleani. L'esempio richiede le offerte del reparto Elettrodomestici con almeno il 25% di sconto e minimo 4 stelle.
GET /amz/amazon-search-deals-v2
curl "https://api.everydata.io/amz/amazon-search-deals-v2?domainCode=com&page=1&departments=2619526011&discountRange=2&minProductStarRating=4" \
-H "x-api-key: YOUR_API_KEY"Risposta (abbreviata)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"currentPage": 1,
"lastPage": 2,
"countDeals": 30,
"domainCode": "com",
"usedFilter": {
"state": {
"refinementFilters": {
"departments": [
"2619526011"
],
"reviewRating": [
"4"
],
"percentOff": [
"2"
]
}
},
"version": 1
},
"deals": [
{
"id": "35911091",
"dealType": "BEST_DEAL",
"title": "Ultra Pain Relief Cooling Pillow for Neck Support, Adjustable Cervical Pillow, Odorless Ergonomic Contour Memory Foam",
"url": "https://www.amazon.com/Adjustable-Cervical-Sleeping-Ergonomic-Orthopedic/dp/B0C1GQ54QD",
"price": 31.32,
"retailPrice": 52.22,
"savingAmount": 20.9,
"savingPercentage": 40,
"asin": "B0C1GQ54QD",
"badgeMessage": "Limited time deal",
"productRating": "4.2",
"countReview": 23511,
"currency": "USD",
"dealState": "AVAILABLE"
}
]
}La paginazione segue la griglia delle offerte uno a uno: 30 schede per pagina. lastPage è il valore mostrato dalla paginazione di Amazon al momento della richiesta, ma la pagina delle offerte cambia di continuo – le offerte si esauriscono, nuove offerte lampo partono – quindi il ciclo sicuro è incrementare page finché l'array deals torna vuoto, invece di fermarsi a lastPage. Rimuovi i duplicati per id o asin, perché tra due chiamate una scheda può spostarsi dalla pagina 2 alla pagina 1.
Non tutte le schede contengono tutti i campi. Le schede che Amazon mostra senza badge dell'offerta – spesso prodotti "correlati" in fondo alla griglia – arrivano senza price, retailPrice o dealType. Considera savingPercentage lo sconto di riferimento e retailPrice il prezzo di riferimento di Amazon, che a seconda del marketplace può essere un prezzo di listino o un prezzo tipico recente.
Nelle schede offerta productRating è una semplice stringa come "4.2", diversamente dal formato "4.2 out of 5 stars" delle pagine prodotto. Un ID reparto che non esiste per il marketplace restituisce un array deals vuoto, con il tuo filtro riportato in usedFilter.
Endpoint correlati
Offerte. Le offerte del giorno di un marketplace, 30 per pagina, con filtri per reparto, sconto, prezzo e valutazione.
Filtri offerte. Valori di filtro validi (reparti, fasce di sconto, fasce di prezzo) per l'endpoint delle offerte.
Dettagli prodotto per ASIN. Stesso payload dei dettagli prodotto, richiesto tramite ASIN e marketplace.
Storico prezzi. Prezzi storici raccolti da questa API.
Paghi a richiesta, tutte le piattaforme incluse
Ogni pagina di offerte e ogni lookup dei filtri costa una richiesta; il vocabolario dei filtri cambia di rado, quindi scaricalo una volta al giorno per marketplace. Un tracker che interroga cinque reparti ogni dieci minuti su due pagine usa circa 43.000 richieste al mese: il piano Production (50.000 richieste, 80 €) le copre; se i picchi nei giorni di evento ti fanno superare la quota mensile, puoi passare a un piano superiore in qualsiasi momento (con addebito pro rata). Le risposte 5xx della piattaforma di origine non vengono mai addebitate.
- Free
- 100 rich. / mese
- Starter
- 5000 rich. · 30 €
- Production
- 50.000 rich. · 80 €
- Business
- 300.000 rich. · 300 €
Amazon Deals API: domande frequenti
Come trovo gli ID dei reparti validi?
Chiama GET /amz/amazon-deal-filter-v2 con il domainCode. departments elenca coppie label/value come "Appliances" → 2619526011; passa il value all'endpoint delle offerte. Gli ID cambiano tra i marketplace, quindi recuperali per ogni domainCode.
Cosa significano i valori di discountRange e priceRange?
Sono le posizioni ordinali delle fasce offerte da Amazon: ad esempio discountRange 1 è "10% off or more" e 2 è "25% off or more"; priceRange 1 è "Under 25". L'endpoint dei filtri restituisce le etichette attuali per ogni valore.
Perché la pagina 3 restituisce un array vuoto se lastPage indicava 4?
La griglia delle offerte cambia di continuo man mano che le offerte scadono e iniziano, quindi il numero di pagine della prima chiamata può non valere più un minuto dopo. Ripeti il ciclo finché l'array deals è vuoto e rimuovi i duplicati per id.
Posso richiedere solo le offerte lampo?
Non con un parametro dedicato, ma ogni scheda contiene dealType e badgeMessage, quindi puoi filtrare LIGHTNING_DEAL lato client. Il campo collections dell'endpoint dei filtri indica se una raccolta di offerte lampo è attualmente attiva.
L'API restituisce il conto alla rovescia dell'offerta?
No. dealState ti dice se l'offerta è attualmente AVAILABLE, ma il timer e la barra della percentuale già richiesta non sono inclusi. Interroga a intervalli brevi per rilevare rapidamente quando un'offerta si esaurisce.
Casi d'uso correlati
Inizia a leggere le offerte Amazon
Crea un account gratuito, scarica il vocabolario dei filtri per il tuo marketplace e leggi la griglia delle offerte live in JSON: 100 richieste al mese incluse.