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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Elenco obbligatorio di uno o più nomi utente pubblici di TikTok; ogni valore può includere o omettere la @ iniziale. |
results_limit | Facoltativo | Numero massimo di video richiesti per ogni nome utente; il valore predefinito è 100 e sono accettati numeri interi da 20 a 2.000. |
sort_by | Facoltativo | Ordinamento facoltativo del feed del profilo: latest per impostazione predefinita, oppure popular per i risultati ordinati dalla fonte. |
region | Facoltativo | Codice 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.
- 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.
- Invia con POST usernames e i controlli facoltativi a /v1/tiktok/user-videos, 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/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.
API correlate
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.
- 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 Song Videos 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