TikTok Live Search
A TikTok LIVE room is one broadcast in progress, identified by a room ID and carrying a title, a host, a running viewer count, accumulated likes and a start time. Matching those rooms against a keyword shows who is on air about a topic right now and how big each audience is, which is where live shopping research, host scouting and tracking live activity around a brand begin.
TikTok Live Search API Features
- Keyword in, on-air streams outquery takes one keyword and returns the streams broadcasting at that moment, each with status set to live.
- Room ID and host ID in one recordid is the room ID and author.id the host's user ID, the two values TikTok Live Shopping needs to list that stream's products.
- Audience at collection timemetrics.viewers_count is how many people are in the room and metrics.likes_count the likes it has gathered, stamped with collected_at.
- Title, start time, cover and LIVE pageEach TikTok Live Search API record has the stream title, its start time in published_at, the cover image in media and a link to the host's LIVE page in url, plus the host's handle, display name and avatar.
TikTok Live Search API Parameters
| Parameters | Required | Description |
|---|---|---|
query | Required | The keyword to find LIVE streams for. |
results_limit | Optional | How many streams to return, from 1 to 200. Defaults to 20. |
How to Use the TikTok Live Search API
Send a keyword to the TikTok Live Search API and read the streams that are live now.
- POST {"query": "deals", "results_limit": 20} to /v1/tiktok/search-live.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read streams from results.items and pass results.next_cursor back while has_more is true.
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.TikTok Live Search API Use Cases
- Scouting competitors' live selling: Search the product words sellers say on air, such as deals, then pass each room's id and author.id to TikTok Live Shopping to read what is in the bag.
- Counting live activity around a keyword: Run the same TikTok Live Search API query on a schedule and log how many streams are on air and their viewers_count, to see when a topic or brand draws live audiences.
- Shortlisting hosts for collaborations: Collect the hosts live on your topic and rank them by viewers_count and likes_count before you reach out.
TikTok Live Search API Pro Tips
- Search several phrasings of the same niche and merge the lists on id, because each keyword returns its own set of streams and one stream can match more than one.
- Store id and author.id from the TikTok Live Search API separately: id identifies one broadcast and author.id the host, so follow a host across days by author.id.
- To follow a single room's viewers over time, switch from repeated searches to TikTok Live Room Info with that room_id and user_id.
Related APIs
Beyond the TikTok Live Search API, use these APIs when you need a different type of public TikTok data.
- TikTok Profiles API — Retrieve public profile identity, biographies, account flags, and audience counts by username.
- TikTok Hashtags API — Collect public videos, creators, media, sound, and engagement for specified hashtags.
- TikTok Search API — Search public videos by keyword with supported sorting and publication filters.
- TikTok Live Room Info API — Look up one known live room by paired room and owner IDs, returning status, owner context, cover media, and audience counts.
- TikTok Search Users API — Search public TikTok accounts by keyword.
- TikTok Live Shopping API — List the products in a LIVE stream's shopping bag, with current prices and units sold.
- 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