TikTok Videos
I video di TikTok sono post in formato breve con didascalie, contesto del creator, media, musica, durata, hashtag, menzioni, dettagli di pubblicazione ed engagement visibile. Questi segnali di contenuto supportano la ricerca sulle tendenze, l’analisi creativa, la revisione delle campagne e il confronto delle prestazioni.
Funzionalità della TikTok Videos API
- Ricerca batch degli URL dei videoConverte un batch di link di video TikTok in record di contenuto coerenti.
- Identità stabile del videoRisolve identità e origine del video tramite ID del video e URL canonico.
- Campi di contenuto e creatorEstrae didascalia, lingua, ora di pubblicazione, creator, durata e contesto della copertina.
- Campi di contesto creativoPorta hashtag, menzioni, musica e flag del contenuto nell’analisi creativa.
- Metriche puntualiAbbina i conteggi di engagement visibili a collected_at per ottenere istantanee delle prestazioni.
Parametri della TikTok Videos API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di URL diretti di video TikTok attualmente accessibili pubblicamente. |
Come usare la TikTok Videos API
Trasforma i link di segnalibri, report o sistemi interni in un inventario di video pronto per l’analisi.
- Raccogli i link diretti ai video, normalizza il formato degli URL e deduplica l’elenco.
- Invia con POST l’array urls a /v1/tiktok/videos e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
- Leggi data.results.items. Quando has_more è true, continua con next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.tiktok.com/@nasa/video/7412345678901234567"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della TikTok Videos API
- Analisi degli schemi di contenuto: Combina didascalie, hashtag, menzioni, musica e durata per confrontare gli elementi ricorrenti nei video selezionati.
- Report sui video delle campagne: Cattura visualizzazioni ed engagement per un insieme di asset selezionato e confronta in modo coerente le prestazioni delle campagne.
- Cataloghi di asset video: Indicizza i contenuti per ID del video, URL canonico, copertina, creator e ora di pubblicazione per un recupero rapido.
- Tagging di argomenti e formati: Usa lingua, didascalie, hashtag e musica per classificare temi, formati e pubblici di destinazione.
Consigli degli esperti per la TikTok Videos API
- Unisci gli asset duplicati per id e conserva url per la revisione e la navigazione verso la fonte.
- Salva published_at come ora di uscita e collected_at come orario dell’istantanea delle metriche.
- Combina didascalia, hashtag, menzioni e musica in caratteristiche di contenuto ricercabili.
- Quando views è presente e maggiore di zero, usalo come denominatore per i rapporti di Mi piace, commenti e condivisioni.
- Collega i record di Comments allo stesso ID del video per confrontare le prestazioni dell’asset con la risposta del pubblico.
- Raccogli un insieme di confronto in momenti ravvicinati, così le istantanee di engagement restano significative.
API correlate
Oltre alla TikTok 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 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 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 Fake Views Checker API — Assegna all’URL di un video un punteggio sulle visualizzazioni false, con le visualizzazioni false stimate e il livello di traffico.
- 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 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 Comment Keywords API