tiktok/
user-videos

Sammeln Sie öffentliche TikTok-Videos zu einem oder mehreren Benutzernamen – mit Bildunterschriften, Creators, Medien, Zeitstempeln und sichtbarer Interaktion als normalisierte, dem Konto zugeordnete Datensätze.

TikTok User Videos API

Feeds bekannter Konten
Benutzernamen im Stapel
Kontext des Quellkontos
0,5 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 User Videos

Videos eines TikTok-Kontos sind öffentliche Beiträge im Profil-Feed mit Bildunterschriften, Creator-Identität, Medien- und Sound-Kontext, Veröffentlichungsangaben und sichtbarer Interaktion. Diese dem Konto zugeordneten Inhaltsdatensätze unterstützen Creator-Inventare, Vergleiche des Veröffentlichungsverhaltens, Creative-Recherche und Leistungs-Momentaufnahmen.

Funktionen der TikTok User Videos API

  • Profil-Feeds bekannter KontenAkzeptiert einen oder mehrere TikTok-Benutzernamen und durchläuft jeden öffentlichen Video-Feed unabhängig, sodass die Ergebnisse auf die gewählten Konten beschränkt bleiben und nicht aus einer Keyword- oder Hashtag-Suche stammen.
  • Video- und Creator-DetailsLiefert Video-IDs und -URLs, Bildunterschriften, Sprache, Creator-Identität, Medienverweise, Dauer, Hashtags, Erwähnungen, Musik und öffentliche Inhaltsmerkmale.
  • Interaktionssignale mit ZeitstempelVerbindet die sichtbaren Zahlen zu Aufrufen, Likes, Kommentaren, Shares, Speicherungen und Reposts mit Veröffentlichungs- und Erfassungszeit zu Momentaufnahmen der Videos eines Kontos.
  • Kontrollierter Durchlauf pro KontoWendet die Sortierung latest oder popular und optional eine Region auf jeden Benutzernamen an, entfernt dabei doppelte Video-IDs und hält das angeforderte Limit pro Konto ein.

Parameter der TikTok User Videos API

ParameterErforderlichBeschreibung
usernamesErforderlichErforderliche Liste mit einem oder mehreren öffentlichen TikTok-Benutzernamen; jeder Wert darf ein führendes @ enthalten oder weglassen.
results_limitOptionalMaximal angeforderte Videos pro Benutzername; Standard ist 100, akzeptiert werden ganze Zahlen von 20 bis 2.000.
sort_byOptionalOptionale Sortierung des Profil-Feeds: standardmäßig latest oder popular für Ergebnisse in der Rangfolge der Quelle.
regionOptionalOptionaler zweibuchstabiger Regionscode, der in Großbuchstaben übergeben wird, um die Verfügbarkeit bei der Quelle zu beeinflussen.

So verwenden Sie die TikTok User Videos API

Senden Sie bekannte öffentliche Benutzernamen als asynchrone Aufgabe und lesen Sie die normalisierten, dem Konto zugeordneten Videos anschließend per Cursor-Paginierung der Ergebnisse aus.

  1. Bereiten Sie einen oder mehrere öffentliche TikTok-Benutzernamen vor und wählen Sie die Sortierung latest oder popular, optional eine zweibuchstabige Region und ein results_limit pro Benutzername.
  2. Senden Sie usernames und die optionalen Steuerparameter per POST an /v1/tiktok/user-videos und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
  4. Lesen Sie data.results.items aus /v1/tasks/{task_id}?limit=50 und fahren Sie mit results.next_cursor fort, solange results.has_more den Wert true hat.
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.

Anwendungsfälle der TikTok User Videos API

  • Video-Inventare von Creators: Indexieren Sie ausgewählte Konten nach Video-ID, kanonischer URL, Bildunterschrift, Medien, Veröffentlichungszeit und extra.input_username, um einen nachvollziehbaren Katalog öffentlicher Inhalte zu pflegen.
  • Vergleich von Veröffentlichung und Interaktion: Vergleichen Sie created_at mit den sichtbaren Aufrufen, Likes, Kommentaren, Shares, Speicherungen und Reposts bekannter Konten und behalten Sie collected_at als Zeitpunkt der Momentaufnahme.
  • Recherche zu Creative-Formaten: Nutzen Sie Bildunterschriften, Sprache, Dauer, Hashtags, Erwähnungen, Musik, Medientyp und öffentliche Inhaltsmerkmale, um wiederkehrende Creative-Muster in ausgewählten Profil-Feeds zu vergleichen.

Profi-Tipps zur TikTok User Videos API

  • Bringen Sie vor dem Senden jeden Handle in eine einheitliche Form und entfernen Sie Duplikate, denn creator und @creator bezeichnen dasselbe Konto, könnten sonst aber getrennt verarbeitet werden.
  • Wählen Sie results_limit mit Blick auf die Anzahl der Benutzernamen, denn das Limit und die erste Credit-Schätzung gelten unabhängig für jedes übergebene Konto.
  • Verwenden Sie latest für eine auf Aktualität ausgerichtete Erfassung und behandeln Sie popular als Reihenfolge der Quelle und nicht als von SocQ berechneten Wert.
  • Verwenden Sie region nur zur Steuerung der Verfügbarkeit; deuten Sie es nicht als Beleg dafür, dass ein zurückgegebenes Video in dieser Region entstanden ist.
  • Entfernen Sie beim Zusammenführen wiederholter Aufgaben Duplikate anhand der Video-id und behalten Sie extra.input_username und collected_at für die Zuordnung zum Konto und den Zeitpunkt der Momentaufnahme.
  • Behandeln Sie optionale Felder zu Creator, Interaktion, Medien, Musik und Inhaltsmerkmalen als nullable, maskieren Sie öffentliche Bildunterschriften vor der Anzeige und gehen Sie nicht davon aus, dass Medien-URLs der Quelle dauerhaft gültig sind.

Ergänzend zur TikTok User 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 Videos API — Creator, Bildunterschrift, Medien, Musik, Tags, Erwähnungen und Interaktionen aus Video-URLs abrufen.
  • 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 Song API — Öffentliche Sound-Metadaten per Clip-ID oder Musik-URL abrufen.

Weitere Plattformen entdecken

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

TikTok User Videos API — FAQ

TikTok User Videos API ist eine Schnittstelle zum Sammeln öffentlicher Profil-Feed-Videos von einem oder mehreren TikTok-Benutzernamen. Sie liefert normalisierte Video-Identität, Bildunterschriften, Creator- und Medienkontext, Zeitstempel, sichtbare Interaktion und den Quell-Benutzernamen.

Senden Sie die Benutzernamen als nicht leeres Array. Ein führendes @ wird akzeptiert, doch wenn Sie die Handles vor dem Senden normalisieren und Duplikate entfernen, wird dasselbe Konto nicht mehrfach verarbeitet.

results_limit ist ein Maximum pro Benutzername von 20 bis 2.000, Standard ist 100. Jeder Profil-Feed wird unabhängig durchlaufen und kann enden, bevor dieses Maximum erreicht ist.

latest ist die Standardsortierung des Profil-Feeds, während popular Ergebnisse in der Rangfolge der Quelle anfordert. popular ist kein von SocQ berechneter Wert; behalten Sie daher beim Vergleich von Aufgabenausgaben die gewählte Sortierung bei.

region akzeptiert einen optionalen zweibuchstabigen Code und kann beeinflussen, welche Videos die Quelle bereitstellt. Er legt nicht fest, wo ein Video entstanden ist oder wo sich sein Publikum befindet.

Ein Datensatz kann Video-Identität und URL, Bildunterschrift und Sprache, Creator-Details, sichtbare Interaktion, Medien und Dauer, Hashtags, Erwähnungen, Musik, Zeitstempel, öffentliche Inhaltsmerkmale und extra.input_username enthalten.

Zurückgegeben werden nur Videos, die über den öffentlichen Profil-Feed bereitgestellt werden. Private, eingeschränkte, gelöschte oder ausgeblendete Videos können fehlen, und die Erfassung endet außerdem, wenn der Feed endet, sein Cursor nicht weiter vorrückt oder die Obergrenze von 100 Seiten erreicht ist.

Jedes gespeicherte normalisierte Video kostet 0,5 Credits, ohne Grundgebühr pro Aufgabe. Die erste Schätzung multipliziert results_limit oder den Standardwert mit der Anzahl der Benutzernamen, während die endgültige Nutzung den tatsächlich gespeicherten Datensätzen folgt; ohne gespeicherte Videos fallen keine Ergebniskosten an.