tiktok/
top-search

Durchsuchen Sie TikTok-Videos und Foto-Karussells per Keyword – Bildunterschriften, Creator-Angaben, Medienlinks und Interaktionszahlen kommen gemeinsam in einer JSON-Liste zurück.

TikTok Top Search API

Videos und Foto-Karussells
Keyword-Suche
Sortierung und Veröffentlichungsfilter
0,7 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

TikTok Top Search

Die TikTok-Top-Suche bündelt zu einem Keyword oder einer Wortgruppe Videos und Foto-Karussells, also Beiträge aus mehreren Bildern. Bildunterschriften, Creator-Identitäten, Medien und Interaktionszahlen helfen Ihnen zu vergleichen, wie dasselbe Thema in diesen unterschiedlichen Inhaltsformaten erscheint.

Funktionen der TikTok Top Search API

  • Videos und Bildbeiträge in einer Suche findenDieselbe Keyword-Abfrage kann Videobeiträge und Foto-Karussells liefern; das Feld type kennzeichnet das Format, sodass Sie beide in einem Datensatz behalten oder zur Prüfung trennen können.
  • Sortierung und Veröffentlichungszeitraum wählenSortieren Sie passende Inhalte nach Relevanz, Veröffentlichungsdatum oder Likes und ergänzen Sie einen Filter für den Veröffentlichungszeitpunkt, um die zurückgegebene Auswahl auf die Art von Inhalten einzugrenzen, die Sie prüfen möchten.
  • Inhalt zusammen mit Creator und Zählern lesenJedes Ergebnis enthält Bildunterschrift, Creator-Informationen, Medienlinks und die verfügbaren Interaktionszahlen, sodass Sie Thema und Format eines Beitrags mit dem Konto in Beziehung setzen können, das ihn veröffentlicht hat.

Parameter der TikTok Top Search API

ParameterErforderlichBeschreibung
queryErforderlichErforderliches Keyword oder erforderliche Wortgruppe, die beschreibt, was Sie finden möchten, zum Beispiel coffee oder home workout; geben Sie Suchtext ein und keine URL eines TikTok-Beitrags.
sort_byOptionalOptionale Sortierung: relevance stellt die Relevanz der Treffer an die erste Stelle, date sortiert nach Veröffentlichungsdatum und likes sortiert nach Anzahl der Likes; Standard ist relevance.
published_withinOptionalOptionaler Zeitraum der Veröffentlichung: day wählt gestern, week diese Woche, month diesen Monat, three_months die letzten drei Monate und six_months die letzten sechs Monate; lassen Sie das Feld leer, um keinen zusätzlichen Filter für den Veröffentlichungszeitpunkt anzuwenden.
regionOptionalOptionaler zweibuchstabiger Regionscode, zum Beispiel US oder GB, der ändert, auf welche Inhalte die Suche zugreifen kann; er belegt nicht, dass die zurückgegebenen Beiträge oder Creator in diesem Land ansässig sind.
results_limitOptionalOptionale maximale Anzahl an Inhaltsdatensätzen von 1 bis 2000, Standard ist 100; Videos und Foto-Karussells zählen beide zu dieser Gesamtzahl, und es können weniger Ergebnisse zurückkommen.

So verwenden Sie die TikTok Top Search API

Die Anfrage startet eine Aufgabe, die im Hintergrund Daten sammelt. Die erste Antwort enthält daher eine Aufgaben-ID statt der fertigen Daten; mit dieser ID prüfen Sie den Fortschritt und rufen die Ergebnisse ab.

  1. Geben Sie ein Themen-Keyword ein, wählen Sie, ob Relevanz, Datum oder Likes am nützlichsten ist, und legen Sie ein Ergebnislimit fest; fügen Sie einen Veröffentlichungszeitraum oder eine Region nur hinzu, wenn Sie diese Optionen brauchen.
  2. Ersetzen Sie vor dem Ausführen des Beispiels $SOCQ_API_KEY durch Ihren eigenen API-Schlüssel oder setzen Sie diese Umgebungsvariable. Senden Sie die JSON-Eingabe mit dem unten gezeigten Header Authorization per POST an /v1/tiktok/top-search und speichern Sie die task_id aus der Antwort.
  3. Fragen Sie mit der gespeicherten ID GET /v1/tasks/{task_id} ab, um den Fortschritt zu prüfen. queued bedeutet Warten, running bedeutet, dass die Erfassung läuft, und retrying bedeutet, dass ein weiterer Versuch läuft. Warten Sie auf succeeded, bevor Sie die Ergebnisse lesen; bei failed finden Sie den Grund in error_message.
  4. Wenn die Aufgabe erfolgreich ist, lesen Sie data.results.items: Jedes Element dieser Liste beschreibt einen Video- oder Foto-Karussell-Beitrag. Eine leere Liste bedeutet, dass die Aufgabe abgeschlossen wurde, ohne Datensätze zurückzugeben.
  5. Wenn data.results.has_more den Wert true hat, ist next_cursor die Markierung für eine weitere Seite gespeicherter Ergebnisse. Kopieren Sie den Wert unverändert in den Parameter cursor von GET /v1/tasks/{task_id}?cursor=... und fahren Sie fort, bis has_more false ist.
curl -X POST "https://api.socq.ai/v1/tiktok/top-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"coffee","sort_by":"relevance","results_limit":20}'

Anwendungsfälle der TikTok Top Search API

  • Themenbezogene Inhaltssammlung aufbauen: Suchen Sie nach einem Thema wie coffee und speichern Sie Bildunterschriften, Creator-Handles, Links und Inhaltstypen in einer Prüftabelle, die sowohl Video- als auch Bildbeitrags-Beispiele enthält.
  • Interaktionszahlen der zurückgegebenen Beiträge vergleichen: Kombinieren Sie die verfügbaren Likes, Kommentare und Shares mit dem Format und dem Veröffentlichungszeitpunkt jedes Beitrags zu einer Vergleichstabelle und bewahren Sie Abfrage und Filter auf, damit nachvollziehbar bleibt, wie die Beispiele ausgewählt wurden.

Profi-Tipps zur TikTok Top Search API

  • Prüfen Sie bei der Darstellung eines Ergebnisses zuerst type und media: photo_carousel steht für einen Bildbeitrag und sollte in einer Bildergalerie statt in einem Videoplayer angezeigt werden.
  • Wenn Sie mehrere Keywords erfassen, entfernen Sie wiederholte Treffer anhand der Beitrags-ID und behalten Sie zu jeder Erfassung das zugehörige Keyword, damit derselbe Beitrag nicht versehentlich mehrfach gezählt wird.
  • Wenn Ihr Workflow nur Videos verarbeitet, verwenden Sie TikTok Search; wenn Sie Videos und Bildbeiträge benötigen, bleiben Sie bei Top Search und behandeln Sie in Ihrer Darstellung beide Formate.
  • Wenn ein Foto-Ergebnis keine Dauer und keine Wiedergabezahl hat, lassen Sie diese Messgröße leer, statt sie als Video mit null Sekunden oder als nie angesehenen Beitrag zu deuten.

Ergänzend zur TikTok Top Search API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok-Daten benötigen.

  • TikTok Profiles API — Öffentliche Profilidentität, Bios, Kontomerkmale und Zahlen zur Zielgruppe per Benutzername abrufen.
  • TikTok Hashtags API — Öffentliche Videos, Creators, Medien, Sounds und Interaktionen zu angegebenen Hashtags erfassen.
  • TikTok Comments API — Öffentliche Kommentare der obersten Ebene, Autoren, Interaktionen, Erwähnungen und Merkmale zur Creator-Interaktion erfassen.
  • TikTok Videos API — Creator, Bildunterschrift, Medien, Musik, Tags, Erwähnungen und Interaktionen aus Video-URLs abrufen.
  • TikTok Search API — Öffentliche Videos per Keyword suchen – mit unterstützten Sortier- und Veröffentlichungsfiltern.
  • TikTok Live Room Info API — Einen bekannten Livestream anhand des Paars aus Raum-ID und Besitzer-ID nachschlagen und Status, Besitzerkontext, Cover-Medien und Zuschauerzahlen zurückgeben.

Weitere Plattformen entdecken

Kombinieren Sie TikTok-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

TikTok Top Search API — FAQ

TikTok Top Search API ist eine Schnittstelle, die öffentliche TikTok-Videos und Foto-Karussells zu einem Keyword oder einer Wortgruppe findet. Sie liefert Bildunterschriften, Creator, Medienlinks und Interaktionszahlen, wahlweise mit Sortierung und Filtern für den Veröffentlichungszeitpunkt.

Das ist ein TikTok-Bildbeitrag mit mehreren Bildern, durch die Zuschauer blättern können. In den Ergebnissen kennzeichnet type=photo_carousel dieses Format, und media enthält die Bildeinträge.

TikTok Search liefert nur Videos, während Top Search sowohl Videos als auch Foto-Karussells enthalten kann. Entscheiden Sie danach, ob Ihre Erfassung oder Darstellung auch Bildbeiträge verarbeiten muss.

Einen Eingabefilter nur für Fotos gibt es nicht. Wählen Sie nach dem Abruf die Datensätze aus, deren type photo_carousel ist; das Ergebnislimit gilt vor Ihrer eigenen Filterung nach Format, sodass die verbleibende Zahl an Fotos niedriger sein kann.

Nein. region ändert die Verfügbarkeit von Inhalten für die Suche, nicht die geografische Herkunft jedes Ergebnisses; verwenden Sie es nicht als Ersatz für ein Feld zum Standort des Creators oder des Beitrags.

Nein. results_limit ist eine Obergrenze für die zurückgegebene Auswahl, keine Garantie, dass jeder passende TikTok-Beitrag enthalten ist. Eine Suche kann weniger Datensätze liefern als das angeforderte Limit.

Jeder zurückgegebene Inhaltsdatensatz kostet 0,7 Credits, egal ob Video oder Foto-Karussell. Es gibt keine Grundgebühr; ein Limit von 100 ergibt geschätzt 70 Credits, während 20 zurückgegebene Datensätze 14 Credits kosten.