amazon/
best-sellers

Raccogli i prodotti dagli URL pubblici di Amazon Best Sellers, con titoli, contesto del venditore, prezzi, segnali di reputazione visibili e media come record normalizzati.

Amazon Best Sellers API

Input con URL di categoria
Record di prodotto
0,15 crediti per risultato
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 Best Sellers

Le pagine Amazon Best Sellers organizzano i prodotti visibili pubblicamente negli elenchi per categoria, con titoli, contesto del venditore, prezzi, valutazioni, numero di recensioni, quantità vendute, media, link di origine e orari di rilevazione quando sono esposti. SocQ trasforma gli URL degli elenchi selezionati in record di prodotto normalizzati per la ricerca per categoria, il confronto degli assortimenti e flussi di lavoro ripetibili sui dati e-commerce.

Funzionalità della Amazon Best Sellers API

  • Raccolta da URL di categoria regionaliInvia uno o più URL pubblici di Best Sellers o di elenchi di categoria dei marketplace Amazon supportati in un’unica attività asincrona.
  • Identità normalizzata del prodottoRicevi record di prodotto stabili con ID, titoli, descrizioni, URL di origine, etichette di piattaforma e di risorsa e timestamp di raccolta, quando disponibili.
  • Contesto commerciale e di reputazioneConserva i dati disponibili su venditore, prezzi, valutazioni, numero di recensioni e quantità vendute in campi espliciti, senza analizzare il markup delle pagine.
  • Record di prodotto pronti per i mediaUsa gli oggetti media normalizzati di ogni prodotto per cataloghi, code di revisione, pipeline di arricchimento e analisi visive a valle.

Parametri della Amazon Best Sellers API

ParametriObbligatorioDescrizione
urlsObbligatorioElenco obbligatorio di riferimenti Amazon su host o sottodomini di marketplace supportati. Ogni percorso deve contenere /zgbs/ o /gp/bestsellers/. Sono accettati qualsiasi schema con un hostname analizzabile e i riferimenti relativi al protocollo.
results_limitFacoltativoIntero facoltativo da 1 a 2.000. Il valore predefinito è 100 e limita il totale dei record di prodotto unici salvati su tutti gli URL inviati.

Come usare la Amazon Best Sellers API

Invia URL pubblici di Best Sellers già noti, monitora l’attività asincrona e scorri i record di prodotto normalizzati.

  1. Prepara uno o più URL pubblici di Amazon Best Sellers o di elenchi di categoria su un host di marketplace supportato.
  2. Invia urls e un results_limit facoltativo da 1 a 2.000 a /v1/amazon/best-sellers, poi salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
  4. Leggi data.results.items e richiedi next_cursor finché has_more resta true.
curl -X POST "https://api.socq.ai/v1/amazon/best-sellers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/Best-Sellers-Books/zgbs/books"],"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 Best Sellers API

  • Istantanee dell’assortimento per categoria: Trasforma le pagine Best Sellers selezionate in un inventario di prodotti limitato, con link di origine e orari di raccolta, per un dataset di ricerca ben definito.
  • Confronto di prezzi e reputazione: Confronta prezzi, valutazioni, numero di recensioni e quantità vendute disponibili tra i prodotti restituiti, senza dover analizzare a valle un markup incoerente.
  • Arricchimento per la scoperta di prodotti: Aggiungi titoli, contesto del venditore, descrizioni, media e URL pubblici dei prodotti alle liste di candidati individuati nelle pagine di categoria.

Consigli degli esperti per la Amazon Best Sellers API

  • Usa riferimenti su host Amazon regionali supportati, con percorsi che contengono /zgbs/ o /gp/bestsellers/. I percorsi Amazon non pertinenti vengono rifiutati prima della creazione dell’attività.
  • Imposta results_limit per l’intera attività e non per ogni URL inviato, dimensionandolo sul lotto complessivo che ti serve.
  • Segui next_cursor finché has_more è false, perché i risultati dell’attività vengono restituiti tramite una vista separata con paginazione a cursore.
  • Tratta ID, descrizioni, dati del venditore, prezzi, valutazioni, conteggi, media, URL e orari di pubblicazione come valori nullable, invece di sostituire i valori mancanti con zero o con un oggetto vuoto.
  • Salva collected_at con ogni record e pianifica esecuzioni separate quando servono confronti in momenti diversi; l’endpoint non crea un flusso continuo.

Oltre alla Amazon Best Sellers API, usa queste API quando ti serve un altro tipo di dati pubblici di Amazon.

  • 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 Reviews API — Raccoglie le recensioni pubbliche dei prodotti dagli URL Amazon supportati con testo, valutazioni, dettagli dell’autore, riferimenti al prodotto, date e media.
  • 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 Best Sellers API — FAQ

Amazon Best Sellers API è un’interfaccia programmatica per raccogliere prodotti dagli URL pubblici di Amazon Best Sellers o di elenchi di categoria come record di prodotto normalizzati di SocQ.

L’array urls accetta riferimenti il cui hostname analizzato è un marketplace Amazon supportato o un suo sottodominio e il cui percorso contiene /zgbs/ o /gp/bestsellers/. Sono accettati qualsiasi schema con un hostname e i riferimenti relativi al protocollo.

Nella risposta stabile del prodotto non c’è alcun campo di posizione. Il record normalizzato si concentra su identità del prodotto, contenuto, venditore, prezzo, valutazione, numero di recensioni e di vendite, media, URL e timestamp, quando disponibili.

results_limit ha come valore predefinito 100, accetta interi da 1 a 2.000 e limita il totale dei record unici salvati per l’attività su tutti gli URL di input. Non è un limite separato per ogni URL.

Interroga /v1/tasks/{task_id}, leggi data.results.items dopo il successo e continua a richiedere il next_cursor restituito finché has_more è true. Il limite della pagina di risultati controlla la paginazione in lettura, non il volume raccolto.

Disponibilità pubblica, contenuto delle pagine, output del provider, normalizzazione, deduplicazione e results_limit valido per l’intera attività possono ridurre il numero finale di risultati. Un’attività riuscita può anche non contenere alcun record di prodotto.

Ogni record di prodotto standard restituito correttamente costa 0,15 crediti SocQ. L’attività riserva i crediti in base a results_limit, o a 100 se omesso, poi regola il conto sul numero effettivo di record restituiti e rimborsa i crediti riservati e non usati; un risultato vuoto non comporta alcun addebito.