tiktok/
search

Durchsuchen Sie öffentliche TikTok-Videos per Keyword, mit Filtern nach Relevanz, Datum, Likes und Veröffentlichungszeitraum, und erhalten Sie normalisierte Datensätze zu Creator, Inhalt, Medien und Interaktion.

TikTok Search API

Keyword-Entdeckung
Recherche-Stichproben
Zeiträume
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 Search

TikTok-Suchergebnisse sind öffentliche Videos, die zu einem Keyword oder einer Wortgruppe passen, mit Creator-Angaben, Bildunterschriften, Medien, Veröffentlichungskontext und sichtbarer Interaktion. Diese Datensätze unterstützen die Themenentdeckung, die Trendforschung, die Beobachtung von Wettbewerbern und die Analyse von Content-Chancen.

Funktionen der TikTok Search API

  • Video-Entdeckung per KeywordVerwandeln Sie ein Thema, eine Marke, ein Produkt oder ein Veranstaltungs-Keyword in eine Menge von Kandidaten-Videos.
  • Sortierung nach Relevanz und AktualitätWechseln Sie zwischen Relevanz, Datum und Likes, je nachdem, ob Sie thematisch, aktuell oder nach vielen Likes suchen.
  • VeröffentlichungszeiträumeGrenzen Sie den Recherchezeitraum mit day, week, month, three_months oder six_months ein.
  • Inhalts- und Creator-FelderLiefert Felder zu Video, Creator, Interaktion, Hashtags und Musik in einer einheitlichen Struktur der Suchergebnisse.
  • Nachvollziehbare Such-MomentaufnahmenHalten Sie jedes Suchexperiment über search_query und collected_at fest.

Parameter der TikTok Search API

ParameterErforderlichBeschreibung
queryErforderlichErforderliche, nicht leere Keyword-Abfrage zur Entdeckung öffentlicher TikTok-Videos.
results_limitOptionalPositives Limit für die angeforderte Anzahl an Videoergebnissen. Standard ist 100.
sort_byOptionalSortierung der Ergebnisse: relevance, date oder likes. Standard ist relevance.
published_withinOptionalOptionaler Veröffentlichungszeitraum: day, week, month, three_months oder six_months.

So verwenden Sie die TikTok Search API

Legen Sie zuerst die Forschungsfrage fest und wählen Sie dann Keyword, Sortierziel und Veröffentlichungszeitraum.

  1. Formulieren Sie das Recherchethema als konkrete query und wählen Sie results_limit, sort_by und published_within.
  2. Senden Sie die Anfrage per POST an /v1/tiktok/search und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe succeeded oder failed erreicht.
  4. Lesen Sie data.results.items. Wenn has_more den Wert true hat, fahren Sie mit next_cursor fort.
curl -X POST "https://api.socq.ai/v1/tiktok/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"space exploration","results_limit":100,"sort_by":"relevance","published_within":"month"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Anwendungsfälle der TikTok Search API

  • Markt- und Kategorie-Scans: Nutzen Sie Begriffe zu Produkt, Kategorie und Anwendungsfall, um die TikTok-Inhaltslandschaft und eine Stichprobe von Creators zu erfassen.
  • Verfolgung der Dynamik von Veranstaltungen: Kombinieren Sie date mit einem Zeitraum von einem Tag oder einer Woche, um aktuelle Inhalte rund um Launches, Veranstaltungen und Nachrichtenmomente zu verfolgen.
  • Creative-Recherche nach vielen Likes: Sortieren Sie nach Likes und untersuchen Sie wiederkehrende Hooks, Bildunterschriften, Musikauswahl und Hashtag-Kombinationen.
  • Beobachtung von Markenerwähnungen: Führen Sie Abfragen zu Marken und Produkten nach Zeitplan aus und speichern Sie Momentaufnahmen für Content- und Kommunikationsteams.

Profi-Tipps zur TikTok Search API

  • Teilen Sie ein breites Thema in Abfragen zu Marke, Bedarf, Anlass und Trend auf und führen Sie die entstehenden Videomengen anschließend zusammen.
  • Wählen Sie relevance, um ein Thema abzubilden, date, um neue Veröffentlichungen zu verfolgen, und likes, um beliebte Creative-Muster zu untersuchen.
  • Nutzen Sie published_within, um Stichproben auf einer einheitlichen Zeitskala zu halten, zum Beispiel week für regelmäßige Berichte.
  • Speichern Sie query, sort_by, published_within und collected_at zusammen, damit sich die Suche reproduzieren lässt.
  • Entfernen Sie Duplikate über Abfragen hinweg anhand der Video-id und behalten Sie jede search_query, die zu dem Video geführt hat.
  • Wiederholen Sie zentrale Abfragen nach Zeitplan, um Verschiebungen bei Creators, Themen und Interaktion zu vergleichen.

Ergänzend zur TikTok 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 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.
  • TikTok Search Users API — Öffentliche TikTok-Konten per Keyword suchen.

Weitere Plattformen entdecken

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

TikTok Search API — FAQ

TikTok Search API findet öffentlich zugängliche Videos zu einem Keyword oder einer Wortgruppe. Sie liefert normalisierte Daten zu Video, Creator, Bildunterschrift, Medien, Veröffentlichung und Interaktion mit unterstützten Sortierungen und Zeitfiltern.

query ist ein erforderliches, nicht leeres Keyword oder eine Wortgruppe, zum Beispiel eine Marke, ein Produkt, eine Kampagne, eine Person oder ein Recherchethema.

relevance ordnet Ergebnisse nach thematischer Relevanz, date betont aktuelle Veröffentlichungen und likes betont die öffentliche Like-Leistung. Standard ist relevance.

published_within akzeptiert day, week, month, three_months und six_months für Videos, die im jeweiligen letzten Zeitraum veröffentlicht wurden.

results_limit legt die gewünschte Obergrenze der Videoergebnisse fest, muss eine positive ganze Zahl sein und ist standardmäßig 100.

Die Ergebnisse enthalten Video-ID, kanonische URL, Bildunterschrift, Sprache, Veröffentlichungszeitpunkt, Creator, öffentliche Interaktion, Hashtags, Erwähnungen, Medien und Musikdaten.

search_query hält den Begriff fest, der das Ergebnis geliefert hat, während collected_at den Erfassungszeitpunkt für nachvollziehbare Such-Momentaufnahmen festhält.

Jedes zurückgegebene normalisierte Suchergebnis zu einem Video kostet 0,7 Credits.