amazon/
seller-info

Trasforma URL pubblici noti di profili venditore Amazon in campi normalizzati su identità del venditore, descrizione, sito web, valutazione, feedback, località, origine e orario di raccolta.

Amazon Seller Info API

Dettagli del profilo venditore
Marketplace supportati
Un record per URL
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 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

ParametriObbligatorioDescrizione
urlsObbligatorioArray 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à.

  1. Copia uno o più URL pubblici di profili venditore Amazon da un marketplace supportato.
  2. Invia con POST l’array urls a /v1/amazon/seller-info e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce.
  4. 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.items

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

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.

Esplora altre piattaforme

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

Amazon Seller Info API — FAQ

Amazon Seller Info API è un’interfaccia basata su URL per raccogliere i campi pubblici dei profili venditore Amazon in uno schema di venditore normalizzato. Non accede ai dati privati degli account di Seller Central.

La validazione del runtime accetta gli host Amazon di Stati Uniti, Regno Unito, Germania, Francia, Spagna, Italia, Canada, Australia, India e Giappone, sottodomini inclusi.

No. Ogni URL non vuoto inviato diventa un input di dettaglio e può produrre al massimo un record di venditore salvato, ma le pagine non disponibili, non valide per il provider o vuote possono non restituire alcun record.

No. results_limit non è un campo accettato nella richiesta e il provider riceve una riga di dettaglio per ogni URL. L’endpoint dei risultati dell’attività può comunque paginare gli elementi salvati con limit e next_cursor.

Ogni record di venditore restituito correttamente costa 0,15 crediti SocQ. La richiesta riserva 0,15 crediti per ogni URL inviato, poi regola il conto sul result_count effettivo. Un risultato vuoto ma riuscito ha l’addebito di base a zero crediti e rimborsa la riserva non usata.