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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich (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_id | Erforderlich (mindestens eines) | Eine bekannte Benutzerkennung aus 1 bis 256 ASCII-Buchstaben, Ziffern, Doppelpunkten, Unterstrichen oder Bindestrichen. Geben Sie user_id oder url an. |
results_limit | Optional | Die 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.
- Bereiten Sie entweder eine Douyin-Profil-URL auf douyin.com oder iesdouyin.com mit einem Pfad /user/{identifier} oder eine bekannte user_id vor.
- 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.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder fehlschlägt.
- 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 resultsAnwendungsfä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.
Verwandte APIs
Ergänzend zur Douyin User Videos API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Douyin-Daten benötigen.
- Douyin Live Room Detail API — Einen bekannten Douyin-Livestream über die numerische Raum-ID abrufen – mit normalisiertem Raumkontext, Identität des Hosts, Medien und sichtbaren Zuschauerzahlen.
- Douyin User Profile API
- Douyin Video Comments API
- Douyin Video Detail API
- Douyin Video Search API