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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Erforderliche Liste mit einem oder mehreren öffentlichen TikTok-Benutzernamen; jeder Wert darf ein führendes @ enthalten oder weglassen. |
results_limit | Optional | Maximal angeforderte Videos pro Benutzername; Standard ist 100, akzeptiert werden ganze Zahlen von 20 bis 2.000. |
sort_by | Optional | Optionale Sortierung des Profil-Feeds: standardmäßig latest oder popular für Ergebnisse in der Rangfolge der Quelle. |
region | Optional | Optionaler 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.
- 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.
- Senden Sie usernames und die optionalen Steuerparameter per POST an /v1/tiktok/user-videos und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
- 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.
Verwandte APIs
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.
- 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