douyin/
video-search

Eine feste erste Ergebnisseite öffentlicher Douyin-Videos per Suchtext abrufen – mit normalisierten Beschreibungstexten, Autorenkontext, Medien, Dauer, Zeitstempeln und sichtbarer Interaktion, sofern verfügbar.

Douyin Video Search API

Suchtext
Feste erste Seite
Normalisierte Videos
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 Search

Douyin Video Search macht aus einem nicht leeren Suchtext einen begrenzten Datensatz öffentlicher Videos. Jede Aufgabe sendet genau eine feste Anfrage an den Anbieter für Seite 1 bei Offset 0 und speichert die Treffer im Reel-Video-Format von SocQ, damit sie einheitlich weiterverarbeitet werden können.

Funktionen der Douyin Video Search API

  • Suche mit nur einem FeldSenden Sie ausschließlich query. Der Endpunkt lehnt nicht deklarierte Eingaben wie results_limit ab und benötigt weder ein Anbieter-Token noch eine interne Kennung.
  • Begrenzte QuellabfrageJede Aufgabe fragt beim Anbieter Seite 1 bei Offset 0 ab, ohne dem Aufrufer die Paginierungssteuerung des Anbieters offenzulegen.
  • Normalisierte Reel-Video-DatensätzeLesen Sie verfügbaren Text, Autor, Medien, Dauer, Zeitstempel sowie die sichtbaren Zahlen zu Wiedergaben, Likes, Kommentaren und Shares über ein einheitliches Ergebnisschema.
  • Asynchroner Abruf gespeicherter ErgebnisseSenden Sie die Anfrage einmal, fragen Sie die Aufgabe ab und nutzen Sie den Ergebnis-Cursor von SocQ nur, wenn die abgeschlossene Aufgabe mehr Datensätze gespeichert hat, als eine Antwortseite enthält.

Parameter der Douyin Video Search API

ParameterErforderlichBeschreibung
queryErforderlichEin erforderlicher, nicht leerer Suchtext. Er wird dem Keyword-Feld des Anbieters zugeordnet, während Seite und Offset vom Backend fest vorgegeben bleiben.

So verwenden Sie die Douyin Video Search API

Geben Sie einen nicht leeren Suchtext an, warten Sie auf die asynchrone Aufgabe und lesen Sie die für diese Aufgabe gespeicherten normalisierten Datensätze.

  1. Wählen Sie einen konkreten Suchtext, der die öffentlichen Videos beschreibt, die Sie entdecken möchten.
  2. Senden Sie query per POST an /v1/douyin/video-search und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler meldet.
  4. Lesen Sie data.results.items. Hat has_more den Wert true, übergeben Sie next_cursor an die Abfrage der Aufgabenergebnisse, um die gespeicherten SocQ-Datensätze weiter durchzugehen.
curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"street food"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor pages stored SocQ results only

Anwendungsfälle der Douyin Video Search API

  • Themenbasierte Videoentdeckung: Erstellen Sie eine begrenzte Momentaufnahme der öffentlichen Videos, die zu einem Produkt, Thema, Ereignis oder Rechercheausdruck zurückgegeben werden.
  • Prüfung des Creator-Kontexts: Verknüpfen Sie zurückgegebene Beschreibungstexte und Medien mit den verfügbaren öffentlichen Autorenfeldern für qualitative Recherche und die Anreicherung von Datensätzen.
  • Format- und Medienanalyse: Prüfen Sie verfügbare Videomedien, Vorschaubilder, Abmessungen und Dauer zusammen mit dem Quelldatensatz und dem Suchkontext.
  • Momentaufnahmen der sichtbaren Interaktion: Vergleichen Sie die verfügbaren Zahlen zu Wiedergaben, Likes, Kommentaren und Shares und behalten Sie collected_at als Beobachtungszeitpunkt bei.

Profi-Tipps zur Douyin Video Search API

  • Verlangen Sie in Ihrer eigenen Oberfläche einen aussagekräftigen Suchtext ohne reine Leerzeichen, bevor Sie die Aufgabe senden.
  • Senden Sie weder results_limit noch page, offset, search_id oder einen Anbieter-Cursor; sie sind nicht Teil des öffentlichen SocQ-Anfrageschemas.
  • Betrachten Sie die zurückgegebene Menge als eine einzelne Antwort des Anbieters, nicht als vollständigen Suchindex und nicht als vom Aufrufer steuerbares Ranking-Fenster.
  • Nutzen Sie cursor und limit bei GET /v1/tasks/{task_id} nur zum Lesen gespeicherter Ergebnisse; limit ist standardmäßig 50 und akzeptiert Werte von 1 bis 500.
  • Behalten Sie collected_at bei und behandeln Sie optionale Felder zu Autor, Medien, Veröffentlichung, Dauer und einzelnen Kennzahlen, ohne fehlende Werte durch 0 zu ersetzen.

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

Douyin Video Search API durchsucht die feste erste Seite öffentlicher Douyin-Videos mit einem Suchtext und liefert normalisierte Reel-Video-Datensätze.

Akzeptiert wird nur query, und es muss eine nicht leere Zeichenfolge sein. Der Endpunkt akzeptiert weder results_limit noch page, offset oder einen vom Aufrufer gelieferten Anbieter-Cursor.

Nein. Das Backend sendet in einer Anbieteranfrage immer Seite 1 und Offset 0 und stellt keine Steuerung für die Paginierung der Quelle bereit.

Ein next_cursor aus GET /v1/tasks/{task_id} führt durch die Datensätze, die SocQ für die abgeschlossene Aufgabe bereits gespeichert hat. Er ruft keine weitere Douyin-Quellseite ab.

Die Ergebnisse folgen dem Reel-Video-Schema und können ID, URL, Text, öffentlichen Autorenkontext, Medien, Dauer, Veröffentlichungs- und Erfassungszeitpunkt, Hashtags, Erwähnungen, Audio sowie die sichtbaren Zahlen zu Wiedergaben, Likes, Kommentaren und Shares enthalten. Optionale Felder können null oder leer sein.

Jede erfolgreiche Aufgabe kostet pauschal 0,10 SocQ-Credits, unabhängig von der Anzahl der Datensätze, die die einzelne Anbieteranfrage zurückgibt.