Shopping · Amazon
Amazon Search Results API
Amazon Search Results 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 di ricerca di Amazon è la vetrina del marketplace: quali ASIN si posizionano per una query, quali sono inserzioni a pagamento, quanto costano e quante persone li hanno acquistati il mese scorso. La Amazon Search Results API di everydata.io legge quella pagina in tempo reale per qualsiasi parola chiave e marketplace e restituisce la griglia dei risultati come array JSON: una chiamata per pagina di risultati, con lo stesso ordinamento che userebbe un cliente e i prodotti sponsorizzati contrassegnati o esclusi.
- Piattaforma
- Amazon
- Endpoint principale
- /amazon-search-by-keyword-asin
- Quota per chiamata
- 1 richiesta
- Piano gratuito
- 100 rich. / mesepoi da 30 € / mese
Dati Amazon pronti all'uso
Ogni chiamata restituisce i prodotti di una sola pagina di risultati, in ordine di posizionamento. numberOfProducts indica quanti prodotti organici c'erano nella pagina, numberOfSponsoredProducts quanti annunci erano mescolati e resultCount è il valore "over 100,000 results" che Amazon mostra per la parola chiave. foundProducts e foundSponsoredProducts sono semplici liste di ASIN, comode per un rapido controllo del posizionamento senza toccare gli oggetti di dettaglio.
searchProductDetails contiene il dettaglio di ogni riquadro: productDescription (il titolo del riquadro), asin, price e retailPrice come numeri con valuta, productRating e countReview, il badge prime, salesVolume ("50+ bought in past month"), il deliveryMessage mostrato da Amazon e un flag sponsored. dpUrl è il link relativo al prodotto, con cui puoi costruire un URL canonico usando l'host del marketplace. starFilterParam e categories espongono i filtri proposti da Amazon accanto ai risultati.
- Elenco dei risultati in ordine per pagina, con conteggi separati per risultati organici e sponsorizzati
- Per ogni riquadro: ASIN, titolo, prezzo, prezzo di listino, valuta, valutazione, numero di recensioni e URL dell'immagine
- Idoneità Prime, badge del volume di vendita e messaggio di consegna di Amazon per ogni prodotto
- sortBy: relevanceblender, price-asc-rank, price-desc-rank, review-rank, date-desc-rank
- Limita la query a un search alias (category) o a un ID di browse node (browseNode)
- excludeSponsored=true per escludere gli annunci; withCache=true per accettare una pagina in cache fino a 10 minuti
- Tutti i marketplace tramite domainCode: com, de, co.uk, fr, it, es, ca, co.jp, in, com.au, nl, se, pl e altri
Cosa costruiscono i team
Monitoraggio del posizionamento per parola chiave per venditori e agenzie
Scarica una volta al giorno le pagine 1–3 per ogni parola chiave monitorata, trova i tuoi ASIN in foundProducts e salva la posizione. Distingui posizionamento organico e sponsorizzato con il flag sponsored.
Share of shelf e monitoraggio dei concorrenti
Conta quanti riquadri della prima pagina appartengono a ciascun brand per le tue query principali su amazon.com, .de e .co.uk. salesVolume aggiunge un segnale di domanda per ogni concorrente.
Scoperta e ricerca di prodotti
Ordina per review-rank o date-desc-rank per far emergere i prodotti ben valutati o appena pubblicati in una nicchia, poi recupera i dettagli della shortlist tramite l'endpoint del prodotto.
Dashboard di ad intelligence
numberOfSponsoredProducts per pagina e la lista degli ASIN sponsorizzati mostrano quanto è contesa una parola chiave e quali concorrenti acquistano inserzioni su di essa.
Richiesta e risposta di esempio
Chiama GET /amz/amazon-search-by-keyword-asin con keyword e domainCode. page vale 1 per impostazione predefinita e arriva fino a 400; sortBy vale per impostazione predefinita relevanceblender, l'ordine "In primo piano" di Amazon. Il parametro category accetta un search alias esattamente come Amazon lo usa nel menu a tendina dei reparti: aps per tutti i reparti, electronics, computers e così via. Un alias non valido produce un risultato vuoto, non un errore, quindi tieni un elenco degli alias noti per ogni marketplace.
GET /amz/amazon-search-by-keyword-asin
curl "https://api.everydata.io/amz/amazon-search-by-keyword-asin?keyword=laptop&domainCode=com&page=1&sortBy=relevanceblender&excludeSponsored=false" \
-H "x-api-key: YOUR_API_KEY"Risposta (abbreviata)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"sortStrategy": "relevanceblender",
"domainCode": "com",
"keyword": "laptop",
"numberOfProducts": 26,
"numberOfSponsoredProducts": 6,
"resultCount": 100000,
"selectedCategory": "aps",
"foundSponsoredProducts": [
"B0FGJ14KRX",
"B0GY7F4FDK"
],
"foundProducts": [
"B0HFJ9BNPL",
"B0HF38QXHL"
],
"searchProductDetails": [
{
"productDescription": "Acer Aspire 14 AI Copilot+ PC - Intel Core Ultra 5 226V & 14” WUXGA Touch | 16GB LPDDR5X | 1TB Gen 4 SSD",
"asin": "B0FGJ14KRX",
"countReview": 20,
"imgUrl": "https://m.media-amazon.com/images/I/61kp09SeFyL._AC_UY218_.jpg",
"price": 548.44,
"retailPrice": 0,
"productRating": "4.0 out of 5 stars",
"prime": false,
"dpUrl": "/dp/B0FGJ14KRX",
"salesVolume": "50+ bought in past month",
"sponsored": true,
"currency": "USD"
}
],
"starFilterParam": {
"Apply 4 Stars & Up filter to narrow results": "p_72:1248879011"
},
"currentPage": 1,
"lastPage": 20
}La paginazione è esplicita: currentPage riporta la pagina richiesta e lastPage è la pagina più alta linkata da Amazon nella barra di paginazione. A seconda del layout una pagina contiene da 16 a 60 riquadri, quindi numberOfProducts varia. La posizione corrisponde all'indice nell'array searchProductDetails più l'offset delle pagine precedenti: l'API non rinumera i riquadri, quindi le voci sponsorizzate mantengono il loro posto reale, a meno che tu non passi excludeSponsored=true.
I risultati dipendono dal marketplace e dalla località di consegna predefinita che Amazon applica alla richiesta; il deliveryMessage nell'esempio ("Ships to Germany") mostra quale località è stata usata. Un retailPrice pari a 0 significa che non era mostrato alcun prezzo di listino barrato, mentre un price pari a 0 significa che il riquadro non aveva alcun prezzo: succede per gli articoli con varianti che richiedono prima una selezione.
La cache di 10 minuti (withCache=true) è utile quando più parti del tuo sistema lanciano la stessa query a pochi minuti di distanza: la seconda chiamata riceve la risposta dalla cache e torna più in fretta. browseNode restringe una query a un ID di nodo come 10158976011 quando l'alias è troppo ampio.
Endpoint correlati
Cerca prodotti. Ricerca per parola chiave con paginazione, ordinamento e filtro sui risultati sponsorizzati.
Dettagli prodotto per ASIN. Stesso payload dei dettagli prodotto, richiesto tramite ASIN e marketplace.
Più venduti. Classifica dei più venduti per l'URL di una categoria.
Paghi a richiesta, tutte le piattaforme incluse
Una pagina di risultati equivale a una richiesta, qualunque sia la sua dimensione. Monitorare ogni giorno 100 parole chiave sulle prime tre pagine richiede circa 9.000 richieste al mese: il piano Production (50.000 richieste, 80 €) le copre con margine per più marketplace, mentre Starter (5.000 richieste, 30 €) basta per un set di parole chiave più piccolo sulla sola pagina 1. I fallimenti 5xx lato Amazon non vengono addebitati.
- Free
- 100 rich. / mese
- Starter
- 5000 rich. · 30 €
- Production
- 50.000 rich. · 80 €
- Business
- 300.000 rich. · 300 €
Costruiscilo passo passo
Amazon Search Results API: domande frequenti
Quanti prodotti vengono restituiti per pagina?
Esattamente quelli che Amazon ha mostrato in quella pagina, di solito tra 16 e 60 riquadri, riportati in numberOfProducts più numberOfSponsoredProducts. Se ti serve un numero fisso di risultati, continua a richiedere pagine finché non ne hai abbastanza o currentPage raggiunge lastPage.
Posso filtrare i risultati per prezzo o valutazione?
Non con parametri diretti. Usa sortBy per ordinare per prezzo o recensioni, poi filtra lato client su price e productRating. Il campo starFilterParam mostra il filtro proposto da Amazon, che puoi riutilizzare come restrizione in stile browseNode dove possibile.
I prodotti sponsorizzati sono inclusi?
Per impostazione predefinita sì, ciascuno contrassegnato con sponsored: true ed elencato separatamente in foundSponsoredProducts. Imposta excludeSponsored=true per ricevere solo risultati organici.
La ricerca funziona con codici EAN o UPC?
Sì: Amazon tratta un GTIN come una parola chiave e di solito restituisce l'ASIN corrispondente come primo risultato. È il metodo standard per convertire i codici a barre in ASIN prima di chiamare l'endpoint del prodotto.
Su quali marketplace posso effettuare ricerche?
Su tutti i marketplace Amazon tramite domainCode, da com e de fino a co.jp, com.au, pl, ae e sg. Titoli e messaggi di consegna vengono restituiti nella lingua del marketplace.
Casi d'uso correlati
Lancia la tua prima ricerca su Amazon
Registrati gratis, invia una parola chiave e ricevi l'intera pagina di risultati in JSON: 100 richieste al mese senza costi.