Amazon Seller Info
Le pagine dei profili venditore di Amazon possono mostrare il nome del venditore, una descrizione pubblica, la valutazione, il totale dei feedback, il sito web e il contesto della località. SocQ raccoglie i campi pubblici disponibili per gli URL di venditori noti in uno schema stabile, mentre i valori privati, assenti, specifici del marketplace o non disponibili restano null e non vengono dedotti.
Funzionalità della Amazon Seller Info API
- Raccolta da URL di venditori notiInvia uno o più URL pubblici di profili venditore di dieci marketplace Amazon supportati, tra cui Stati Uniti, Regno Unito, UE, Canada, Australia, India e Giappone.
- Identità stabile del venditoreRicevi ID del venditore, URL pubblico, nome del venditore o dell’azienda, descrizione, sito web associato e timestamp di raccolta in un’unica struttura di risultato fissa.
- Segnali pubblici di reputazioneConserva i valori di rating e feedback_count dichiarati dalla fonte quando Amazon li espone, senza calcolare né compilare le misure mancanti.
- Contesto di località del marketplaceSalva i campi disponibili di nome della località, città, regione, paese, latitudine e longitudine, lasciando che ogni valore di località facoltativo resti null.
Parametri della Amazon Seller Info API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Array obbligatorio e non vuoto di riferimenti pubblici a venditori Amazon. L’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. Per questa operazione di dettaglio usa percorsi di profili venditore. |
Come usare la Amazon Seller Info API
Invia URL pubblici di profili venditore Amazon, segui l’attività asincrona e leggi i record dei venditori normalizzati dal risultato paginato dell’attività.
- Copia uno o più URL pubblici di profili venditore Amazon da un marketplace supportato.
- Invia con POST l’array urls a /v1/amazon/seller-info e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce.
- Leggi data.results.items e segui next_cursor solo quando has_more è true.
curl -X POST "https://api.socq.ai/v1/amazon/seller-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/sp?seller=A2L77EE7U53NWQ"]}'
# Poll GET /v1/tasks/{task_id}
# Read normalized sellers from data.results.itemsCasi d’uso della Amazon Seller Info API
- Mappatura dell’identità dei venditori: Trasforma un elenco preparato di URL di profili venditore in ID, nomi, URL pubblici, siti web e contesto del marketplace coerenti.
- Istantanee della reputazione: Registra valutazione pubblica, totale dei feedback e orario collected_at per confronti ripetibili in momenti diversi, senza considerare i valori come flussi in tempo reale.
- Verifica dei fornitori del marketplace: Crea una coda di revisione che mantiene descrizione pubblica del venditore, sito web, località e segnali di feedback legati all’URL del profilo di origine.
Consigli degli esperti per la Amazon Seller Info API
- Invia link canonici ai profili venditore come /sp?seller={seller_id}; le pagine di prodotto e di ricerca superano la regola sull’host, ma non sono input validi per i dettagli del venditore.
- Non inviare results_limit. Il backend crea un input di dettaglio per ogni URL e limita i risultati salvati al numero di URL non vuoti inviati.
- Un URL accettato può restituire zero o un record di venditore. Le pagine mancanti o non disponibili possono quindi rendere result_count inferiore al numero di URL.
- Tratta rating e feedback_count come istantanee dichiarate dalla fonte e usa collected_at quando confronti raccolte ripetute.
- I campi di località e il sito web sono facoltativi. Non dedurre presenza legale, proprietà o verifica da un valore null o da un profilo pubblico.
API correlate
Oltre alla Amazon Seller Info 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 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 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.