Zurück zu den APIs
Öffentliche Douyin-Daten

Douyin Public Data APIs

Rufen Sie öffentliche Profile und Videos ab, durchsuchen Sie Videos, erfassen Sie eine Seite mit Kommentaren oder Creator-Videos und prüfen Sie einen bekannten Livestream.

Verfügbare Douyin-APIs

Wählen Sie aus sechs APIs für Workflows zu Profilen, Videos, Kommentaren, Suche und Livestreams.

Welche Douyin-Daten können Sie abrufen?

Der Douyin-Katalog liefert normalisierte Datensätze zu Konten, Reel-Videos, Kommentaren und Livestreams aus öffentlichen Quelldaten.

Profile und Creator-Videos

Löst ein öffentliches Profil auf oder erfasst eine Quellseite mit Videos aus einer unterstützten Profil-URL oder user_id.

Videodetails, Suche und Kommentare

Prüfen Sie eine unterstützte Videoreferenz, durchsuchen Sie die feste erste Quellseite per Abfrage oder erfassen Sie eine Seite mit Kommentaren.

Livestream-Details

Ruft einen bekannten Livestream anhand einer rein numerischen room_id ab, mit verfügbaren Angaben zu Host, Status, Medien und sichtbarem Publikum.

Douyin-API-Spezifikationen im Überblick

Jeder Endpunkt hat eine begrenzte Quellanfrage und lehnt nicht deklarierte Parameter ab.

API-GruppeAusgangseingabeQuellgrenze
Profil und Creator-Videosurl oder user_idEin Profil oder eine Quellseite; Creator-Videos unterstützen results_limit 1–20
Videodetail und KommentareUnterstützte URLEin Detaildatensatz oder eine Kommentarseite; Kommentare unterstützen results_limit 1–20
VideosucheNicht leere queryFeste erste Quellseite ohne results_limit
LivestreamRein numerische room_idHöchstens ein Livestream-Datensatz

So funktionieren die Douyin-APIs

Alle sechs Endpunkte nutzen denselben asynchronen Ablauf aus Senden, Abfragen und Lesen gespeicherter Ergebnisse.

  1. 1. Endpunkt wählen

    Wählen Sie den Endpunkt für Profil, Video, Kommentare, Suche oder Livestream, der zu der öffentlichen Referenz passt, die Sie bereits haben.

  2. 2. Gültige Eingabe senden

    Senden Sie per POST nur die deklarierten Felder und speichern Sie die zurückgegebene task_id.

  3. 3. Normalisierte Ergebnisse lesen

    Fragen Sie die Aufgabe bis zu einem Endstatus ab, lesen Sie dann data.results.items und nutzen Sie next_cursor nur für die Paginierung gespeicherter Ergebnisse.

Öffentliche Douyin-Videos durchsuchen

Authentifizieren Sie sich mit einem SocQ-API-Schlüssel und senden Sie eine nicht leere query. Eine erfolgreiche Douyin-Aufgabe kostet pauschal 0,10 Credits.

curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"artificial intelligence"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

Typische Anwendungsfälle der Douyin-API

Creator-Recherche

Verbinden Sie die öffentliche Profilidentität mit einer begrenzten Seite von Creator-Videos und sichtbarer Interaktion.

Prüfung von Inhalten und Gesprächen

Reichern Sie bekannte Videos an, durchsuchen Sie eine Momentaufnahme zu einem Thema und prüfen Sie eine öffentliche Kommentarseite.

Beobachtung von Livestreams

Halten Sie eine Momentaufnahme eines bekannten öffentlichen Livestreams anhand einer ausdrücklichen numerischen Raumkennung fest.

Grenzen und Richtlinie für öffentliche Daten

Diese Endpunkte lesen öffentliche Daten über begrenzte Quellanfragen und bieten weder Kontoaktionen noch kontinuierliche Beobachtung.

  • user_id akzeptiert 1–256 ASCII-Buchstaben, Ziffern, Doppelpunkte, Unterstriche oder Bindestriche; Profil-URLs müssen /user/{identifier} auf einem unterstützten Douyin-Host enthalten.
  • room_id ist eine Zeichenfolge, die nur aus Ziffern besteht; halten Sie lange Kennungen aus JavaScript-Zahlenwerten heraus.
  • results_limit ist nur für User Videos und Video Comments verfügbar, mit einem Bereich von 1–20 und dem Standardwert 20.
  • Video Search ist auf die erste Quellseite festgelegt; Cursor der Aufgabenergebnisse paginieren nur Datensätze, die für diese Aufgabe bereits gespeichert sind.
  • Jede erfolgreiche Douyin-Aufgabe kostet pauschal 0,10 Credits.

Häufige Fragen zur Douyin-API

Was sind die Douyin-APIs?

Die Douyin-APIs rufen öffentliche Profile, Videos, Kommentare, Ergebnisse der Videosuche und Livestream-Details als normalisierte Datensätze ab.

Welche Endpunkte akzeptieren results_limit?

User Videos und Video Comments akzeptieren eine ganze Zahl von 1 bis 20. Die übrigen Douyin-Endpunkte lehnen results_limit ab.

Kann ich die Quelle paginieren?

Nein, es steht kein vom Aufrufer steuerbarer Quell-Cursor zur Verfügung. Ein zurückgegebenes next_cursor paginiert nur Ergebnisse, die für die abgeschlossene Aufgabe bereits gespeichert sind.

Wie werden Douyin-Anfragen abgerechnet?

Jede erfolgreiche Aufgabe kostet pauschal 0,10 SocQ-Credits.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.