douyin/
user-videos

Bis zu 20 öffentliche Videos aus einer Douyin-Profil-URL oder einer bekannten Benutzer-ID erfassen – mit normalisiertem Inhalt, Autor, Medien, Dauer, Zeitstempeln und sichtbaren Interaktionsfeldern.

Douyin User Videos API

Profil-URL oder Benutzer-ID
Bis zu 20 Videos
Normalisierte Reel-Video-Datensätze
0,1 Credits pro Anfrage
Bereit
Bereit

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

README

Von SocQ · Aktualisiert am

Douyin User Videos

Dieser Endpunkt wandelt die Identität eines Douyin-Creators in einen einseitigen Satz öffentlicher Videodatensätze um. Jeder Datensatz kann – sofern die Quelle sie liefert – Bildunterschrift, Autorenkontext, Quell-URL, Veröffentlichungs- und Erfassungszeit, Medien, Dauer sowie sichtbare Zahlen zu Wiedergaben, Likes, Kommentaren, Shares oder Aufrufen enthalten.

Funktionen der Douyin User Videos API

  • Zwei Wege, einen Creator zu identifizierenÜbergeben Sie eine unterstützte Douyin-Profil-URL oder eine bekannte user_id. Sind beide Felder vorhanden, wird die direkte user_id verwendet.
  • Ausdrücklich auf eine Seite begrenztWählen Sie 1 bis 20 angeforderte Ergebnisse, wobei 20 Standardwert und Höchstwert ist; die Anfrage an den Anbieter beginnt immer bei der ersten Seite.
  • Video- und Creator-Kontext zusammenBehält normalisierte Bildunterschriften, öffentliche Autorenfelder, Quell-URLs, Zeitstempel, Medienverweise und die Dauer in jedem Reel-Video-Datensatz bei.
  • Interaktionsfelder für die BeobachtungBewahrt die verfügbaren Wiedergaben, Likes, Kommentare, Shares und Aufrufe mit collected_at auf, sodass jede sichtbare Zahl an ihre Erfassungszeit gebunden bleibt.

Parameter der Douyin User Videos API

ParameterErforderlichBeschreibung
urlErforderlich (mindestens eines)Ein Verweis auf ein Douyin-Profil, dessen Hostname douyin.com, iesdouyin.com oder eine Subdomain ist und dessen Pfad /user/{identifier} enthält. Geben Sie url oder user_id an; user_id hat Vorrang, wenn beide vorhanden sind.
user_idErforderlich (mindestens eines)Eine bekannte Benutzerkennung aus 1 bis 256 ASCII-Buchstaben, Ziffern, Doppelpunkten, Unterstrichen oder Bindestrichen. Geben Sie user_id oder url an.
results_limitOptionalDie angeforderte Anzahl von Datensätzen aus der einzelnen Seite des Anbieters. Akzeptiert ganze Zahlen von 1 bis 20; der Standardwert ist 20.

So verwenden Sie die Douyin User Videos API

Senden Sie die Identität eines öffentlichen Creators, verfolgen Sie die asynchrone Aufgabe und lesen Sie dann die gespeicherten normalisierten Videodatensätze.

  1. Bereiten Sie entweder eine Douyin-Profil-URL auf douyin.com oder iesdouyin.com mit einem Pfad /user/{identifier} oder eine bekannte user_id vor.
  2. Senden Sie die Identität und optional ein results_limit von 1 bis 20 per POST an /v1/douyin/user-videos und speichern Sie task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder fehlschlägt.
  4. Lesen Sie data.results.items; folgen Sie next_cursor nur für weitere, bereits in SocQ gespeicherte Datensätze und nicht für eine weitere Seite beim Anbieter.
curl -X POST "https://api.socq.ai/v1/douyin/user-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"'"$DOUYIN_PROFILE_URL"'","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and use next_cursor only for stored results

Anwendungsfälle der Douyin User Videos API

  • Momentaufnahmen des Creator-Feeds: Speichern Sie eine begrenzte Menge öffentlicher Videos und Erfassungszeitstempel eines Creators zu einem gewählten Beobachtungszeitpunkt.
  • Anreicherung von Videokatalogen: Ergänzen Sie einen bestehenden Creator-Datensatz um normalisierte Bildunterschriften, Autoridentität, Quell-URLs, Veröffentlichungszeit, Dauer und verfügbare Medien.
  • Prüfung von Gestaltung und Format: Sehen Sie sich die zurückgegebenen Bildunterschriften, die Dauer und die Medienfelder an, um die verfügbaren Videos nach inhaltlicher Gestaltung oder Format zu ordnen.
  • Interaktionsvergleich innerhalb einer Momentaufnahme: Vergleichen Sie die verfügbaren Zahlen zu Wiedergaben, Likes, Kommentaren, Shares und Aufrufen über die zurückgegebenen Videos hinweg und behalten Sie dabei collected_at bei.

Profi-Tipps zur Douyin User Videos API

  • Verwenden Sie pro Anfrage bevorzugt ein Identitätsfeld. Sind url und user_id beide enthalten, wählt das Backend user_id.
  • Prüfen Sie Host und Pfad /user/{identifier} der URL vor dem Senden; eine allgemeine Douyin-Video-URL erfüllt die Anforderung dieses Endpunkts nicht.
  • Setzen Sie results_limit nur, wenn weniger als die standardmäßigen 20 Datensätze nützlich sind; es muss eine ganze Zahl von 1 bis 20 sein.
  • Behandeln Sie den Cursor der Aufgabenergebnisse nicht als Quell-Cursor von Douyin. Die Anfrage an die Quelle umfasst eine Seite, deren Cursor beim Anbieter auf der ersten Seite festgelegt ist.
  • Lassen Sie optionale Angaben zu Autor, Medien, Dauer und Veröffentlichungszeit sowie einzelne Kennzahlen null oder leer sein und nutzen Sie beim Speichern von Beobachtungen id zusammen mit collected_at.

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

Weitere Plattformen entdecken

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

Douyin User Videos API — FAQ

Douyin User Videos API liefert normalisierte öffentliche Videodatensätze eines Creators, darunter – sofern verfügbar – Identität, Bildunterschrift, Autorenkontext, Quell-URL, Zeitstempel, Medien, Dauer und sichtbare Interaktionsfelder.

Jedes der beiden Felder erfüllt die Eingabeanforderung. Eine URL muss einen unterstützten Douyin-Host verwenden und /user/{identifier} enthalten; eine bekannte user_id kann direkt angegeben werden und setzt sich durch, wenn beide Felder vorhanden sind.

Es steuert die angeforderte Anzahl von Datensätzen der einen Seite beim Anbieter. Der Wert muss eine ganze Zahl von 1 bis 20 sein; der Standardwert ist 20.

Ein Ergebnis kann Wiedergaben, Likes, Kommentare, Shares und Aufrufe enthalten. Jedes Feld ist optional, daher bleiben nicht verfügbare Quellwerte null und werden nicht abgeleitet.

Nein. Die Anfrage an den Anbieter nutzt nur die erste Seite. next_cursor im SocQ-Aufgabenergebnis paginiert nur Datensätze, die für diese Aufgabe bereits gespeichert sind.

Jede erfolgreiche Aufgabe von Douyin User Videos kostet pauschal 0,10 SocQ-Credits, unabhängig von der Zahl der Datensätze innerhalb der Obergrenze von 20.