Skip to content
Managed gateway · LeanPool

LIVE shopping bag

Products pinned in a LIVE room, with prices and promos.

GETapi.tikultra.com/v1/shop/live-bagPremium · 25 credits
Upstream/aweme/v2/oec/live/bag/assemble/aweme/v2/oec/live/bag/tabs_and_productsExclusiveEvery plan

Parameters

NameTypeDescription
room_idrequiredstringThe numeric LIVE room ID.
e.g. 7705861000123456789
regionstringTwo-letter country code for egress and storefront.
e.g. US

Pricing

PlanPer callPer 1,000 calls
Starter25 credits$2.90
Growth25 credits$1.98
Scale25 credits$1.45

Responses

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes

curl -G https://api.tikultra.com/v1/shop/live-bag \
  -H "x-api-key: $TIKULTRA_KEY" \
  --data-urlencode "room_id=7705861000123456789"
{
  "room_id": "7705861000123456789",
  "total_products": 8,
  "pinned": {
    "product_id": "1729384756192837461",
    "index": 1,
    "title": "Low-profile mechanical keyboard 75%",
    "price": "64.99",
    "currency": "USD",
    "promo": "LIVE Flash Deal · ends in 04:12"
  },
  "items": [
    {
      "product_id": "1729384756192837461",
      "index": 1,
      "title": "Low-profile mechanical keyboard 75%",
      "price": "64.99",
      "stock": 120
    },
    {
      "product_id": "1729384756192837499",
      "index": 2,
      "title": "Coiled USB-C Aviator Cable",
      "price": "19.99",
      "stock": 340
    }
  ]
}
Try it in the playgroundFull reference in the docs

More in TikTok Shop

GET/v1/shop/pdpProduct page25 crGET/v1/shop/searchShop search25 crGET/v1/shop/sellerSeller catalog25 crGET/v1/shop/seller/categoriesSeller categories25 crGET/v1/shop/seller/reviewsSeller reviews25 crGET/v1/shop/showcaseCreator showcase25 crGET/v1/shop/reviewsProduct reviews25 crGET/v1/shop/anchorsShop anchors25 crGET/v1/shop/mallMall home25 crGET/v1/shop/tabShop tab25 crGET/v1/shop/live-productsLIVE product pop-up25 crGET/v1/shop/live-roomLIVE shop info25 crGET/v1/shop/suggestionsShop suggestions25 crGET/v1/shop/creatorShop creator25 crGET/v1/shop/same-shopMore from this shop25 crGET/v1/shop/recommendationsProduct recommendations25 crGET/v1/shop/promotionsPromotions25 crGET/v1/shop/translationProduct translation25 cr

Ready to build?

Start with 2,500 free credits and test every public endpoint, then pick a plan.

Get an API keySee pricing