Douyin Video Detail
Ein Datensatz für Douyin-Videodetails verbindet eine bekannte öffentliche Video-URL mit normalisierten Feldern zu Inhalt, Creator, Medien, Zeitpunkten und sichtbarer Interaktion. Er ist nützlich, wenn ein Workflow bereits einen exakten Video-Link hat und für Anreicherung, Prüfung oder spätere Vergleiche einen einheitlichen Datensatz benötigt.
Funktionen der Douyin Video Detail API
- Unterstützte Douyin-URLAkzeptiert eine URL auf douyin.com, iesdouyin.com oder einer unterstützten Subdomain. Erscheint /video/, muss darauf eine numerische ID folgen.
- Begrenztes Ergebnis für ein einzelnes VideoFührt eine einzige Detailanfrage beim Anbieter aus und speichert höchstens einen normalisierten Videodatensatz, ohne Paginierung der Quelle und ohne results_limit.
- Bildunterschrift und Creator-KontextLiefert den verfügbaren Videotext zusammen mit normalisierter Creator-ID, Benutzername, Anzeigename, Profil-URL, Avatar und Kontomerkmalen.
- Medien- und DauerfelderBehält verfügbare Video- oder Bildverweise, Vorschauen, Abmessungen, die Mediendauer und das normalisierte Feld duration_seconds bei.
- Zeitgestempelte Momentaufnahme der InteraktionKombiniert die verfügbaren Zahlen zu Likes, Kommentaren, Shares, Wiedergaben und Aufrufen mit published_at und collected_at, statt sie als Live-Zähler darzustellen.
Parameter der Douyin Video Detail API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderliche, nicht leere URL auf douyin.com, iesdouyin.com oder einer unterstützten Subdomain. Ist /video/ vorhanden, muss eine numerische ID folgen; pro Aufgabe wird nur eine URL akzeptiert. |
So verwenden Sie die Douyin Video Detail API
Senden Sie eine unterstützte Douyin-Video-URL, verfolgen Sie die asynchrone Aufgabe und lesen Sie nach dem Erfolg das gespeicherte normalisierte Ergebnis.
- Setzen Sie DOUYIN_VIDEO_URL auf eine öffentliche URL, deren Host douyin.com, iesdouyin.com oder eine Subdomain ist. Ein Segment /video/ muss, sofern vorhanden, von einer numerischen ID gefolgt werden.
- Senden Sie die Zeichenfolge url per POST an /v1/douyin/video-detail und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder fehlschlägt; Ergebnisfelder sind nicht verfügbar, solange sie unvollständig ist.
- Lesen Sie nach einem Erfolg data.results.items. Der Anbieter erzeugt höchstens einen Eintrag, während limit und next_cursor zum Leser der gespeicherten Ergebnisse von SocQ gehören.
curl -X POST "https://api.socq.ai/v1/douyin/video-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$DOUYIN_VIDEO_URL\"}"
# Poll GET /v1/tasks/{task_id}
# Read the normalized video from data.results.itemsAnwendungsfälle der Douyin Video Detail API
- Anreicherung von Katalogen bekannter Videos: Ergänzen Sie freigegebene Douyin-Video-Links um normalisierte Identität, Bildunterschrift, Creator, Veröffentlichungszeit, Dauer, Medien und Quellfelder.
- Von der Entdeckung zum Detail: Verwenden Sie eine unterstützte Video-URL aus einem Douyin-Datensatz zu Benutzervideos oder Videosuche als exakte Eingabe für eine gezielte Detailabfrage.
- Vorbereitung von Stichtagsvergleichen: Speichern Sie wiederholte erfolgreiche Ergebnisse mit collected_at, um verfügbare öffentliche Momentaufnahmen der Interaktion nach einem festgelegten Zeitplan zu vergleichen.
Profi-Tipps zur Douyin Video Detail API
- Verwenden Sie einen direkten öffentlichen Videoverweis auf einem unterstützten Hostnamen, damit der Anbieter ihn sinnvoll auflösen kann; enthält er /video/, lassen Sie die numerische Video-ID unverändert.
- Lassen Sie das Feld im Playground leer, bis Sie eine echte öffentliche Video-URL haben; dieser Endpunkt hat keinen verlässlichen allgemeinen Standardwert.
- Senden Sie pro Aufgabe eine URL und lassen Sie results_limit, Cursor und fremde IDs weg, denn die öffentliche Anfrage akzeptiert nur url.
- Behandeln Sie fehlende Felder zu Creator, Medien, Audio, Hashtags, Erwähnungen oder Interaktion als nicht verfügbar und nicht als leere Zeichenfolgen oder null.
- Nutzen Sie collected_at für den Vergleich von Kennzahlen und published_at für die Chronologie der Inhalte; sie beschreiben unterschiedliche Zeitpunkte.
- Wenn Sie zu den Videokommentaren weitergehen, übergeben Sie eine verfügbare unterstützte Video-URL an diesen separaten Endpunkt, statt anzunehmen, dass sich die Detailaufgabe auf Kommentare ausweitet.
Verwandte APIs
Ergänzend zur Douyin Video Detail 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 User Videos API
- Douyin Video Comments API
- Douyin Video Search API