[中文]

用途:

获取指定商家的商品列表。

参数:

seller_id: 商家 ID，必填，需与 region 对应。

search_params: 分页游标，首次请求留空。

region: 商品或商家所在地区，US/SG/MY/PH/TH/VN/ID/JP/MX；GB、BR 暂不支持。

返回与使用说明:

商品位于 data.data.products；data.data.has_more 表示是否可继续翻页。

下一页将 data.data.load_more_params.search_params 原样传回 search_params，不要自行拼接游标。

image、seo_url 是对象；商品价格、评分、销量、商家字段分别位于 product_price_info、rate_info、sold_info、seller_info。

每页实际返回数量可能变化。

返回数据结构:

以下为主要字段示意，省略通用响应字段和部分可选字段；具体字段以实际响应为准。

{
  "code": 200,
  "data": {
    "code": 0,
    "message": "success",
    "data": {
      "products": [
        {
          "product_id": "1731128793906516409",
          "title": "Example product",
          "image": {},
          "product_price_info": {},
          "rate_info": {},
          "sold_info": {},
          "seller_info": {},
          "seo_url": {}
        }
      ],
      "has_more": true,
      "load_more_params": {
        "search_params": "next-page-cursor"
      }
    }
  }
}

[English]

Purpose:

Get products from the selected seller.

Parameters:

seller_id: Seller ID, required; must match region.

search_params: Pagination cursor; leave empty for the first request.

region: Product or seller region, US/SG/MY/PH/TH/VN/ID/JP/MX; GB and BR are unavailable.

Response and usage:

Products are in data.data.products; data.data.has_more indicates whether to continue paging.

Pass data.data.load_more_params.search_params unchanged as search_params for the next page; do not construct the cursor yourself.

image and seo_url are objects. Pricing, rating, sales and seller fields are in product_price_info, rate_info, sold_info and seller_info.

The actual number of products per page may vary.

Response Structure:

This example shows the main fields and omits common response fields and some optional fields. Use the fields present in the actual response.

{
  "code": 200,
  "data": {
    "code": 0,
    "message": "success",
    "data": {
      "products": [
        {
          "product_id": "1731128793906516409",
          "title": "Example product",
          "image": {},
          "product_price_info": {},
          "rate_info": {},
          "sold_info": {},
          "seller_info": {},
          "seo_url": {}
        }
      ],
      "has_more": true,
      "load_more_params": {
        "search_params": "next-page-cursor"
      }
    }
  }
}

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.tikhub.io/api/v1/tiktok/shop/web/fetch_seller_products_list?seller_id=7495150558072178725&search_params=30_WzQzOSwzOTAwMDAwMCwxNzIzMDU4NTY3NTM5LCIxNzI5NTc3OTc3OTI0Nzg0MTY1Il0%3D&region=US' \ --header 'Authorization: Bearer <token>'

{ "code": 200, "request_id": "string", "message": "Request successful. This request will incur a charge.", "message_zh": "请求成功，本次请求将被计费。", "support": "Discord: https://discord.gg/aMEAS8Xsvz", "time": "string", "time_stamp": 0, "time_zone": "America/Los_Angeles", "docs": "string", "cache_message": "string", "cache_message_zh": "string", "cache_url": "string", "router": "", "params": {}, "data": null }

获取商家商品列表V1/Get seller products list V1

[中文]

用途:

参数:

返回与使用说明:

返回数据结构:

[English]

Purpose:

Parameters:

Response and usage:

Response Structure:

Request

Responses

获取商家商品列表V1/Get seller products list V1

[中文]#

用途:#

参数:#

返回与使用说明:#

返回数据结构:#

[English]#

Purpose:#

Parameters:#

Response and usage:#

Response Structure:#

Request

Responses

[中文]

用途:

参数:

返回与使用说明:

返回数据结构:

[English]

Purpose:

Parameters:

Response and usage:

Response Structure: