tiktok/
search-live

Search TikTok LIVE by keyword with the TikTok Live Search API and get the streams on air right now: room ID, host ID, title, current viewers, likes and start time, ready for live shopping lookups.

TikTok Live Search API

Keyword search
On-air streams only
Room and host IDs
0.6 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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

ParametersRequiredDescription
queryRequiredThe keyword to find LIVE streams for.
results_limitOptionalHow 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.

  1. POST {"query": "deals", "results_limit": 20} to /v1/tiktok/search-live.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. 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.

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.

Explore other platforms

Combine TikTok data with public data from other supported social platforms.

TikTok Live Search API — FAQ

TikTok Live Search API is a programmatic interface for finding the TikTok LIVE streams that are on air now and match a keyword, with results_limit setting how many come back. Each record carries the room ID, host ID, title, current viewers, likes, cover image and start time.

Send a result's id as room_id and its author.id as user_id to TikTok Live Shopping. Both values must come from the same result.

results_limit accepts 1 to 200 and defaults to 20, and the list ends sooner when fewer streams match. Each stream returned is billed 0.6 credits, and a search with no matches is not billed.

No. It lists streams broadcasting when you submit the search, and every record has status live. Past broadcasts are not returned.

Streams start and stop all day, so the set on air changes between runs. Use id as the stream key and collected_at as the time of each pull.

The request takes only query and results_limit. Read metrics.viewers_count in the results and filter on your side.

This endpoint searches by keyword. For a known account, use TikTok User Live, which takes usernames and reports live status for each.