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
| Parameters | Required | Description |
|---|---|---|
room_id | Required | Numeric ID of the LIVE room, taken from the id of a TikTok Live Search result. |
user_id | Required | Numeric TikTok user ID of the host, taken from author.id of the same Live Search result. |
results_limit | Optional | How 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.
- Run TikTok Live Search with a shopping keyword and take a result's id and author.id.
- POST {"room_id": "7704767945901132575", "user_id": "7153432386608251946"} to /v1/tiktok/live-products.
- 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.
Related APIs
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.
- TikTok Search 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 Search Users 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