TikTok Shop Fetch Seller Products List

2.07 credits/call
ae_tiktok_shop_fetch_seller_products_list

Retrieve the product list for a seller in a selected region. Parameters: - seller_id (required): Seller ID for the seller whose products you want to retrieve. - region (optional, default: US): Region code. Supported values are US, SG, MY, PH, TH, VN, ID, JP, and MX. GB and BR are not supported. - search_params (optional): Pagination cursor. Leave it empty or omit it for the first page. To request the next page, pass the value from data.data.load_more_params.search_params in the previous response unchanged; do not create or modify the cursor. Response: - Product entries are in data.data.products. The returned product count may vary by page. - data.data.has_more indicates whether more products are available. - Each product may include product_id, title, image, product_price_info, rate_info, sold_info, seller_info, and seo_url. image and seo_url are objects; pricing, ratings, sales, and seller details are grouped in the corresponding fields. - The response may contain additional common or optional fields; use the fields present in the actual response.

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

Each call has a fixed charge of 2.07 credits. Charges are per query. A successful query is billed even if it returns no results.

Fetching the next page with a pagination cursor is a new call and is charged separately. The number of products returned per page may vary; charges are based on the number of calls.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
regionstringNo地区代码/Region code: US, SG, MY, PH, TH, VN, ID, JP, MX。GB 和 BR 暂不支持 / GB and BR are unavailable.US
seller_idstringYes卖家ID/Seller ID—
search_paramsstringNo搜索参数(用于分页)/Search params (for pagination)""

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_shop_fetch_seller_products_list' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "region": "US",
    "seller_id": "8646932003736687332"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "code": 0,
    "data": {
      "products": [
        {
          "brand_info": {
            "brand_name": "SENBONO"
          },
          "image": {
            "height": 1000,
            "uri": "tos-maliva-i-o3syd03w52-us/f0767ecaf2b24ef886375736bdbd1bc4",
            "url_list": [],
            "width": 1000
          },
          "product_id": "1729543855807566564",
          "product_marketing_info": {
            "placement_labels": {},
            "placement_labels_ui": {}
          },
          "product_price_info": {
            "currency_name": "USD",
            "currency_show_mode": 1,
            "currency_symbol": "$",
            "price_prefix": "From",
            "sale_price_decimal": "36.77",
            "sale_price_format": "36.77"
          },
          "title": "【Black Friday】Smart Glasses with Mic, Wireless Audio Glasses with Transparent Lenses for Listening to Music & Calling, for Home & Daily Use, Wireless Audio Eyewear #GLOBAL PICKS"
        }
      ]
    },
    "message": "success"
  },
  "docs": "https://api.tikhub.io/#/TikTok-Shop-Web-API/fetch_seller_products_list_api_v1_tiktok_shop_web_fetch_seller_products_list_get",
  "message": "Request successful. This request will incur a charge."
}

This example shows part of the response. Copied content is valid JSON.