tiktok/
trending-feed

Raccogli il feed video pubblico corrente di TikTok per un codice regione, con ID dei video, didascalie, creator, immagini di copertina, timestamp ed engagement visibile.

TikTok Trending Feed API

Feed regionale
Video normalizzati
Istantanea corrente
0,7 crediti per risultato
Pronto
README

A cura di SocQ · Aggiornato il

TikTok Trending Feed

I video di TikTok Trending Feed sono voci pubbliche del feed esposte per un contesto regionale, con identità di video e creator, didascalie, immagini di copertina, timestamp ed engagement visibile. Questi segnali di contenuto e di prestazioni supportano istantanee di scoperta regionale, ricerca creativa e confronti puntuali nel tempo.

Funzionalità della TikTok Trending Feed API

  • Feed pubblico per regioneAccetta un valore region non vuoto e raccoglie il feed video pubblico corrente esposto per quel contesto regionale della richiesta.
  • Dettagli normalizzati di video e creatorRestituisce ID e URL di origine dei video, didascalie, identità del creator, riferimenti alle immagini di copertina e timestamp di creazione e di raccolta in record coerenti.
  • Metriche di engagement visibiliMantiene insieme i conteggi pubblici di visualizzazioni, Mi piace, commenti, condivisioni e salvataggi per ogni video restituito.
  • Istantanea corrente con limiteTaglia una singola risposta del feed regionale a results_limit senza seguire la continuazione della fonte, conservando un campione corrente del feed e non classifiche o serie storiche.

Parametri della TikTok Trending Feed API

ParametriObbligatorioDescrizione
regionObbligatorioValore region obbligatorio e non vuoto. Il backend rimuove gli spazi e lo converte in maiuscolo; usa un codice regione standard di due lettere come US per il contesto regionale desiderato.
results_limitFacoltativoLimite intero facoltativo da 4 a 2.000; il valore predefinito è 100 e taglia la singola risposta del feed, che può contenere meno video.

Come usare la TikTok Trending Feed API

Invia una richiesta di feed regionale come attività asincrona, poi leggi i relativi video normalizzati con la paginazione a cursore dei risultati dell’attività.

  1. Inserisci un valore region non vuoto; usa un codice standard di due lettere come US per il contesto regionale desiderato e scegli un results_limit da 4 a 2.000 oppure mantieni il valore predefinito 100.
  2. Invia con POST region e results_limit a /v1/tiktok/trending-feed, poi salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché lo stato diventa succeeded o failed.
  4. Leggi data.results.items da /v1/tasks/{task_id}?limit=50 e continua con results.next_cursor finché results.has_more è true.
curl -X POST "https://api.socq.ai/v1/tiktok/trending-feed" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region":"US","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

Casi d’uso della TikTok Trending Feed API

  • Cattura un’istantanea di scoperta regionale: Salva ID dei video, URL di origine, didascalie, creator e collected_at da una singola richiesta di feed regionale per documentare l’insieme esposto pubblicamente al momento della raccolta.
  • Campiona gli schemi creativi correnti: Esamina didascalie, nomi dei creator, immagini di copertina e orari di creazione per confrontare il mix creativo visibile in un feed regionale selezionato.
  • Confronta l’engagement visibile: Usa i conteggi di visualizzazioni, Mi piace, commenti, condivisioni e salvataggi con collected_at per confrontare i segnali pubblici di engagement tra i video restituiti.

Consigli degli esperti per la TikTok Trending Feed API

  • Usa un codice regione standard di due lettere anche se il runtime attuale richiede solo un valore non vuoto; il backend rimuove gli spazi e converte il valore in maiuscolo.
  • Considera results_limit un tetto e non un numero atteso, perché l’endpoint taglia una singola risposta del feed e non richiede le pagine di continuazione della fonte.
  • Tratta region come contesto di disponibilità del feed e non come prova dell’origine di un video; extra.region è un dato a livello di riga e può essere vuoto o diverso dalla richiesta.
  • Usa i cursori dei risultati dell’attività solo per scorrere i record già salvati da SocQ; non recuperano un’altra pagina dal feed regionale.
  • Quando confronti esecuzioni ripetute, deduplica per id del video e conserva collected_at, perché la composizione e l’ordine del feed possono cambiare tra una richiesta e l’altra.
  • Gestisci i campi del creator, le metriche, i media di copertina, i timestamp e i valori extra come nullable e fai l’escape delle didascalie pubbliche prima di mostrarle.

Oltre alla TikTok Trending Feed API, usa queste API quando ti serve un altro tipo di dati pubblici di TikTok.

  • TikTok Comments API — Raccoglie i commenti pubblici di primo livello, autori, engagement, menzioni e flag di interazione del creator.
  • TikTok Videos API — Recupera creator, didascalia, media, musica, tag, menzioni ed engagement dagli URL dei video.
  • TikTok User Videos API — Raccoglie i video pubblici del feed di un profilo a partire dal nome utente con didascalie, creator, media, date, engagement e contesto dell’account di origine.
  • TikTok Video Transcript API — Estrae, quando disponibili, il testo della trascrizione, la lingua, il formato e il contesto della fonte dagli URL dei video pubblici.
  • TikTok Song API — Recupera i metadati di un suono pubblico tramite ID della clip o URL del brano.
  • TikTok Song Videos API — Raccoglie i video pubblici che usano gli ID dei suoni indicati.

Esplora altre piattaforme

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

TikTok Trending Feed API — FAQ

TikTok Trending Feed API è un’interfaccia programmatica per raccogliere il feed video pubblico corrente di TikTok esposto per un valore region non vuoto. Restituisce identità normalizzata dei video, didascalie, creator, immagini di copertina, timestamp, engagement visibile e contesto di regione o pubblicità a livello di riga quando esposto.

Invia un valore region non vuoto; il backend rimuove gli spazi e lo converte in maiuscolo. Usa un codice standard di due lettere come US, perché la documentazione pubblica e l’interfaccia della fonte definiscono così l’input regionale previsto, anche se il runtime attuale non impone il formato di due lettere.

results_limit ha come valore predefinito 100 e accetta numeri interi da 4 a 2.000. Taglia una singola risposta del feed regionale restituita, quindi un limite più alto non attiva la continuazione della fonte e non garantisce quel numero di video.

Un record può contenere ID e URL di origine del video, didascalia, ID, nome utente e nome visualizzato del creator, conteggi visibili di visualizzazioni, Mi piace, commenti, condivisioni e salvataggi, un’immagine di copertina, orari di creazione e di raccolta, più extra.region ed extra.is_ad.

No. region controlla il contesto di disponibilità del feed per la richiesta, non la posizione del creator né l’origine del video; extra.region viene fornito per ogni riga e può essere vuoto o diverso.

No. Restituisce i video del feed attualmente esposto, senza campi normalizzati di posizione in classifica, variazione di posizione, aggregati di hashtag, classifica dei creator, classifica dei brani o serie storiche. Crea i confronti salvando gli output di attività ripetute con collected_at.

Ogni video normalizzato salvato con successo costa 0,7 crediti, senza costo di base per l’attività. La stima iniziale usa results_limit o il suo valore predefinito 100, e i crediti prepagati non utilizzati vengono rimborsati alla chiusura dell’attività.