Torna alle API
Dati pubblici di TikTok Shop

TikTok Shop API

Cerca prodotti pubblici e raccogli cataloghi dei negozi, dettagli dei prodotti, recensioni dei clienti e vetrine dei creator con un unico flusso di lavoro asincrono normalizzato.

API di TikTok Shop disponibili

Scegli l’API adatta alla tua attività, dalla scoperta dei prodotti e dalla raccolta dei negozi all’arricchimento dei prodotti, all’analisi delle recensioni e alla ricerca sugli assortimenti dei creator.

Quali dati di TikTok Shop puoi recuperare?

SocQ trasforma i risultati pubblici di prodotti e recensioni di TikTok Shop in record coerenti per ricerca, monitoraggio e pipeline di dati.

Scoperta dei prodotti e cataloghi dei negozi

Cerca i prodotti per parola chiave e area geografica, oppure raccogli il catalogo pubblico a partire dall’URL di un negozio TikTok Shop noto.

Contesto di prodotti e venditori

Recupera identità del prodotto, venditore, prezzi, sconti, media, categorie, dati SKU, valutazioni, numero di recensioni e quantità vendute, quando disponibili.

Dati pubblici delle recensioni

Raccogli testo delle recensioni, valutazioni, immagini, date, contesto SKU, paese e flag espliciti sullo stato d’acquisto, quando esposti.

Vetrine di utenti e creator

Raccogli i prodotti esposti nella vetrina Shop di un utente pubblico per studiare assortimento, prezzi, brand ed engagement visibile.

SocQ e i prodotti per sviluppatori di TikTok Shop

SocQ si concentra sulla raccolta di dati pubblici supportati e su record normalizzati. Usa i prodotti ufficiali per sviluppatori di TikTok Shop quando la tua applicazione richiede l’autorizzazione del venditore o operazioni ufficiali su negozio e commercio.

FunzionalitàSocQProdotti per sviluppatori di TikTok Shop
Uso principaleRaccolta e normalizzazione dei dati pubblici supportati di TikTok ShopIntegrazioni ufficiali per i venditori, secondo il prodotto TikTok Shop applicabile e la relativa approvazione
AutenticazioneChiave API di SocQCredenziali per sviluppatori di TikTok Shop e autorizzazione del venditore applicabile
Azioni su negozio e commercioNon crea, modifica, pubblica, rimuove dalla vendita, non imposta prezzi o scorte, non evade né gestisce prodotti e ordini di TikTok ShopDipende dal prodotto ufficiale approvato e dai permessi
Dati privati o riservatiNon supportatiLimitati al prodotto ufficiale, all’autorizzazione del venditore e alla policy della piattaforma
Formato della rispostaRecord normalizzati di SocQRisposte native specifiche del prodotto

Come funzionano le API di TikTok Shop

Tutti e cinque gli endpoint condividono un ciclo di vita asincrono di invio, interrogazione e lettura dei risultati.

  1. 1. Scegli l’attività e l’input

    Parti da una parola chiave, dall’URL di un negozio pubblico, dall’URL di dettaglio di un prodotto o da un nome utente TikTok, a seconda dell’endpoint.

  2. 2. Invia e salva l’ID attività

    Invia l’input all’endpoint corrispondente, con eventuali controlli facoltativi su area geografica e risultati, poi conserva il task_id restituito.

  3. 3. Interroga e leggi i risultati

    Interroga /v1/tasks/{task_id} fino al completamento, leggi data.results.items e segui next_cursor finché has_more è true.

Inizia con la ricerca dei prodotti

Autenticati con la tua chiave API di SocQ e invia una parola chiave di prodotto. Usa un altro endpoint quando hai già l’URL di un negozio, l’URL di un prodotto o un nome utente TikTok.

curl -X POST "https://api.socq.ai/v1/tiktok-shop/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"running shoes","results_limit":100,"region":"US"}'

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

Casi d’uso comuni di TikTok Shop

Ricerca su prodotti e tendenze

Scopri i prodotti pubblici per parola chiave e mercato per confrontare assortimenti, fasce di prezzo e segnali di domanda visibili.

Monitoraggio di negozi e concorrenti

Acquisisci istantanee dei cataloghi pubblici dei negozi per seguire nel tempo prodotti in vendita, prezzi, sconti e variazioni dell’assortimento.

Analisi di prodotti e recensioni

Combina i dettagli dei prodotti con valutazioni pubbliche, testo delle recensioni, immagini, contesto SKU e flag sullo stato d’acquisto per le analisi.

Ricerca sugli assortimenti dei creator

Raccogli la vetrina pubblica di un creator per studiare prodotti in evidenza, venditori, brand, prezzi ed engagement visibile.

Limiti e policy sui dati pubblici

I risultati di TikTok Shop sono record pubblici riferiti a un preciso momento e dipendono da area geografica, visibilità, disponibilità e copertura della fonte.

  • Le API raccolgono solo dati pubblici. Prodotti e recensioni privati, rimossi, non disponibili o limitati per area geografica possono non produrre record.
  • L’area geografica è impostata per impostazione predefinita su US dove supportato. Disponibilità dei prodotti, prezzi, classifiche e visibilità delle recensioni possono variare da mercato a mercato e cambiare dopo la raccolta.
  • results_limit è un tetto, non una garanzia. I campi di venditore, prezzo, media, SKU, recensioni e stato d’acquisto possono essere vuoti se la fonte non li espone.
  • SocQ è un servizio di dati pubblici in sola lettura, non un’API ufficiale di TikTok. Non modifica inserzioni, recensioni, vetrine, inventario, prezzi, spedizioni né impostazioni di evasione degli ordini.

Domande frequenti sull’API di TikTok Shop

Che cos’è l’API di TikTok Shop?

L’API di TikTok Shop è un insieme di API di SocQ per cercare e raccogliere prodotti pubblici, cataloghi dei negozi, dettagli dei prodotti, recensioni e vetrine dei creator. SocQ trasforma i risultati supportati in record coerenti per analisi e flussi di lavoro sui dati.

Quale API di TikTok Shop devo usare?

Usa Search per la scoperta guidata da parole chiave, Products per il catalogo pubblico di un negozio, Product per un singolo prodotto noto, Product Reviews per il feedback dei clienti e User Showcase per i prodotti esposti da un utente o creator TikTok pubblico.

Devo collegare un account TikTok?

No, non serve alcun OAuth TikTok del cliente. Le richieste si autenticano con una chiave API di SocQ. SocQ non è un’API ufficiale di TikTok e accede solo ai dati pubblici supportati.

Come si calcola il costo dell’API di TikTok Shop?

Ogni record restituito da Search, Products, Product o User Showcase costa 0,7 crediti SocQ. Ogni record salvato di Product Reviews costa 0,3 crediti. I risultati vuoti non hanno alcun costo per i risultati.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.