API Amazon Recensioni
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
Raccogli le recensioni dei clienti Amazon per un prodotto. Ogni recensione include valutazione, titolo, data, voti di utilità, variante, paese e indicatori di acquisto verificato o Vine. Sono disponibili solo le recensioni in evidenza mostrate sulla pagina del prodotto, di solito circa una dozzina per prodotto. Per i negozi fuori dagli Stati Uniti, imposta domain in base al link del prodotto. Non c'è un parametro di ordinamento.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su amazon e action impostato su reviews. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
La funzionalità Amazon Reviews legge le recensioni degli acquirenti a partire dal link di un prodotto. Ogni riga contiene titolo e testo della recensione, valutazione, data di pubblicazione, quante persone l'hanno trovata utile, se si tratta di un acquisto verificato, se proviene dal programma Vine, la variante acquistata e il paese del recensore. Usala per capire se gli acquirenti sono soddisfatti e di cosa si lamentano esattamente, per la ricerca di prodotti per l'e-commerce transfrontaliero, l'individuazione dei punti deboli di un concorrente o il monitoraggio dei tuoi prodotti.
Passa un link a un prodotto come /dp/<ASIN>; l'ASIN viene estratto dal link. Per gli store fuori dagli Stati Uniti, imposta domain sullo store corrispondente al link, ad esempio amazon.co.uk. Dai più peso alle recensioni relative ad acquisti verificati, etichetta le recensioni is_vine come recensioni di prodotti ricevuti gratuitamente e usa variant per associare il feedback a una versione specifica. Non ci sono parametri di ordinamento o paginazione. Su ogni store sono disponibili solo le recensioni in evidenza mostrate nella pagina del prodotto, di solito una dozzina circa per prodotto, non l'intero storico.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Amazon Recensioni di EveryInfra (amazon/reviews).
Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su amazon e action su reviews, e inserisci i parametri in params.
- Parametri obbligatori:
- url: Specifica l'URL di un prodotto Amazon, ad esempio https://www.amazon.com/dp/<ASIN>. L'azione reviews estrae un ASIN alfanumerico maiuscolo di 10 caratteri dai percorsi /dp/, /gp/product/ o /product-reviews/.
- Parametri facoltativi:
- domain: Lo store nazionale di Amazon da cui provengono le recensioni, senza schema, www. o percorso. Il valore predefinito è amazon.com e dovrebbe corrispondere allo store nell'URL del prodotto. (valori consentiti: amazon.ca / amazon.co.jp / amazon.co.uk / amazon.com / amazon.com.au / amazon.de / amazon.es / amazon.fr)
- limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 20)
- Restituisce un elenco di record. Campi principali di ogni record: review_id (ID della recensione), title, text, rating, rating_scale, posted_at, helpful_count (Quante volte la recensione è stata valu…), is_verified_purchase (Indica se la recensione proviene da un…), is_vine (Indica se la recensione proviene dal pr…), variant (Variante del prodotto a cui si riferisc…), country, url; 17 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=amazon.
- Esempio di corpo della richiesta:
{
"platform": "amazon",
"action": "reviews",
"params": {
"url": "https://www.amazon.com/dp/B09B8V1LZ3"
}
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.
Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | amazon | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | reviews | Identificativo della funzionalità, valore fisso. |
url | body.params | string | Sì | - | Specifica l'URL di un prodotto Amazon, ad esempio https://www.amazon.com/dp/<ASIN>. L'azione reviews estrae un ASIN alfanumerico maiuscolo di 10 caratteri dai percorsi /dp/, /gp/product/ o /product-reviews/; le homepage degli store non sono supportate. Con questo parametro, profile recupera la pagina dei dettagli del prodotto, non i dati del profilo di un utente. |
domain | body.params | string (enum) | No | - | Lo store nazionale di Amazon da cui provengono le recensioni, senza schema, www. o percorso. Il valore predefinito è amazon.com e dovrebbe corrispondere allo store nell'URL del prodotto. Sono supportati solo 11 store: amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.it, amazon.es, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp e amazon.sg. Qualsiasi altro store, come amazon.com.mx, viene rifiutato con 422 invalid_value prima di qualsiasi addebito, e l'errore elenca gli store supportati. Su ogni store, reviews restituisce solo le recensioni in evidenza mostrate nella pagina del prodotto, di solito una dozzina circa per prodotto, non lo storico completo delle recensioni. Le recensioni dello store statunitense (amazon.com, che è anche il valore predefinito quando domain è omesso) al momento non sono disponibili perché Amazon richiede l'accesso per visualizzarle, e queste richieste non vengono addebitate; le chiamate sincrone di solito restituiscono 503 unavailable con error.reason impostato su access_blocked. Gli altri 10 store funzionano come di consueto; per un prodotto venduto anche su un altro store, come amazon.ca o amazon.co.uk, passa il domain di quello store per ottenerne le recensioni.Valori consentitiamazon.caamazon.co.jpamazon.co.ukamazon.comamazon.com.auamazon.deamazon.esamazon.framazon.inamazon.itamazon.sg |
limit | body.params | integer (1–100) | No | 20 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori superiori vengono accettati e limitati al valore massimo. |
Esempi di codice
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "amazon",
"action": "reviews",
"params": {
"url": "https://www.amazon.com/dp/B09B8V1LZ3"
}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#{ "id": "req_…", "platform": "amazon", "action": "reviews", "results": [ { "review_id": "RKHY57N765VC1", "title": "Great Sound and Very Convenient", "text": "I’m very happy with this Echo Dot. The sound is clear and surprisingly powerful for its small size. It was easy to set up, and Alexa responds quickly to commands. I love using it to play music, set timers, ask questions, and control my smart devices. The compact design also looks…", "rating": 5, "posted_at": "2026-09-14T00:00:00+00:00", "helpful_count": 4, "is_verified_purchase": true, "is_vine": false, "variant": "Color: Charcoal", "country": "United States", "url": "https://www.amazon.com/gp/customer-reviews/RKHY57N765VC1", "product_asin": "B09B8V1LZ3", "platform": "amazon", "rating_scale": 5 }, { "review_id": "RD53PF5YDN90U", "title": "Excellent little smart speaker", "text": "“Excellent little smart speaker. The setup was quick and easy, and the sound quality is surprisingly good for its size. Alexa responds quickly and is very useful for music, reminders, timers, and controlling smart devices. It fits perfectly in a bedroom or office. Very happy with…", "rating": 5, "posted_at": "2026-09-24T00:00:00+00:00", "is_verified_purchase": true, "is_vine": false, "variant": "Color: Glacier White", "country": "United States", "url": "https://www.amazon.com/gp/customer-reviews/RD53PF5YDN90U", "product_asin": "B09B8V1LZ3", "platform": "amazon", "rating_scale": 5 } ], "count": 10, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campi della risposta
#I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.
| Campo | Significato |
|---|---|
review_id | ID della recensione. |
title | Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo). |
text | Testo del contenuto senza HTML, restituito per intero e mai troncato (su alcune piattaforme i risultati degli elenchi contengono solo un estratto; lo indicano le note sui campi della piattaforma). |
rating | Valutazione. La scala varia in base alla piattaforma: rating_scale nella stessa riga indica il valore massimo (di solito 5; Booking, Douban, iQIYI e NAVER usano 10). Converti con rating_scale prima di confrontare piattaforme diverse, altrimenti il confronto può risultare invertito. |
rating_scale | Valore massimo di rating nella stessa riga: 5 per le scale a cinque stelle, 10 per quelle a dieci punti. Presente solo se la riga ha una valutazione. |
posted_at | Data e ora di pubblicazione in formato ISO 8601, UTC (ad esempio 2026-08-07T12:34:56+00:00). Le stringhe non standard della piattaforma vengono passate così come sono, quindi esegui il parsing in modo difensivo. null significa che la piattaforma non le rende note. |
helpful_count | Quante volte la recensione è stata valutata come utile. |
is_verified_purchase | Indica se la recensione proviene da un acquisto verificato. Dai meno peso alle recensioni non verificate. |
is_vine | Indica se la recensione proviene dal programma Vine (la piattaforma invia il prodotto in prova e la recensione viene etichettata come tale). |
variant | Variante del prodotto a cui si riferisce la recensione. |
country | Paese o regione: nome completo o codice ISO a seconda della piattaforma, non normalizzato. |
url | Link al record sulla piattaforma. |
author_name | Nome pubblico dell'autore della recensione (reviews), preso dal suo profilo pubblico; può essere vuoto. |
author_id | ID del profilo Amazon pubblico dell'autore della recensione (reviews); può essere vuoto. |
author_avatar_url | Link all'avatar ricavato dal profilo pubblico dell'autore della recensione (reviews); può essere vuoto o rimandare a un avatar predefinito. |
product_asin | ASIN del prodotto. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
images | Array di link alle immagini nell'ordine di visualizzazione della piattaforma; assente se non ci sono immagini. |
FAQ
#Come leggo le recensioni di uno store non statunitense?
#Imposta domain sullo store, ad esempio amazon.co.uk o amazon.co.jp, corrispondente allo store del link al prodotto, senza https:// né percorso. Il valore predefinito è amazon.com, quindi senza questo parametro le recensioni di un prodotto di un altro store non corrisponderanno.
Di quali recensioni dovrei fidarmi di più?
#Dai priorità alle recensioni in cui is_verified_purchase è true e dai meno peso alle altre. Le recensioni con is_vine true provengono dal programma Vine di Amazon e vanno etichettate come tali. Un helpful_count elevato di solito indica una recensione rappresentativa.
Posso passare come url il link alla vetrina di un negozio?
#No. L'ASIN di dieci caratteri viene letto da un percorso /dp/, /gp/product/ o /product-reviews/, quindi passa il link a una pagina prodotto o a una pagina di recensioni. Le vetrine e le pagine di ricerca non restituiscono recensioni.
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.
Riferimenti ufficiali
#Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.
- Amazon: cos'è un ASIN e come trovarlo ↗
Amazon definisce l'ASIN come un identificatore di prodotto alfanumerico di 10 caratteri e indica che si trova dopo /dp/ nei link alle pagine di dettaglio dei prodotti.
Verificato il 2026-09-04