tiktok/
user-videos

Raccogli i video pubblici di TikTok da uno o più nomi utente, con didascalie, creator, media, timestamp ed engagement visibile come record normalizzati collegati agli account.

TikTok User Videos API

Feed di account noti
Nomi utente in batch
Contesto dell’account di origine
0,5 crediti per risultato
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

TikTok User Videos

I video di TikTok User Videos sono post pubblici del feed del profilo, con didascalie, identità del creator, contesto di media e audio, dettagli di pubblicazione ed engagement visibile. Questi record di contenuto collegati agli account supportano inventari dei creator, confronti di pubblicazione, ricerca creativa e istantanee delle prestazioni.

Funzionalità della TikTok User Videos API

  • Feed del profilo di account notiAccetta uno o più nomi utente di TikTok e percorre ogni feed video pubblico in modo indipendente, mantenendo i risultati limitati agli account selezionati e non alla scoperta per parola chiave o hashtag.
  • Dettagli di video e creatorRestituisce ID e URL dei video, didascalie, lingua, identità del creator, riferimenti ai media, durata, hashtag, menzioni, musica e flag pubblici del contenuto.
  • Segnali di engagement con timestampAbbina i conteggi visibili di visualizzazioni, Mi piace, commenti, condivisioni, salvataggi e repost agli orari di pubblicazione e di raccolta per ottenere record puntuali dei video degli account.
  • Scansione controllata per accountApplica a ogni nome utente l’ordinamento per più recenti o più popolari e una regione facoltativa, deduplicando gli ID dei video e rispettando il limite per account richiesto.

Parametri della TikTok User Videos API

ParametriObbligatorioDescrizione
usernamesObbligatorioElenco obbligatorio di uno o più nomi utente pubblici di TikTok; ogni valore può includere o omettere la @ iniziale.
results_limitFacoltativoNumero massimo di video richiesti per ogni nome utente; il valore predefinito è 100 e sono accettati numeri interi da 20 a 2.000.
sort_byFacoltativoOrdinamento facoltativo del feed del profilo: latest per impostazione predefinita, oppure popular per i risultati ordinati dalla fonte.
regionFacoltativoCodice regione facoltativo di due lettere, passato in maiuscolo per influenzare la disponibilità nella fonte.

Come usare la TikTok User Videos API

Invia nomi utente pubblici noti come attività asincrona, poi leggi i video normalizzati collegati agli account con la paginazione a cursore dei risultati.

  1. Prepara uno o più nomi utente pubblici di TikTok e scegli l’ordinamento latest o popular, una regione facoltativa di due lettere e un results_limit per ogni nome utente.
  2. Invia con POST usernames e i controlli facoltativi a /v1/tiktok/user-videos, 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/user-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@loganpaul"],"results_limit":20,"sort_by":"latest"}'

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

Casi d’uso della TikTok User Videos API

  • Inventari dei video dei creator: Indicizza gli account selezionati per ID del video, URL canonico, didascalia, media, ora di pubblicazione ed extra.input_username per mantenere un catalogo di contenuti pubblici tracciabile.
  • Confronto tra pubblicazione ed engagement: Confronta created_at con visualizzazioni, Mi piace, commenti, condivisioni, salvataggi e repost visibili tra account noti, conservando collected_at come orario dell’istantanea.
  • Ricerca sui formati creativi: Usa didascalie, lingua, durata, hashtag, menzioni, musica, tipo di media e flag pubblici del contenuto per confrontare gli schemi creativi ricorrenti nei feed dei profili selezionati.

Consigli degli esperti per la TikTok User Videos API

  • Normalizza ogni handle in un’unica forma e deduplica prima dell’invio, perché creator e @creator indicano lo stesso account ma altrimenti possono essere elaborati separatamente.
  • Scegli results_limit tenendo conto del numero di nomi utente, perché il limite e la stima iniziale dei crediti si applicano in modo indipendente a ogni account inviato.
  • Usa latest per una raccolta orientata alla recenza e considera popular come ordinamento della fonte e non come punteggio calcolato da SocQ.
  • Usa region solo come controllo di disponibilità; non interpretarla come prova che un video restituito sia stato prodotto in quell’area geografica.
  • Quando combini attività ripetute, deduplica per id del video conservando extra.input_username e collected_at per l’attribuzione dell’account e l’orario dell’istantanea.
  • Tratta i campi facoltativi di creator, engagement, media, musica e flag del contenuto come nullable, fai l’escape delle didascalie pubbliche prima di mostrarle ed evita di presumere che gli URL dei media della fonte siano permanenti.

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

  • TikTok Profiles API — Recupera identità del profilo pubblico, bio, flag dell’account e conteggi del pubblico a partire dal nome utente.
  • 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 Trending Feed API — Raccoglie il feed video pubblico attuale di una regione con creator, didascalia, copertina, data ed engagement visibile.
  • 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.

Esplora altre piattaforme

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

TikTok User Videos API — FAQ

TikTok User Videos API è un’interfaccia programmatica per raccogliere i video pubblici del feed del profilo da uno o più nomi utente di TikTok. Restituisce identità normalizzata dei video, didascalie, contesto di creator e media, timestamp, engagement visibile e il nome utente di origine.

Invia i nomi utente come array non vuoto. Una @ iniziale è accettata, ma normalizzare e deduplicare gli handle prima dell’invio evita di elaborare lo stesso account più di una volta.

results_limit è un massimo per nome utente, da 20 a 2.000, con valore predefinito 100. Ogni feed del profilo viene percorso in modo indipendente e può finire prima di raggiungere quel massimo.

latest è l’ordinamento predefinito del feed del profilo, mentre popular richiede risultati ordinati dalla fonte. popular non è un punteggio calcolato da SocQ, quindi conserva l’ordinamento scelto quando confronti gli output delle attività.

region accetta un codice facoltativo di due lettere e può influenzare quali video la fonte rende disponibili. Non stabilisce dove è stato creato un video né dove si trova il suo pubblico.

Un record può contenere identità e URL del video, didascalia e lingua, dettagli del creator, engagement visibile, media e durata, hashtag, menzioni, musica, timestamp, flag pubblici del contenuto ed extra.input_username.

Possono essere restituiti solo i video esposti dal feed pubblico del profilo. I video privati, limitati, eliminati o nascosti possono mancare, e la raccolta si ferma anche quando il feed finisce, il suo cursore non avanza più o viene raggiunto il tetto di 100 pagine.

Ogni video normalizzato salvato costa 0,5 crediti, senza costo di base per l’attività. La stima iniziale moltiplica results_limit o il suo valore predefinito per il numero di nomi utente, mentre l’utilizzo finale segue i record effettivamente salvati; nessun video salvato significa nessun costo per i risultati.