Skip to main content
POST
TikTok Live Shopping API

TikTok Live Shopping

List what a TikTok LIVE stream is selling. For a stream with a shopping bag, every product comes with its title, current price, units sold, seller and product image. While the stream is on air, take room_id and user_id from a TikTok Live Search result.
room_id and user_id are required; use the id and author.id of a TikTok Live Search result. results_limit defaults to 100 and accepts 1 to 500. A stream without products returns an empty result, which is not charged.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

room_id and user_id are required; both come from TikTok Live Search results. Returns the products in the stream's shopping bag. results_limit defaults to 100 and accepts 1 to 500.

room_id
string
required

Numeric ID of the LIVE room.

Minimum string length: 1
Pattern: ^\d{10,32}$
user_id
string
required

Numeric TikTok user ID of the LIVE host.

Minimum string length: 1
Pattern: ^\d{5,32}$
callback_url
string<uri>
results_limit
integer
default:100
Required range: 1 <= x <= 500

Response

Task accepted

code
integer
data
object