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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Ein 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.
- Wählen Sie einen konkreten Suchtext, der die öffentlichen Videos beschreibt, die Sie entdecken möchten.
- Senden Sie query per POST an /v1/douyin/video-search und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler meldet.
- 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 onlyAnwendungsfä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.
Verwandte APIs
Ergänzend zur Douyin Video Search 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 Detail API