AGGIUNGI ASIN/ISBN ALLA CODA DI QUERY API DI REVISIONE DEL PRODOTTO
La richiesta di aggiungere un ASIN/ISBN alla coda delle query di revisione del prodotto. L'API Product Reviews interrogherà le recensioni dei prodotti con la possibilità di filtrare i risultati in base ai parametri di query definiti dall'utente.
Limitazione
L'API può recuperare solo un massimo di 100 recensioni per combinazione di filtri.
DETRAZIONE DEL CREDITO
1 (uno) detrazione di credito (per pagina di Recensione del prodotto) dopo il recupero riuscito dei dati. 5 pagine di recensione del prodotto consumeranno 5 crediti se il recupero ha esito positivo.
RICHIESTA
| URI | /api/query/reviews/{ASIN/ISBN}?domain={dominio}&secretKey={secretKey} | {ASIN/ISBN} – obbligatorio – l'ASIN o il codice ISBN da aggiungere alla tracking list
{dominio} – facoltativo – il valore predefinito è www.amazon.com se valori validi non specificati [http://www.amazon.com,/www.amazon.com] {posizione} – facoltativo – filtra le recensioni per località come mostrato in Amazon. Ad esempio (“Stati Uniti”, “Messico”, “Regno Unito” ecc.) {data da} – facoltativo – filtra le recensioni pubblicate a partire dalla data specificata (modello valido “aaaa-MM-gg”) {datato} – facoltativo – filtra le recensioni pubblicate fino alla data specificata (modello valido “aaaa-MM-gg”) {soloacquistoverificato} – facoltativo – filtra solo le recensioni acquistate verificate (valore valido: “vero” o “falso”) {valutazione} – opzionale – filtra le recensioni per valutazione a stelle (valori validi: “1”, “2”, “3”, “4”, “5”) {ultimamente} – facoltativo – se vero, riceverà solo le prime 10 recensioni più recenti |
| Esempio | /api/query/reviews/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx&location=Mexico&datefrom=2021-01-01&dateto=2021-12-31&verifiedpurchaseonly=true&rating=5&latestonly=true | |
RISPOSTA
| Headers | |
| Tipo di supporto | application / json |
| Dati JSON |
JSON
{
"status": "OK",
"allowed": 4971,
"messageId": null,
"message": null,
"data": null,
"rid": "58eb4fb8bfc2333894ce7dc7",
"dateProcessed": null
}Note:: Durante la richiamata, il rid può essere utilizzato per collegare i dati della richiamata alla chiamata di richiesta originale.
RECENSIONI PRODOTTO RICHIAMATA RICHIESTA
RECENSIONI PRODOTTO QUERY RICHIESTA DI RICHIAMATA
| URI | Esempio: https://your.server.com/amzpecty_result | {Fornire l'URL nella pagina Preferenze} L'URL deve essere abilitato per SSL. AMZPECTY-API-SECRET-KEY (nome intestazione): l'intestazione della chiave segreta verrà inclusa per il server di richiamata per convalidare l'origine della richiesta |
| Tipo di supporto | application / json |
RECENSIONI PRODOTTO QUERY CALLBACK DATI ESEMPIO JSON
| Headers | |
| Tipo di supporto | application / json |
| Dati JSON |
JSON
{
"status": "OK",
"responsefor": "productreviews",
"allowed": 108974,
"dailyAllowed": 9903,
"messageId": null,
"message": null,
"data": {
"asin": "B01M5IK8M9",
"searchStatus": "completed",
"reviewPagesScanned": 4,
"requestFilters": {
"location": "United States",
"verifiedPurchaseOnly": true,
"fromDate": "Jan 01, 2021",
"toDate": "Dec 31, 2021",
"starRating": "5"
},
"totalReviews": 21,
"totalVerifiedPurchase": 21,
"reviewLocations": [
{
"location": "United States",
"reviewCount": 21
}
],
"ratings": [
{
"rating": "5.0 out of 5 stars",
"reviewCount": 21
}
],
"reviews": [
{
"reviewId": "R5N2Q27S1WE1P",
"customerName": "Spirit_Child",
"customerProfileLink": "https://www.amazon.com/gp/profile/amzn1.account.AFE7FQ7FOLUVIUTTUKVF3MVMUPFQ/ref=cm_cr_getr_d_gw_btm?ie=UTF8",
"customerProfileAvatar": "https://images-na.ssl-images-amazon.com/images/G/01/x-locale/common/grey-pixel.gif",
"reviewTitle": "I love it!",
"reviewBody": "It delivered on time & it’s what I was expecting!!",
"reviewLocation": "United States",
"reviewDate": "Dec 22, 2021",
"verifiedPurchase": true,
"variant": "Size: Standard",
"starRating": 5,
"starRatingString": "5.0 out of 5 stars"
}
]
},
"rid": "628c4494e4b06e3bbeaa8b5b",
"dateProcessed": 1653359777214,
"domain": "www.amazon.com",
"totalCreditsDeducted": 1
}ATTRIBUTI JSON
| nome attributo | Dettagli |
|---|---|
| status | Lo stato della richiesta. |
| rispostaper | Valore "productvariations" per il risultato della query Variazioni prodotto |
| permesso | Conteggio delle richieste attualmente consentite. Si ripristina mensilmente. |
| giornalieroConsentito | Il conteggio attuale delle richieste giornaliere consentite. Si ripristina quotidianamente. |
| ID messaggio | L'ID del messaggio (se presente). |
| messaggio | Il messaggio effettivo (se presente). Si prega di fare riferimento a Messaggi di errore. |
| liberare | L'ID della richiesta. Questo può essere utilizzato per abbinare questa risposta alla richiesta originale. |
| dataProcessed | La data in cui la richiesta è stata elaborata nel formato ora Unix. |
| dominio | Il dominio Amazon di destinazione. |
| crediti totali detratti | Questo campo indica quanti crediti API Amzpecty sono stati utilizzati per soddisfare questa richiesta. |
| data.asin | L'ASIN del prodotto. |
| dati. searchStatus | Lo stato della ricerca. ["in corso", "completato", "errore"] |
| dati. reviewPagineScansionate | Il numero di pagine di recensioni scansionate |
| dati. requestFilters | L'utente ha specificato i filtri per questa richiesta di query |
| dati. requestFilters. posizione | Filtro posizione. ["Stati Uniti", "Messico" ecc. come mostrato su Amazon] |
| dati. requestFilters. verificatoSoloacquisto | true: restituisci solo l'acquisto verificato |
| dati. requestFilters. daData | Data di revisione dal filtro. [“aaaa-MM-gg” ad esempio “2021-01-01”] |
| dati. requestFilters. ad oggi | Rivedi la data da filtrare. [“aaaa-MM-gg” ad esempio “2021-12-31”] |
| dati. requestFilters. stelle | Filtro di valutazione in stelle [“1”, “2”, “3”, “4”, “5”] |
| data.totalRecensioni | Contano le recensioni totali. |
| dati. totaleAcquisto verificato | Conteggio totale delle recensioni di acquisto verificato. |
| dati. recensioneSedi[] | L'elenco delle località con il numero di recensioni corrispondente |
| dati. reviewLocations[n].location | Il luogo della revisione |
| dati. reviewLocations[n].reviewCount | Conteggio della posizione della recensione |
| dati. giudizi [] | L'elenco delle valutazioni con il relativo conteggio delle valutazioni corrispondente |
| dati. valutazioni[n].valutazione | Il voto della recensione |
| dati. valutazioni[n].reviewCount | Il punteggio della recensione conta |
| dati. recensioni[] | L'elenco delle recensioni degli utenti con i relativi dettagli informativi |
| dati.reviews[n].reviewId | La recensione Id |
| data.reviews[n].nomecliente | Il nome del cliente che effettua la revisione |
| data.reviews[n].customerProfileLink | Il collegamento al profilo di revisione |
| data.reviews[n].customerProfileAvatar | Il collegamento avatar del profilo di revisione |
| data.reviews[n].reviewTitle | Il titolo della recensione |
| data.reviews[n].reviewBody | L'organismo di revisione |
| data.reviews[n].reviewLocation | Il luogo della revisione |
| data.reviews[n].reviewDate | La data della revisione |
| data.reviews[n].verifiedAcquisto | Il flag di acquisto verificato dalla recensione ("vero" se verificato) |
| data.reviews[n].variante | La variante del prodotto in esame |
| data.reviews[n].starRating | La valutazione in stelle della recensione |
| data.reviews[n].starRatingString | La valutazione in stelle della recensione sotto forma di stringa |
OTTIENI I RISULTATI DELLE RECENSIONI DEI PRODOTTI PER ASIN/ISBN
La richiesta di ottenere i risultati delle recensioni dei prodotti più recenti tramite ASIN/ISBN.
DETRAZIONE DEL CREDITO
Detrazione di 0 (zero) credito per la chiamata Get.
RICHIESTA
| URI | /api/query/reviews/asin/{ASIN/ISBN}?domain={dominio}&secretKey={secretKey} | {ASIN/ISBN} – l'ASIN per ottenere l'elenco di tracciamento più recente {dominio} – facoltativo – il valore predefinito è www.amazon.com se valori validi non specificati [ http://www.amazon.com,/www.amazon.com ] |
| Esempio | /api/query/reviews/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
RISPOSTA
See Recensioni prodotto Risultati query richiamata JSON Dati di esempio
OTTIENI I RISULTATI DELLE RECENSIONI DEI PRODOTTI PER RID
La richiesta di ottenere il risultato più recente delle recensioni dei prodotti da parte del RID.
DETRAZIONE DEL CREDITO
Detrazione di 0 (zero) credito per la chiamata Get.
RICHIESTA
| URI | /api/query/reviews/rid/{rid}?domain={dominio}&secretKey={secretKey} | { RID } – l'ID richiesta per ottenere l'elenco delle varianti più recenti {dominio} – facoltativo – il valore predefinito è www.amazon.com se non specificato. Vedere Domini Amazon supportati per lista. |
| Esempio | /api/query/reviews/rid/628c4494e4b06e3bbeaa8b5b?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
RISPOSTA
See Recensioni prodotto Risultati query richiamata JSON Dati di esempio
