tiktok/
videos

Recupera i metadati dei video pubblici di TikTok da uno o più URL diretti, con creator, didascalia, media, musica, hashtag, menzioni ed engagement normalizzati.

TikTok Videos API

Arricchimento degli URL
Analisi creativa
Istantanee delle prestazioni
0,7 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 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

ParametriObbligatorioDescrizione
urlsObbligatorioElenco 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.

  1. Raccogli i link diretti ai video, normalizza il formato degli URL e deduplica l’elenco.
  2. Invia con POST l’array urls a /v1/tiktok/videos e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

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

TikTok Videos API — FAQ

TikTok Videos API recupera i metadati dei video accessibili pubblicamente da uno o più URL diretti di video TikTok. Restituisce dati normalizzati su creator, didascalia, media, musica, hashtag, menzioni, pubblicazione ed engagement.

Inserisci uno o più URL diretti di video TikTok nell’array urls. Ogni URL viene elaborato come ricerca di un video noto.

Sì. urls accetta più link diretti per l’arricchimento in batch di elenchi di video di campagne, creator o concorrenti.

I risultati includono ID del video, URL canonico, didascalia, lingua, ora di pubblicazione, hashtag, menzioni e i campi pubblici di identità e profilo del creator.

I risultati possono includere i conteggi di Mi piace, commenti, visualizzazioni, condivisioni, salvataggi e repost, insieme ai metadati di durata, media e musica.

Salva le metriche di engagement con collected_at, poi confronta un insieme di video selezionato in orari di raccolta simili.

Ogni risultato di video normalizzato restituito costa 0,7 crediti.