TikTok Livestream Room Product List

https://api.sandbase.ai/v1/api/tiktok/app-v3/live-room-product-list

Returns the list of showcase products featured in a broadcast session based on the specified room and author identifiers, with support for region filtering and pagination.

Price
$0.0015USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
2 required · 3 optional
Production route

Try the model

Playground

Open playground
Input
Anchor id, required parameter.
Page turning cursor, optional parameter, default is 0, increasing by 15 each time.
Number per page, optional parameter, default is 15.
Region, optional parameter, default is `US`. Other regions (for example `VN`) may return no data.
Live room id, required parameter.
OutputExample
Responseoutputs · 37.3 KB · 147 lines
[
  {
    "data": {
      "code": 0,
      "data": {
        "AIGC_term_banner": null,
        "all_product_ids": null,
        "atmosphere_tag_info": null,
        "bag_prom_logos": null,
        "bonus_entry": null,
        "buy_button_config": {
          "live_bag_buy_button_config": {
            "0": {
              "background_color": "#fe2c55ff",
              "background_color_dark_mode": "#ff3b5cff",
              "display_text": "购买",
              "display_text_color": "#ffffffff",
              "display_text_color_dark_mode": "#ffffffff",
              "toast": ""
            },
            "1": {
              "background_color": "#16182319",
              "background_color_dark_mode": "#ffffff19",
              "display_text": "购买",
              "display_text_color": "#00000052",
              "display_text_color_dark_mode": "#ffffff57",
              "toast": "商品已售罄"
            },
            "2": {
              "background_color": "#16182319",
              "background_color_dark_mode": "#ffffff19",
              "display_text": "购买",
              "display_text_color": "#00000052",
              "display_text_color_dark_mode": "#ffffff57",
              "toast": "商品已售罄"
            },
            "3": {
              "background_color": "#16182319",
              "background_color_dark_mode": "#ffffff19",
              "display_text": "即将开始",
              "display_text_color": "#00000052",
              "display_text_color_dark_mode": "#ffffff57",
              "toast": "你可以在直播秒杀开始时购买此商品。"
            }
          },
          "pin_card_buy_button_config": {
            "0": {
              "background_color": "#FFFE2C55",
              "background_color_dark_mode": "#FFFE2C55",
              "display_text": "购买",
              "display_text_color": "#FFFFFFFF",
              "display_text_color_dark_mode": "#FFFFFFFF",
              "toast": ""
            },
            "1": {
              "background_color": "#0F161823",
              "background_color_dark_mode": "#0F161823",
              "display_text": "购买",
              "display_text_color": "#52000000",
              "display_text_color_dark_mode": "#52000000",
              "toast": "商品已售罄"
            },
            "2": {
              "background_color": "#0F161823",
              "background_color_dark_mode": "#0F161823",
              "display_text": "售罄",
              "display_text_color": "#52000000",
              "display_text_color_dark_mode": "#52000000",
              "toast": "商品已售罄"
            },
            "3": {
              "background_color": "#0F161823",
              "background_color_dark_mode": "#0F161823",
              "display_text": "即将开始",
              "display_text_color": "#52000000",
              "display_text_color_dark_mode": "#52000000",
              "toast": "你可以在直播秒杀开始时购买此商品。"
            }
          }
        },
        "cart_entry": null,
        "cart_meta_bar": null,
        "coupon_entry": null,
        "coupons_activity_ui_type": 3,
        "flash_sale_atmosphere_info": [],
        "flash_sale_refresh_control": {
          "show_atmosphere_begin_millisecond": 1200000,
          "show_atmosphere_stock_change_limit": 0,
          "show_live_flash_sale_atmosphere": 1,
          "weaken_live_flash_sale_atmosphere": 0
        },
        "hot_tags": null,
        "intelligent_sort": false,
        "introduce_id": "0",
        "live_bag_and_pin_card_type": 0,
        "live_bag_entry_layout": {
          "bonus_entry": {
            "link": ""
          },
          "cart_entry": {
            "item_count": 0,
            "link": "aweme://roma_redirect/?roma_default_schema=sslocal%3A%2F%2Fwebcast_lynxview%3Furl%3Dhttps%253A%252F%252Flf19-gecko-source.tiktokcdn.com%252Fobj%252Fbyte-gurd-source-sg%252Ftiktok%252Ffe%252Flive%252Ffe_tiktok_ecommerce_shop_cart%252Fall%252Fpages%252Fmain%252Ftemplate.js%26hide_nav_bar%3D1%26trans_status_bar%3D1%26hide_status_bar%3D0%26enable_code_cache%3D1%26target_handler%3Decom%252Cwebcast%26business_from%3Decom&roma_group_key=roma_schema_group_ecommerce_cart&roma_page_key=roma_schema_page_ecommerce_cart"
          },
          "coupon_entry": {
            "coupon_first_tips": "",
            "link": "aweme://roma_redirect/?spark_page=roma_schema_your_offer&roma_group_key=spark_page_roma_schema_your_offer&roma_page_key=p&trackParams=%7b%22previous_page%22%3a%22live%22%7d",
            "text": "优惠"
          },
          "inside_entries": [],
          "order_entry": {
            "link": ""
          },
          "outside_entries": [
            3,
            2
          ],
          "search_entry": {
            "link": ""
          },
          "wallet_entry": null
        },
        "live_bag_minimalism": 0,
        "order_entry_schema": "",
        "pin_atmosphere_tags": null,
        "pop_bag_index": 0,
        "pop_product": null,
        "popup": null,
        "preview_version": "",
        "product_unavailable_info": null,
        "products": [],
        "promotion_display_info": null,
        "promotion_style": "{\"promotion_label_ui_config\":{                \"height\": 18,                \"configs\": {                    \"1\": {                        \"bgColor\": {                            \"light\": \"#FE2C551A\",                            \"dark\": \"#FF3B5C1A\"                        },                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#FFFFFFE6\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"countdownFont\": 0,                        \"countdownTime\": 86400000,                        \"countdownColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#FFFFFFE6\"                        },                        \"useCountdownText\": true                    },                    \"4\": {                        \"textColor\": {                            \"name\": \"TextPrimary\",                            \"light\": \"#000000FF\",                            \"dark\": \"#FFFFFFE6\"                        },                        \"bgColor\": {                            \"light\": \"#FF5C211A\",                            \"dark\": \"#FF5C211A\"                        },                        \"textFont\": 12,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"countdownFont\": 0,                        \"countdownColor\": {                            \"name\": \"TextPrimary\",                            \"light\": \"#000000FF\",                            \"dark\": \"#FFFFFFE6\"                        },                        \"countdownTime\": 86400000,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"useCountdownText\": true,                        \"hide_text_when_countdown\": true                    },                    \"8\": {                        \"textColor\": {                            \"name\": \"TextPrimary\",                            \"light\": \"#000000FF\",                            \"dark\": \"#FFFFFFE6\"                        },                        \"bgColor\": {                            \"light\": \"#13C2C21F\",                            \"dark\": \"#13C2C21F\"                        },                        \"textFont\": 12,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"rtlIcon\": true                    },                    \"11\": {                        \"bgColor\": {                            \"light\": \"#FE2C551A\",                            \"dark\": \"#FF3B5C1A\"                        },                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#FFFFFFE6\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"extraPosition\": 1                    },                    \"30\": {                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"bgColor\": {                            \"light\": \"#13C2C21F\",                            \"dark\": \"#13C2C21F\"                        },                        \"textFont\": 12,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"rtlIcon\": true                    },                    \"31\": {                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"bgColor\": {                            \"light\": \"#13C2C21F\",                            \"dark\": \"#13C2C21F\"                        },                        \"textFont\": 12,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"rtlIcon\": true                    },                    \"32\": {                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"bgColor\": {                            \"light\": \"#13C2C21F\",                            \"dark\": \"#13C2C21F\"                        },                        \"textFont\": 12,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"rtlIcon\": true                    },                    \"33\": {                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"bgColor\": {                            \"light\": \"#0000000D\",                            \"dark\": \"#FFFFFF21\"                        },                        \"textFont\": 12,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"rtlIcon\": true                    },                    \"34\": {                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"bgColor\": {                            \"light\": \"#0000000D\",                            \"dark\": \"#FFFFFF21\"                        },                        \"textFont\": 12,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"rtlIcon\": true                    },                    \"35\": {                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"bgColor\": {                            \"light\": \"#0000000D\",                            \"dark\": \"#FFFFFF21\"                        },                        \"textFont\": 12,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"rtlIcon\": true                    },                    \"59\": {                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"bgColor\": {                            \"light\": \"#00000000\",                            \"dark\": \"#00000000\"                        },                        \"textFont\": 6                    },                    \"40\": {                        \"bgColor\": {                            \"light\": \"#00000000\",                            \"dark\": \"#00000000\"                        },                        \"iconSize\": {                            \"height\": 14                        },                        \"iconSizeAdaptMode\": 1,                        \"padding\": 0,                        \"radius\": 3                    },                    \"130\": {                        \"bgColor\": {                            \"light\": \"#00000000\",                            \"dark\": \"#00000000\"                        },                        \"iconSize\": {                            \"height\": 14                        },                        \"iconSizeAdaptMode\": 1,                        \"padding\": 0,                        \"radius\": 3                    },                    \"44\": {                        \"bgColor\": {                            \"light\": \"#00000000\",                            \"dark\": \"#00000000\"                        },                        \"iconSize\": {                            \"height\": 15                        },                        \"iconSizeAdaptMode\": 1,                        \"padding\": 0                    },                    \"50\": {                        \"bgColor\": {                            \"light\": \"#00000000\",                            \"dark\": \"#00000000\"                        },                        \"iconSize\": {                            \"height\": 15                        },                        \"iconSizeAdaptMode\": 1,                        \"padding\": 0                    },                    \"67\": {                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"bgColor\": {                            \"light\": \"#13C2C21F\",                            \"dark\": \"#13C2C21F\"                        },                        \"textFont\": 12,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"rtlIcon\": true                    },                    \"66\": {                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"bgColor\": {                            \"light\": \"#0000000D\",                            \"dark\": \"#FFFFFF21\"                        },                        \"textFont\": 12,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"rtlIcon\": true                    },                    \"51\": {                        \"bgColor\": {                            \"dark\": \"#FFFFFF14\",                            \"light\": \"#0000000D\"                        },                        \"textColor\": {                            \"dark\": \"#F6F6F6FF\",                            \"light\": \"#000000FF\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    },                    \"116\": {                        \"bgColor\": {                            \"dark\": \"#FFFFFF14\",                            \"light\": \"#0000000D\"                        },                        \"textColor\": {                            \"dark\": \"#F6F6F6FF\",                            \"light\": \"#000000FF\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    },                    \"117\": {                        \"bgColor\": {                            \"dark\": \"#FFFFFF14\",                            \"light\": \"#0000000D\"                        },                        \"textColor\": {                            \"dark\": \"#F6F6F6FF\",                            \"light\": \"#000000FF\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    },                    \"118\": {                        \"bgColor\": {                            \"light\": \"#0000000D\",                            \"dark\": \"#FFFFFF14\"                        },                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    },                    \"115\": {                        \"bgColor\": {                            \"light\": \"#FE2C5512\",                            \"dark\": \"#FE2C551A\"                        },                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    },                    \"124\": {                        \"bgColor\": {                            \"light\": \"#00000000\",                            \"dark\": \"#00000000\"                        },                        \"iconSize\": {                            \"height\": 14                        },                        \"iconSizeAdaptMode\": 1,                        \"padding\": 0,                        \"radius\": 3                    },                    \"125\": {                        \"bgColor\": {                            \"light\": \"#FE2C551A\",                            \"dark\": \"#FF3B5C1A\"                        },                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#FFFFFFE6\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    },                    \"136\": {                        \"textColor\": {                            \"name\": \"TextPrimary\",                            \"light\": \"#000000FF\",                            \"dark\": \"#FFFFFFE6\"                        },                        \"bgColor\": {                            \"light\": \"#FE2C551A\",                            \"dark\": \"#FF3B5C1A\"                        },                        \"textFont\": 12,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"countdownFont\": 0,                        \"countdownColor\": {                            \"name\": \"TextPrimary\",                            \"light\": \"#000000FF\",                            \"dark\": \"#FFFFFFE6\"                        },                        \"countdownTime\": 86400000,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"useCountdownText\": true                    },                    \"153\": {                        \"bgColor\": {                            \"dark\": \"#FAD8A733\",                            \"light\": \"#FDF6E7FF\"                        },                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"height\": 8,                            \"width\":21                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    },                    \"154\": {                       \"bgColor\": {                            \"dark\": \"#FAD8A733\",                            \"light\": \"#FDF6E7FF\"                        },                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"height\": 8,                            \"width\":21                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    },                    \"155\": {                       \"bgColor\": {                            \"dark\": \"#FAD8A733\",                            \"light\": \"#FDF6E7FF\"                        },                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"height\": 8,                            \"width\":21                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    },                    \"156\": {                        \"bgColor\": {                            \"dark\": \"#FAD8A733\",                            \"light\": \"#FDF6E7FF\"                        },                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"height\": 8,                            \"width\":21                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    },                    \"157\": {                        \"bgColor\": {                            \"dark\": \"#FAD8A733\",                            \"light\": \"#FDF6E7FF\"                        },                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"height\": 8,                            \"width\":21                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    },                    \"158\": {                        \"bgColor\": {                            \"dark\": \"#FAD8A733\",                            \"light\": \"#FDF6E7FF\"                        },                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"height\": 8,                            \"width\":21                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    },                    \"159\": {                        \"bgColor\": {                            \"dark\": \"#FAD8A733\",                            \"light\": \"#FDF6E7FF\"                        },                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"height\": 8,                            \"width\":21                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    },                    \"160\": {                       \"bgColor\": {                            \"dark\": \"#FAD8A733\",                            \"light\": \"#FDF6E7FF\"                        },                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#F6F6F6FF\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"height\": 8,                            \"width\":21                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    },                    \"-1\": {                        \"bgColor\": {                            \"light\": \"#FE2C551A\",                            \"dark\": \"#FF3B5C1A\"                        },                        \"textColor\": {                            \"light\": \"#000000FF\",                            \"dark\": \"#FFFFFFE6\"                        },                        \"textFont\": 12,                        \"padding\": 4,                        \"gap\": 3,                        \"radius\": 4,                        \"iconSize\": {                            \"width\": 12,                            \"height\": 12                        },                        \"suffixIconSize\": {                            \"width\": 12,                            \"height\": 12                        }                    }                }            },\"price_ui_config\":{                \"configs\": {                    \"shop_bag\": {                        \"prefix\": {                            \"color\": {                                \"name\": \"TextPrimary\",                                \"light\": \"#000000FF\",                                \"dark\": \"#FFFFFFE6\"                            },                            \"font\": 4                        },                        \"currency\": {                            \"color\": {                                \"name\": \"TextPrimary\",                                \"light\": \"#000000FF\",                                \"dark\": \"#FFFFFFE6\"                            },                            \"font\": 1                        },                        \"format_available_price\": {                            \"color\": {                                \"name\": \"TextPrimary\",                                \"light\": \"#000000FF\",                                \"dark\": \"#FFFFFFE6\"                            },                            \"font\": 22                        },                        \"origin_price_exceed_length\": 7,                        \"display_price_exceed_length\": 12,                        \"display_currency\": {                            \"color\": {                                \"name\": \"TextPrimary\",                                \"light\": \"#000000FF\",                                \"dark\": \"#FFFFFFE6\"                            },                            \"font\": 13                        },                        \"exceed_display_currency\": {                            \"color\": {                                \"name\": \"TextPrimary\",                                \"light\": \"#000000FF\",                                \"dark\": \"#FFFFFFE6\"                            },                            \"font\": 13                        },                        \"exceed_display_available_price\": {                            \"color\": {                                \"name\": \"TextPrimary\",                                \"light\": \"#000000FF\",                                \"dark\": \"#FFFFFFE6\"                            },                            \"font\": 26                        },                        \"exceed_format_origin_price\": {                            \"color\": {                                \"name\": \"Primary\",                                \"light\": \"#FE2C55FF\",                                \"dark\": \"#FF3B5CFF\"                            },                            \"font\": 0                        },                        \"exceed_discount\": {                            \"color\": {                                \"name\": \"Primary\",                                \"light\": \"#FE2C55FF\",                                \"dark\": \"#FF3B5CFF\"                            },                            \"font\": 4                        },                        \"format_origin_price\": {                            \"color\": {                                \"name\": \"Primary\",                                \"light\": \"#FE2C55FF\",                                \"dark\": \"#FF3B5CFF\"                            },                            \"font\": 12                        },                        \"discount_tag\": {                            \"bg_color\": null,                            \"height\": 13,                            \"border_width\": null,                            \"radius\": null,                            \"border_color\": null,                            \"icon\": null,                            \"text\": {                                \"color\": {                                    \"name\": \"Primary\",                                    \"light\": \"#FE2C55FF\",                                    \"dark\": \"#FF3B5CFF\"                                },                                \"font\": 0                            },                            \"exceed_text\": {                                \"color\": {                                    \"name\": \"Primary\",                                    \"light\": \"#FE2C55FF\",                                    \"dark\": \"#FF3B5CFF\"                                },                                \"font\": 3                            },                            \"exceed_length\": null,                            \"type\": 8,                            \"use_brackets\": true,                            \"use_minus_prefix\": true                        },                        \"live_flash_sale_discount_tag\": {                            \"bg_color\": {                                \"name\": \"Primary\",                                \"light\": \"#FE2C55FF\",                                \"dark\": \"#FF3B5CFF\"                            },                            \"height\": 13,                            \"border_width\": null,                            \"radius\": 4,                            \"border_color\": null,                            \"icon\": null,                            \"text\": {                                \"color\": {                                    \"name\": \"ConstTextInverse\",                                    \"light\": \"#FFFFFFFF\",                                    \"dark\": \"#FFFFFFFF\"                                },                                \"font\": 4                            },                            \"exceed_text\": {                                \"color\": {                                    \"name\": \"ConstTextInverse\",                                    \"light\": \"#FFFFFFFF\",                                    \"dark\": \"#FFFFFFFF\"                                },                                \"font\": 4                            },                            \"exceed_length\": null,                            \"type\": 3,                            \"use_brackets\": false,                            \"use_minus_prefix\": true,                            \"edge_insets\": {                                \"top\": 0,                                \"left\": 2,                                \"bottom\": 0,                                \"right\": 2                            }                        }                    }                }            }}",
        "server_time": 1790691269543,
        "suggested_word_entry": null,
        "total": 0,
        "voucher_content": {
          "show_anchor": false,
          "voucher": null,
          "voucher_auto_claimed": null,
          "voucher_dialog_duration": 0
        },
        "voucher_display_info": null
      },
      "msg": "success"
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.0015 / run
Daily free calls
First 100 calls per day free (shared per organization)

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

author_id
string · required
room_id
string · required
offset
integer · optional
page_size
integer · optional
region
string · optional

Access

Provider
TikTok
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/tiktok/app-v3/live-room-product-list
Authentication
Bearer API key

API README

TikTok Livestream Room Product List API

Retrieve products featured during a broadcast room session by providing room_id and author_id. You can also configure pagination parameters and specify a region.

Use cases

  • Track showcase items featured during broadcast room sessions.
  • Catalog merchandise promoted by specific broadcast hosts.
  • Inspect regional product selections tied to broadcast rooms.

Request

curl -X POST "https://api.sandbase.ai/v1/api/tiktok/app-v3/live-room-product-list" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"author_id": "<author_id>", "room_id": "<room_id>"}'

Parameters

NameTypeRequiredDescription
room_idstringYesLive room id, required parameter.
author_idstringYesAnchor id, required parameter.
offsetintegerNoPage turning cursor, optional parameter, default is 0, increasing by 15 each time.
regionstringNoRegion, optional parameter, default is US.
page_sizeintegerNoNumber per page, optional parameter, default is 15.

Notes

  • room_id and author_id are required to query the product list.
  • The region parameter defaults to US, and other regions like VN may return no data.
  • Pagination is controlled with offset (default 0, incrementing by 15) and page_size (default 15).

Related APIs

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/tiktok/app-v3/live-room-product-list
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/tiktok/app-v3/live-room-product-list" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "author_id": "7408859677050274859",
  "room_id": "7420741353250507562"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
TikTok$0.0015 per callJSONJul 31, 2026
TikTok$0.0015 per callJSONJul 31, 2026
TikTok$0.01 per callJSONJul 31, 2026
TikTok$0.0015 per callJSONJul 31, 2026
TikTok$0.0015 per callJSONJul 31, 2026
TikTok$0.0015 per callJSONJul 31, 2026

Questions

FAQ

How do I use the TikTok Livestream Room Product List API?

Send a POST request to https://api.sandbase.ai/v1/api/tiktok/app-v3/live-room-product-list with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the TikTok Livestream Room Product List API cost?

$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the TikTok Livestream Room Product List API accept?

Required: author_id (string) and room_id (string). Optional: offset (integer), page_size (integer) and region (string). The Parameters table and the Playground on this page list every field.

What does the TikTok Livestream Room Product List API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a TikTok developer account or API key?

No. TikTok Livestream Room Product List runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for TikTok API access separately.