douyin/
video-detail

Eine bekannte Douyin-Video-URL in einen normalisierten Datensatz umwandeln – mit Videoidentität, Bildunterschrift, Creator-Kontext, Medien, Dauer, Zeitstempeln und, sofern verfügbar, sichtbaren Interaktionsfeldern.

Douyin Video Detail API

Unterstützte Douyin-URL
Ein normalisiertes Video
0,10 Credits pro Aufgabe
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 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

ParameterErforderlichBeschreibung
urlErforderlichErforderliche, 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.

  1. 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.
  2. Senden Sie die Zeichenfolge url per POST an /v1/douyin/video-detail und speichern Sie die zurückgegebene task_id.
  3. 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.
  4. 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.items

Anwendungsfä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.

Ergänzend zur Douyin Video Detail 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 Video Detail API — FAQ

Douyin Video Detail API ruft ein öffentliches Douyin-Video anhand einer unterstützten URL ab und liefert einen normalisierten Reel-Video-Datensatz mit den verfügbaren Feldern zu Identität, Bildunterschrift, Creator, Medien, Dauer, Zeitstempeln und sichtbarer Interaktion.

Verwenden Sie eine URL, deren Hostname douyin.com, iesdouyin.com oder eine Subdomain ist. Enthält die URL /video/, muss die folgende Kennung numerisch sein.

Verwenden Sie nach Möglichkeit einen direkten öffentlichen Videoverweis. Die Eingabevalidierung akzeptiert unterstützte Douyin-Hosts und prüft die numerische ID, sobald /video/ vorkommt; der Anbieter braucht jedoch weiterhin einen auflösbaren Videoverweis, um Daten zu liefern.

Das Reel-Video-Schema kann grundlegende Identitäts- und Zeitfelder, Text der Bildunterschrift, Creator-Kontext, Medien, Hashtags, Erwähnungen, Shortcode, Dauer, Audio sowie die verfügbaren Zahlen zu Likes, Kommentaren, Shares, Wiedergaben und Aufrufen enthalten. Optionale Felder können null sein.

Nein. Der Anbieter führt eine einzige Detailanfrage aus und kann höchstens einen Eintrag speichern. limit, has_more und next_cursor gehören zum gemeinsamen Leser der Aufgabenergebnisse von SocQ und sind keine Paginierung beim Anbieter.

Der POST gibt eine task_id zurück. Fragen Sie /v1/tasks/{task_id} ab; data.results erscheint, nachdem die Aufgabe erfolgreich war, und ein Cursor wird abgelehnt, solange die Aufgabe nicht abgeschlossen ist.

Jede erfolgreiche Aufgabe kostet pauschal 0,10 SocQ-Credits. Die Gebühr hängt nicht von der Ergebnisanzahl ab, weil es sich um eine feste Aufgabe mit einem einzelnen Detail handelt.