tiktok/
live-products

Use the TikTok Live Shopping API to list the products in a TikTok LIVE stream's shopping bag from its room ID and host ID: title, current price, units sold, seller ID, product link and image.

TikTok Live Shopping API

Room and host IDs
Shopping bag products
Up to 500 products
0.1 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 Shopping

A TikTok LIVE shopping bag is the set of products a host sells during a broadcast, and every product in it has a title, a price in a stated currency, a units-sold count, a seller and an image. Reading a bag shows what a stream is pushing, how those items are priced while the host is on air and which of them already sell in volume.

TikTok Live Shopping API Features

  • Every product in the bagroom_id with the host's user_id returns each product in the room's shopping bag as its own record, up to the 500 allowed by results_limit.
  • Price as amount, currency and display textprice.amount, price.currency and price.formatted give the number, the currency code and the string viewers see, for example 41.6, USD and $41.60.
  • Units sold as an integersold_count is a whole number such as 101600, so bags can be sorted and compared directly.
  • Product link, seller ID and imageEach TikTok Live Shopping API record has the product page in url, the seller's ID in seller.id and the product image with its width and height in media.

TikTok Live Shopping API Parameters

ParametersRequiredDescription
room_idRequiredNumeric ID of the LIVE room, taken from the id of a TikTok Live Search result.
user_idRequiredNumeric TikTok user ID of the host, taken from author.id of the same Live Search result.
results_limitOptionalHow many products to return, from 1 to 500. Defaults to 100.

How to Use the TikTok Live Shopping API

Find a live shopping stream, then list its bag with the TikTok Live Shopping API while it is on air.

  1. Run TikTok Live Search with a shopping keyword and take a result's id and author.id.
  2. POST {"room_id": "7704767945901132575", "user_id": "7153432386608251946"} to /v1/tiktok/live-products.
  3. Poll GET /v1/tasks/{task_id} until status is succeeded, then read products from results.items and pass results.next_cursor back while has_more is true.
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_id":"7704767945901132575","user_id":"7153432386608251946","results_limit":100}'

# Each item is one product with title, price and sold_count.

TikTok Live Shopping API Use Cases

  • Reading a competitor's live bag: Take a rival host's room_id and user_id from Live Search and list the whole bag to see which products and price points they are running.
  • Watching prices move during a broadcast: Read the same room through the TikTok Live Shopping API every few minutes and compare price.amount for each product id to catch the markdowns a host announces on air.
  • Finding a bag's best sellers: Sort a bag by sold_count to see which items have already moved the most units, then set them against their price.

TikTok Live Shopping API Pro Tips

  • Check price.currency before comparing prices across rooms, since the amount is only meaningful with its currency.
  • Match the same product between TikTok Live Shopping API reads on its id; price.amount and sold_count are the fields that change.

Beyond the TikTok Live Shopping 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 Comments API — Collect public top-level comments, authors, engagement, mentions, and creator interaction flags.
  • TikTok Videos API — Retrieve creator, caption, media, music, tags, mentions, and engagement from video URLs.
  • 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 Live Search API — Find LIVE streams on air now by keyword, with hosts, titles, and current viewers.

Explore other platforms

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

TikTok Live Shopping API — FAQ

TikTok Live Shopping API is a programmatic interface for listing the products in the shopping bag of a TikTok LIVE stream, from the stream's room_id and the host's user_id. It returns each product's title, price, units sold, seller ID, link and image.

Run TikTok Live Search and take a result's id as room_id and its author.id as user_id. The pair has to come from the same result.

results_limit accepts 1 to 500 and defaults to 100, stopping early when the bag is smaller. Each product returned is billed 0.1 credits, so a full 500-product bag costs 50 credits.

The host has no shopping bag in that room, or the room is no longer on air. An empty result is not billed.

No, the room has to be on air when you request the bag. Read it while the stream runs and store it if you need the lineup later.

sold_count is the units-sold figure TikTok reports for the product, and it is null when none is reported. To see what moves during a broadcast, read the bag twice and subtract.