Amazon Reviews
Le recensioni dei prodotti Amazon sono record pubblici di feedback dei clienti, con testo scritto, valutazioni, dettagli sull’autore, orari di pubblicazione, riferimenti al prodotto e media allegati. Questi record supportano la ricerca sul feedback dei prodotti, il confronto delle valutazioni, il monitoraggio delle recensioni e l’arricchimento dei dati con link alla fonte.
Funzionalità della Amazon Reviews API
- Input con più URL di prodottoInvia uno o più URL di prodotti Amazon supportati in un’unica attività e applica un solo limite di risultati alle recensioni normalizzate che vengono salvate.
- Contenuto delle recensioni e autoriOgni record può conservare il testo pubblico della recensione, la valutazione numerica, l’identità dell’autore, l’orario di pubblicazione e le immagini o i video allegati.
- Record collegati al prodottoI risultati normalizzati mantengono identificativi e URL dei prodotti accanto all’identità della recensione e ai link di origine, così i record restano legati all’articolo recensito.
Parametri della Amazon Reviews API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di riferimenti a prodotti Amazon non vuoti. Ogni hostname analizzato deve appartenere a un marketplace supportato o a un suo sottodominio; sono accettati qualsiasi schema con un hostname e i riferimenti relativi al protocollo. Ogni elemento diventa una riga di input per il provider. |
results_limit | Facoltativo | Numero massimo di recensioni normalizzate salvate per l’intera attività; il valore predefinito è 100 e sono accettati interi da 1 a 2.000. |
Come usare la Amazon Reviews API
Invia URL di prodotto supportati, segui l’attività asincrona e leggi i record di recensione normalizzati con la paginazione a cursore.
- Prepara uno o più URL di prodotti Amazon supportati e scegli un results_limit da 1 a 2.000.
- Invia con POST la richiesta a /v1/amazon/reviews e salva il task_id restituito.
- Interroga GET /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
- Leggi data.results.items e richiedi il next_cursor restituito finché has_more resta true.
curl -X POST "https://api.socq.ai/v1/amazon/reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"],"results_limit":3}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della Amazon Reviews API
- Ricerca sul feedback dei prodotti: Usa testo delle recensioni, valutazioni, autori e orari di pubblicazione per esaminare il feedback pubblico restituito per i prodotti noti.
- Confronto delle valutazioni tra prodotti: Invia più URL di prodotto e raggruppa le valutazioni restituite per subject_id o subject_url, per confrontare i record di recensione raccolti.
- Arricchimento con prove dalle recensioni: Aggiungi link di origine, riferimenti ai prodotti, dettagli sugli autori, timestamp e media delle recensioni a dataset di prodotti o record di monitoraggio esistenti.
Consigli degli esperti per la Amazon Reviews API
- Usa riferimenti a prodotti il cui hostname analizzato appartiene a un marketplace Amazon supportato; i link abbreviati su host non pertinenti e gli host regionali non supportati non superano la validazione.
- Imposta results_limit sul numero totale di recensioni che vuoi salvare su tutti gli URL inviati, poi segui next_cursor finché has_more è false per leggere tutte le pagine salvate.
- Usa l’id della recensione come chiave dei record, quando presente, e conserva subject_id o subject_url quando raggruppi le recensioni per prodotto.
- Tratta testo, campi dell’autore, valutazioni, timestamp, riferimenti al prodotto e media mancanti come sconosciuti, senza inventare valori sostitutivi.
API correlate
Oltre alla Amazon Reviews API, usa queste API quando ti serve un altro tipo di dati pubblici di Amazon.
- Amazon Best Sellers API — Raccoglie i prodotti dagli URL pubblici delle categorie Amazon Best Sellers con venditore, prezzo, reputazione, quantità vendute, media, fonte e data normalizzati.
- Amazon Product Details API — Raccoglie i dettagli dei prodotti da URL Amazon noti con titolo, descrizione, venditore, prezzo, valutazione, numero di recensioni, quantità vendute e media.
- Amazon Product Search API — Cerca in un negozio Amazon supportato per frase di prodotto e restituisce, se disponibili, campi normalizzati di prodotto, venditore, prezzo, valutazione, recensioni, quantità vendute, media e fonte.
- Amazon Seller Info API — Raccoglie dagli URL dei venditori Amazon noti identità pubblica del profilo venditore, descrizione, sito web, valutazione, feedback, località, fonte e data di raccolta.
- Amazon Storefront API — Legge la vetrina di un creator Amazon dal suo URL con profilo, account social collegati, liste di idee con numero di articoli, post curati e prodotti di tendenza con prezzo.