tiktok/
videos

Rufen Sie öffentliche TikTok-Video-Metadaten aus einer oder mehreren direkten Video-URLs ab – mit normalisierten Angaben zu Creator, Bildunterschrift, Medien, Musik, Hashtags, Erwähnungen und Interaktion.

TikTok Videos API

Anreicherung per URL
Creative-Analyse
Leistungs-Momentaufnahmen
0,7 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

TikTok Videos

TikTok-Videos sind Kurzformat-Beiträge mit Bildunterschriften, Creator-Kontext, Medien, Musik, Dauer, Hashtags, Erwähnungen, Veröffentlichungsangaben und sichtbarer Interaktion. Diese Inhaltssignale unterstützen Trendforschung, Creative-Analyse, Kampagnenprüfung und Leistungsvergleiche.

Funktionen der TikTok Videos API

  • Stapelabfrage von Video-URLsWandelt einen Stapel von TikTok-Videolinks in einheitliche Inhaltsdatensätze um.
  • Stabile VideoidentitätLöst Identität und Quelle eines Videos über die Video-ID und die kanonische URL auf.
  • Inhalts- und Creator-FelderExtrahiert Bildunterschrift, Sprache, Veröffentlichungszeitpunkt, Creator, Dauer und Kontext zum Titelbild.
  • Felder zum Creative-KontextBringt Hashtags, Erwähnungen, Musik und Inhaltsmerkmale in die Creative-Analyse ein.
  • Kennzahlen als MomentaufnahmeVerbindet die sichtbaren Interaktionszahlen mit collected_at zu Leistungs-Momentaufnahmen.

Parameter der TikTok Videos API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche Liste direkter TikTok-Video-URLs, die derzeit öffentlich zugänglich sind.

So verwenden Sie die TikTok Videos API

Machen Sie aus Links aus Lesezeichen, Berichten oder internen Systemen ein Video-Inventar, das für die Analyse bereit ist.

  1. Sammeln Sie direkte Videolinks, vereinheitlichen Sie das URL-Format und entfernen Sie Duplikate aus der Liste.
  2. Senden Sie das Array urls per POST an /v1/tiktok/videos und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe succeeded oder failed erreicht.
  4. Lesen Sie data.results.items. Wenn has_more den Wert true hat, fahren Sie mit next_cursor fort.
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

Anwendungsfälle der TikTok Videos API

  • Analyse von Inhaltsmustern: Kombinieren Sie Bildunterschriften, Hashtags, Erwähnungen, Musik und Dauer, um wiederkehrende Elemente in ausgewählten Videos zu vergleichen.
  • Berichte zu Kampagnenvideos: Erfassen Sie Aufrufe und Interaktion für eine ausgewählte Menge von Assets und vergleichen Sie die Kampagnenleistung einheitlich.
  • Kataloge von Video-Assets: Indexieren Sie Inhalte nach Video-ID, kanonischer URL, Titelbild, Creator und Veröffentlichungszeitpunkt für einen schnellen Zugriff.
  • Verschlagwortung nach Thema und Format: Nutzen Sie Sprache, Bildunterschriften, Hashtags und Musik, um Themen, Formate und vorgesehene Zielgruppen zu klassifizieren.

Profi-Tipps zur TikTok Videos API

  • Führen Sie doppelte Assets anhand von id zusammen und behalten Sie url für die Prüfung und die Navigation zur Quelle.
  • Speichern Sie published_at als Veröffentlichungszeitpunkt und collected_at als Zeitpunkt der Momentaufnahme der Kennzahlen.
  • Kombinieren Sie caption, hashtags, mentions und music zu durchsuchbaren Inhaltsmerkmalen.
  • Wenn views vorhanden und größer als null ist, verwenden Sie es als Nenner für die Verhältnisse von Likes, Kommentaren und Shares.
  • Verknüpfen Sie Comments-Datensätze über dieselbe Video-ID, um die Leistung eines Assets mit der Reaktion des Publikums zu vergleichen.
  • Erfassen Sie eine Vergleichsmenge zeitlich eng beieinander, damit die Momentaufnahmen der Interaktion aussagekräftig bleiben.

Ergänzend zur TikTok Videos API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok-Daten benötigen.

  • TikTok Profiles API — Öffentliche Profilidentität, Bios, Kontomerkmale und Zahlen zur Zielgruppe per Benutzername abrufen.
  • TikTok Comments API — Öffentliche Kommentare der obersten Ebene, Autoren, Interaktionen, Erwähnungen und Merkmale zur Creator-Interaktion erfassen.
  • TikTok User Videos API — Öffentliche Videos aus dem Profil-Feed per Benutzername erfassen – mit Bildunterschriften, Creators, Medien, Zeitstempeln, Interaktionen und Kontext des Quellkontos.
  • TikTok Trending Feed API — Den aktuellen öffentlichen Video-Feed einer Region erfassen – mit Feldern zu Creator, Bildunterschrift, Cover, Zeitstempel und sichtbaren Interaktionen.
  • TikTok Video Transcript API — Verfügbaren Transkripttext, Sprache, Format und Quellkontext aus öffentlichen Video-URLs extrahieren.
  • TikTok Fake Views Checker API — Eine Video-URL auf gefälschte Aufrufe bewerten – mit geschätzten gefälschten Aufrufen und Traffic-Stufe.

Weitere Plattformen entdecken

Kombinieren Sie TikTok-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

TikTok Videos API — FAQ

TikTok Videos API ruft öffentlich zugängliche Video-Metadaten aus einer oder mehreren direkten TikTok-Video-URLs ab. Sie liefert normalisierte Daten zu Creator, Bildunterschrift, Medien, Musik, Hashtags, Erwähnungen, Veröffentlichung und Interaktion.

Tragen Sie eine oder mehrere direkte TikTok-Video-URLs in das Array urls ein. Jede URL wird als Abfrage eines bekannten Videos verarbeitet.

Ja. urls akzeptiert mehrere direkte Links für die stapelweise Anreicherung von Video-Listen zu Kampagnen, Creators oder Wettbewerbern.

Die Ergebnisse enthalten Video-ID, kanonische URL, Bildunterschrift, Sprache, Veröffentlichungszeitpunkt, Hashtags, Erwähnungen sowie öffentliche Identitäts- und Profilfelder des Creators.

Die Ergebnisse können die Zahlen zu Likes, Kommentaren, Aufrufen, Shares, Speicherungen und Reposts enthalten, zusammen mit Metadaten zu Dauer, Medien und Musik.

Speichern Sie die Interaktionskennzahlen zusammen mit collected_at und vergleichen Sie dann eine ausgewählte Videomenge zu ähnlichen Erfassungszeitpunkten.

Jedes zurückgegebene normalisierte Videoergebnis kostet 0,7 Credits.