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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
region | Obbligatorio | Valore 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_limit | Facoltativo | Limite 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à.
- 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.
- Invia con POST region e results_limit a /v1/tiktok/trending-feed, poi salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché lo stato diventa succeeded o failed.
- 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.
API correlate
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.
- TikTok Profiles API
- TikTok Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API