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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Array 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.
- Invia con POST un array urls a /v1/amazon/product-detail usando un token Bearer o una chiave API.
- Salva il task_id restituito e interroga GET /v1/tasks/{task_id} finché status diventa succeeded o failed.
- 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 trueCasi 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.
API correlate
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.