amazon/
product-detail

Raccogli i dettagli pubblici dei prodotti Amazon da URL noti, con titoli, descrizioni, venditori, prezzi, valutazioni, numero di recensioni e di vendite e media come record normalizzati.

Amazon Product Details API

URL di prodotto noti
Input multi-marketplace
Record di prodotto 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 Product Details

I prodotti Amazon sono articoli di catalogo pubblici descritti da identificativi, titoli, descrizioni, contesto del venditore, prezzi, valutazioni, numero di recensioni, quantità vendute e media. Questi campi supportano l’arricchimento del catalogo, il confronto tra articoli, la verifica delle fonti e i report sui prodotti in un preciso momento.

Funzionalità della Amazon Product Details API

  • Ricerca in blocco da URL di prodotto notiInvia uno o più URL di Amazon in un’unica attività e ricevi al massimo tanti record di prodotto normalizzati quanti sono gli URL validi inviati.
  • Identità, testi e media del prodottoOgni record può includere identificativo e URL del prodotto, titolo, descrizione, timestamp di raccolta e riferimenti a immagini o video disponibili.
  • Venditore, prezzo e segnali visibili del prodottoGli oggetti annidati di venditore e prezzo affiancano i campi di valutazione, numero di recensioni e quantità vendute dichiarata, per un’elaborazione coerente a livello di campo.
  • Host dei marketplace Amazon supportatiIl validatore degli URL accetta gli host Amazon di Stati Uniti, Regno Unito, Germania, Francia, Spagna, Italia, Canada, Australia, India e Giappone, sottodomini inclusi.

Parametri della Amazon Product Details API

ParametriObbligatorioDescrizione
urlsObbligatorioArray obbligatorio e non vuoto di riferimenti a prodotti Amazon noti. L’hostname analizzato deve essere amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp oppure un sottodominio. Sono accettati qualsiasi schema con un hostname e i riferimenti relativi al protocollo.

Come usare la Amazon Product Details API

Invia URL di prodotto noti, salva l’ID dell’attività asincrona e leggi i record di prodotto normalizzati quando l’attività riesce.

  1. Invia con POST un array urls a /v1/amazon/product-detail usando un token Bearer o una chiave API.
  2. Salva il task_id restituito e interroga GET /v1/tasks/{task_id} finché status diventa succeeded o failed.
  3. Dopo il successo leggi data.results.items; quando has_more è true, richiedi la pagina successiva dei risultati con next_cursor senza inviare un’altra attività di prodotto.
curl -X POST "https://api.socq.ai/v1/amazon/product-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; follow next_cursor only while has_more is true

Casi d’uso della Amazon Product Details API

  • Arricchimento del catalogo per articoli noti: Associa titoli, descrizioni, contesto del venditore, prezzi, media, valutazioni e conteggi a un insieme esistente di URL di Amazon.
  • Confronto dei prodotti in un preciso momento: Confronta prezzo, valuta, valutazione, numero di recensioni, quantità vendute e campi del venditore normalizzati tra i record di prodotto selezionati e raccolti nello stesso momento.
  • Verifica delle fonti dei prodotti: Usa identificativi, URL canonici, titoli, descrizioni, riferimenti ai media e timestamp di raccolta per controllare i riferimenti del catalogo salvati rispetto alle pagine pubbliche dei prodotti.

Consigli degli esperti per la Amazon Product Details API

  • Usa riferimenti a prodotti il cui hostname analizzato appartiene a un marketplace Amazon supportato; un host valido da solo non garantisce che la destinazione corrisponda a un record di prodotto pubblico.
  • Non inviare results_limit, perché questo endpoint fissa il limite dei risultati del provider al numero di URL inviati.
  • Tratta i campi di venditore, prezzo, valutazione, numero di recensioni, quantità vendute, media, URL e orario di pubblicazione come nullable e conserva un’attività riuscita con zero elementi, invece di creare dati segnaposto.
  • Usa next_cursor solo per scorrere i risultati salvati di un’attività; continua con le richieste GET per la stessa attività invece di ripetere la POST a pagamento.

Oltre alla Amazon Product Details 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 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 Product Details API — FAQ

Amazon Product Details API è un’interfaccia programmatica per raccogliere i dettagli pubblici dei prodotti da riferimenti Amazon noti. Restituisce identificativi, titoli, descrizioni, oggetti di venditore e prezzo, valutazioni, numero di recensioni e di vendite, media e metadati di raccolta, tutti normalizzati.

Invia un array urls non vuoto con URL di prodotti Amazon. Il runtime accetta gli host Amazon di Stati Uniti, Regno Unito, Germania, Francia, Spagna, Italia, Canada, Australia, India e Giappone, sottodomini inclusi.

Sì. Aggiungi più URL noti all’array urls. Il limite dei risultati del provider è uguale al numero di URL inviati e righe non valide, non disponibili o con errore possono ridurre il numero di risultati riusciti.

Lo schema stabile del prodotto include campi di identità e di origine, titolo, descrizione, oggetti annidati di venditore e prezzo, valutazione, numero di recensioni, quantità vendute dichiarata, media e timestamp. I valori facoltativi della fonte restano null quando non sono disponibili.

La paginazione si applica alla lettura dei risultati salvati dopo il successo dell’attività, non all’invio degli URL dei prodotti. Segui next_cursor con GET /v1/tasks/{task_id} solo finché has_more è true.

La richiesta riserva una stima di 0,15 crediti per ogni URL inviato e viene regolata a 0,15 crediti per ogni record di prodotto restituito correttamente. Con una base a zero crediti e una policy per i risultati vuoti limitata alla base, un’attività senza record restituiti si chiude a zero.