Amazon Storefront
Un Amazon storefront è la vetrina che chi partecipa al programma Amazon Influencer gestisce con il proprio nome di negozio, dove i prodotti sono raccolti in liste di idee e post curati insieme a descrizione, foto profilo, link ai social e una fila di prodotti di tendenza. Leggerla rivela chi è il creator, dove altro pubblica, come organizza i suoi consigli e quali prodotti sta spingendo in questo momento e a quale prezzo.
Funzionalità della Amazon Storefront API
- Profilo e badge di top creatorname, text e avatar_url forniscono nome visualizzato, descrizione della vetrina e foto profilo, mentre is_top_creator indica se Amazon segnala la persona come top creator.
- Account social collegatisocial_urls elenca i profili TikTok, YouTube, Pinterest e di altre reti che il creator collega dall’intestazione della vetrina.
- Liste di idee con numero di articolilists restituisce ogni lista di idee della prima pagina della vetrina con titolo, link, immagine di copertina e items_count, cioè quanti prodotti contiene.
- Post curaticurations restituisce i post curati del creator con titolo, link, immagine di copertina e posts_count, il numero di prodotti raccolti in ciascuno.
- Prodotti di tendenza con prezzotrending_picks restituisce i prodotti che la vetrina mette in evidenza, ognuno con link nella vetrina, immagine, prezzo attuale nella valuta del marketplace ed eventuale sconto mostrato.
Parametri della Amazon Storefront API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | L’URL della vetrina di un creator Amazon, nel formato https://www.amazon.com/shop/<name>; gli URL delle vetrine sugli altri marketplace Amazon funzionano allo stesso modo. |
Come usare la Amazon Storefront API
Invia l’URL di una vetrina e leggila come singola riga di risultato.
- Invia {"url": "https://www.amazon.com/shop/sydneydelrey"} in POST a /v1/amazon/shop.
- Interroga GET /v1/tasks/{task_id} finché status non è succeeded.
- Leggi la vetrina in results.items; has_more e results.next_cursor seguono le normali regole di paginazione e restano vuoti per questa singola riga.
curl -X POST "https://api.socq.ai/v1/amazon/shop" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.amazon.com/shop/sydneydelrey"}'Casi d’uso della Amazon Storefront API
- Trovare creator per l’affiliazione: Confronta is_top_creator, il numero di liste di idee e il loro items_count tra più vetrine per scegliere i creator che selezionano con costanza prodotti della tua categoria.
- Seguire i consigli di un creator: Rileggi una vetrina ogni settimana e confronta titoli delle liste, items_count e trending_picks per vedere quali liste stagionali crescono e quali prodotti passano in primo piano.
- Collegare vetrina e canali social: Usa social_urls per associare ogni vetrina ai profili TikTok, YouTube o Pinterest del creator e tenere attività commerciale e seguito social nello stesso record.
Consigli degli esperti per la Amazon Storefront API
- Salva il dominio del marketplace insieme a ogni risultato, perché trending_picks.price è espresso nella valuta di quel marketplace.
- Usa id, il nome della vetrina preso dall’URL, come chiave, così le letture ripetute dello stesso creator restano allineate.
- Se ti servono i singoli prodotti, apri la lista o il post curato tramite il suo url; items_count e posts_count ti dicono prima quanto è grande.
API correlate
Oltre alla Amazon Storefront 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 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.