amazon/
shop

Legge la vetrina di un creator Amazon dal suo URL amazon.com/shop e restituisce profilo, account social collegati, liste di idee con numero di articoli, post curati e prodotti di tendenza con prezzo.

Amazon Storefront API

URL della vetrina in ingresso
Liste di idee
Post curati
Prodotti di tendenza
0,5 crediti per richiesta
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 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

ParametriObbligatorioDescrizione
urlObbligatorioL’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.

  1. Invia {"url": "https://www.amazon.com/shop/sydneydelrey"} in POST a /v1/amazon/shop.
  2. Interroga GET /v1/tasks/{task_id} finché status non è succeeded.
  3. 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.

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.

Esplora altre piattaforme

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

Amazon Storefront API — FAQ

Amazon Storefront API è un’interfaccia programmatica che legge la vetrina di un creator Amazon a partire dal suo URL. Restituisce profilo del creator, account social collegati, liste di idee, post curati e prodotti di tendenza con prezzo.

Invia un URL di vetrina per richiesta, nel formato amazon.com/shop/nome. Le vetrine sugli altri marketplace Amazon, come amazon.it/shop/nome, si leggono allo stesso modo.

Ogni richiesta restituisce le liste di idee, i post curati e i prodotti di tendenza visibili nella prima pagina della vetrina. Ogni lista e ogni post curato riporta link e numero di prodotti, così puoi valutarne la dimensione e aprirlo direttamente.

Ogni prodotto di tendenza contiene il link nella vetrina, l’immagine del prodotto, il prezzo attuale nella valuta del marketplace e l’etichetta di sconto quando la vetrina ne mostra una.

Ogni richiesta legge una vetrina e costa 0,5 crediti; se la vetrina non esiste, l’attività fallisce e viene rimborsata per intero.