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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco 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_limit | Facoltativo | Intero 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.
- Prepara uno o più URL pubblici di Amazon Best Sellers o di elenchi di categoria su un host di marketplace supportato.
- Invia urls e un results_limit facoltativo da 1 a 2.000 a /v1/amazon/best-sellers, poi salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
- 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 trueCasi 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.
API correlate
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.