TikTok Live Search
Ein TikTok-LIVE-Raum ist eine laufende Übertragung, erkennbar an einer Raum-ID, mit Titel, Host, laufender Zuschauerzahl, gesammelten Likes und Startzeit. Gleicht man diese Räume mit einem Stichwort ab, sieht man, wer gerade zu einem Thema sendet und wie groß das Publikum jeweils ist – der Ausgangspunkt für Live-Shopping-Recherche, Host-Suche und die Beobachtung der Live-Aktivität rund um eine Marke.
Funktionen der TikTok Live Search API
- Stichwort rein, laufende Streams rausquery nimmt ein Stichwort entgegen und liefert die Streams, die in diesem Moment senden, jeweils mit status live.
- Raum-ID und Host-ID in einem Datensatzid ist die Raum-ID und author.id die Nutzer-ID des Hosts – die beiden Werte, die TikTok Live Shopping braucht, um die Produkte dieses Streams aufzulisten.
- Publikum zum Zeitpunkt der Erfassungmetrics.viewers_count gibt an, wie viele Personen im Raum sind, und metrics.likes_count, wie viele Likes er gesammelt hat, versehen mit collected_at.
- Titel, Startzeit, Cover und LIVE-SeiteJeder Datensatz enthält den Stream-Titel, die Startzeit in published_at, das Titelbild in media und einen Link zur LIVE-Seite des Hosts in url, dazu Handle, Anzeigename und Avatar des Hosts.
Parameter der TikTok Live Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Das Stichwort, zu dem LIVE-Streams gesucht werden. |
results_limit | Optional | Wie viele Streams zurückgegeben werden, von 1 bis 200. Standard ist 20. |
So verwenden Sie die TikTok Live Search API
Suchen Sie ein Stichwort und lesen Sie die Streams aus, die gerade live sind.
- Senden Sie {"query": "deals", "results_limit": 20} per POST an /v1/tiktok/search-live.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- Lesen Sie die Streams aus results.items und geben Sie results.next_cursor zurück, solange has_more true ist.
curl -X POST "https://api.socq.ai/v1/tiktok/search-live" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"deals","results_limit":20}'
# id is the room ID; author.id is the host ID for TikTok Live Shopping.Anwendungsfälle der TikTok Live Search API
- Live-Verkauf der Konkurrenz auskundschaften: Suchen Sie die Produktwörter, die Verkäufer im Stream sagen, etwa deals, und geben Sie id und author.id jedes Raums an TikTok Live Shopping weiter, um zu lesen, was im Warenkorb liegt.
- Live-Aktivität rund um ein Stichwort zählen: Führen Sie dieselbe Suche regelmäßig aus und protokollieren Sie, wie viele Streams senden und wie hoch ihr viewers_count ist, um zu sehen, wann ein Thema oder eine Marke Live-Publikum anzieht.
- Hosts für Kooperationen vorauswählen: Erfassen Sie die Hosts, die zu Ihrem Thema live sind, und ordnen Sie sie nach viewers_count und likes_count, bevor Sie Kontakt aufnehmen.
Profi-Tipps zur TikTok Live Search API
- Suchen Sie mehrere Formulierungen derselben Nische und führen Sie die Listen über id zusammen, denn jedes Stichwort liefert eigene Streams und ein Stream kann zu mehreren passen.
- Speichern Sie id und author.id getrennt: id kennzeichnet eine einzelne Übertragung und author.id den Host, einen Host verfolgen Sie über mehrere Tage also anhand von author.id.
- Um die Zuschauer eines einzelnen Raums im Zeitverlauf zu verfolgen, wechseln Sie von wiederholten Suchen zu TikTok Live Room Info mit dieser room_id und user_id.
Verwandte APIs
Ergänzend zur TikTok Live 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 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.
- TikTok Search Users API — Öffentliche TikTok-Konten per Keyword suchen.
- TikTok Live Shopping API — Die Produkte im Warenkorb eines LIVE-Streams auflisten – mit aktuellen Preisen und verkauften Einheiten.
- TikTok Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API