LIVE shop info
Commerce info for a LIVE room.
/aweme/v1/oec/live/room/common_infoEvery planWhat it does & execution pool
Commerce info for a LIVE room. The gateway dispatches `/aweme/v1/oec/live/room/common_info` over HTTP/2 with native mobile TLS/ALPN fingerprints and full `X-Argus`, `X-Ladon`, `X-Gorgon`, and `X-Khronos` headers, then normalizes the protobuf/JSON payload.
Runs on Tikultra’s warm Guest Mobile Pool (LeanPool): No account_id or login session is required. The gateway selects a bootstrapped, MSSDK-attested mobile guest context matching your requested (os, app_flavour, app_version, region, city), signs the wire request in 0.25 ms p50, and decodes the upstream response to JSON. Zero caller credentials needed. Pass optional os, app_flavour, app_version, region, and city parameters to pin exact client and geographic egress.
How to use it (TikTok Shop SDUI Product Spy, Visual Search & Affiliate Discovery)
Search products by keyword or photo, decode the complete mobile SDUI product detail tree (SKUs, stock, vouchers, logistics), and audit sellers & showcases.
| Step | Endpoint | Purpose |
|---|---|---|
| 1 | GET /v1/shop/search | Discover products via keyword, browse, or photo: Search Shop via GET /v1/shop/search, run an organic browse sequence (/v1/shop/browse), or reverse-search an image (/v1/vision/ecom-search). |
| 2 | GET /v1/shop/product-page | Decode full mobile SDUI product page: Call GET /v1/shop/product-page to get every SKU price, inventory count, shipping promise, voucher, and seller trust score. |
| 3 | GET /v1/shop/reviews | Audit verified buyer reviews & seller catalog: Paginate buyer reviews (/v1/shop/reviews, /seller/reviews), full seller catalogs (/v1/shop/seller), and creator showcases (/v1/shop/showcase). |
| 4 ★ | GET /v1/shop/live-room | LIVE shop info: Commerce info for a LIVE room. (GET /v1/shop/live-room). |
| 5 | GET /v1/shop/live-bag | Inspect pinned LIVE shopping bags: Monitor flash deals and room sales velocity in active streams via GET /v1/shop/live-bag and /v1/video/anchors. |
Parameters
| Name | Type | Description |
|---|---|---|
room_idrequired | string | The numeric LIVE room ID. e.g. 7707202762026535693 |
Pricing
| Plan | Per call | Per 1,000 calls |
|---|---|---|
| Starter | 25 credits | $2.90 |
| Growth | 25 credits | $1.98 |
| Scale | 25 credits | $1.45 |
Response fields
| Field | Type | Description |
|---|---|---|
status_code | integer | Upstream TikTok mobile status code (0 indicates success). |
room_id | string | 64-bit LIVE room Snowflake identifier. |
has_commerce_bag | boolean | Whether commerce bag is enabled or true. |
product_count | integer | Total product count. |
seller_id | string | TikTok Shop merchant / seller identifier. |
gmv_tier | string | Decoded gmv tier value. |
atmosphere_tags | string[] | Decoded atmosphere tags value. |
log_pb | object | Upstream request trace envelope from the mobile gateway. |
log_pb.impr_id | string | Upstream TikTok impression / trace identifier. |
What it returns
Returns `200 OK` `application/json` decoded from `/aweme/v1/oec/live/room/common_info`. Field names (`aweme_id`, `uid`, `sec_uid`, `unique_id`, `room_id`, `product_id`) are consistent across all 200+ endpoints so outputs pipe directly into follow-up calls. If TikTok returns an upstream timeout, empty challenge, or 5xx error, the gateway surfaces a structured error `code` and sets `x-credits-cost: 0`. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Error codes
import { TikUltra } from 'tikultra'
const client = new TikUltra({ apiKey: process.env.TIKULTRA_KEY })
const res = await client.request('GET', '/v1/shop/live-room', { params: { room_id: '7707202762026535693' } })
console.log(res.creditsCost, res.data){
"status_code": 0,
"room_id": "7707202762026535693",
"has_commerce_bag": true,
"product_count": 8,
"seller_id": "7495298225862576264",
"gmv_tier": "high_velocity",
"atmosphere_tags": [
"Free shipping",
"120 sold in LIVE"
],
"log_pb": {
"impr_id": "202611120200419F8E7D6C5B4A3210"
}
}More in Shop · LIVE shopping
Ready to build?
Start with 2,500 free credits and test every public endpoint, then pick a plan.