TikTok Shop Fetch Search Products List

2.07 credits/call
ae_tiktok_shop_fetch_search_products_list

Search for products by keyword in a selected region. Parameters: - search_word (required): Keyword to search for. - region (optional, default US): Supported values are US, SG, MY, PH, TH, VN, ID, JP, and MX. GB and BR are not supported. - offset (optional, default 0): Pagination offset. Use the default for the first request. - page_token (optional, default empty): Pagination token. Leave empty for the first request. Results: - Product entries are returned in data.data.products. Available product fields depend on the response; image and seo_url are objects. - data.data.has_more indicates whether more results are available. - For the next page, use the offset and page_token from data.data.load_more_params unchanged, and keep search_word and region the same. Page size can vary, so do not calculate offset from the number of returned products.

Productivity
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 requires another call, which is charged separately.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
offsetintegerNo偏移量/Offset0
regionstringNo地区代码/Region code: US, SG, MY, PH, TH, VN, ID, JP, MX。GB 和 BR 暂不支持 / GB and BR are unavailable.US
page_tokenstringNo分页标记/Page token""
search_wordstringYes搜索关键词/Search keyword—

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_search_products_list' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "offset": 0,
    "page_token": "",
    "region": "TH",
    "search_word": "vivo Y21d"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "code": 0,
    "data": {
      "products": [
        {
          "image": {
            "height": 1200,
            "uri": "tos-alisg-i-aphluv4xwc-sg/c4dd18b91b234705bdf89b9c796795f9",
            "url_list": [],
            "width": 1200
          },
          "product_id": "1735526999605347974",
          "product_marketing_info": {
            "placement_labels": {},
            "placement_labels_ui": {}
          },
          "product_price_info": {
            "currency_name": "THB",
            "currency_show_mode": 1,
            "currency_symbol": "฿",
            "discount_decimal": "0.05",
            "discount_format": "5%",
            "origin_price_decimal": "10979"
          },
          "rate_info": {
            "review_count": "0",
            "score": 0
          },
          "title": "【ของแท้100%】2026 ใหม Y21D 5G 7.5นิ้ว โทรศัพท์มือถือ รองรับ2ซิม Smartphone 4G/5G แรม16GB รอม1TB โทรศัพท์ถูกๆ 32MP+64M ขายร้อนกรุงเทพฯ จัดส่งฟรีส่งไปยังสถาน ที่ ที่น้องสาวรัก"
        }
      ]
    },
    "message": "success"
  },
  "docs": "https://api.tikhub.io/#/TikTok-Shop-Web-API/fetch_search_products_list_api_v1_tiktok_shop_web_fetch_search_products_list_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "request_id": "b08565dc-7c18-4922-a20b-e402287a0eab"
}

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