amazon/
reviews

Raccogli le recensioni pubbliche dei prodotti Amazon da URL supportati, con testo, valutazioni, dettagli sull’autore, riferimenti al prodotto, timestamp e media come record normalizzati.

Amazon Reviews API

Più URL di prodotto
Testo e valutazioni delle recensioni
Contesto di autore e prodotto
Record di recensione normalizzati
0,15 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
urlsObbligatorioElenco 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_limitFacoltativoNumero 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.

  1. Prepara uno o più URL di prodotti Amazon supportati e scegli un results_limit da 1 a 2.000.
  2. Invia con POST la richiesta a /v1/amazon/reviews e salva il task_id restituito.
  3. Interroga GET /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

Combina i dati di Amazon con i dati pubblici delle altre piattaforme social supportate.

Amazon Reviews API — FAQ

Amazon Reviews API è un’interfaccia programmatica per raccogliere le recensioni pubbliche dei prodotti da URL di prodotti Amazon supportati. Restituisce testo delle recensioni, valutazioni, dettagli sugli autori, timestamp, riferimenti ai prodotti, link di origine e media, tutti normalizzati.

Invia un array urls non vuoto i cui hostname analizzati siano amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp o i loro sottodomini. Sono accettati qualsiasi schema con un hostname e i riferimenti relativi al protocollo.

results_limit è il numero massimo di recensioni normalizzate salvate per l’intera attività, non un numero garantito per ogni URL. L’attività può concludersi con meno record quando vengono restituite meno recensioni pubbliche o quando i duplicati vengono rimossi.

Dopo il successo dell’attività, leggi data.results.items e passa next_cursor all’endpoint dell’attività finché has_more è true. L’endpoint dei risultati dell’attività accetta un limite di pagina da 1 a 500.

Ogni recensione salvata correttamente costa 0,15 crediti SocQ. La richiesta riserva i crediti in base a results_limit, poi li regola sul numero effettivo di risultati; un risultato vuoto non comporta alcun addebito.