Douyin Ecommerce List Shop Products

26.19 credits/call
ae_douyin_ecommerce_list_shop_products

根据抖音电商店铺ID分页查询店铺商品列表。必填 shopId 为店铺ID,不能用商品ID或创作者UID代替;可选 page 为正整数形式的字符串,首次查询填写 1。每次调用返回当前页商品及分页信息;如需继续浏览,请分别请求后续页。可使用返回的 product_id 查询商品详情、SKU或评论。单次调用只覆盖当前页,不代表店铺全部商品,也不保证每个商品或作品都有完整数据。

Productivity
26.19 credits/call

Pricing

26.19 credits/call
ConditionCharge
Each call26.19 credits/call

Each successful call queries one page and incurs one charge, including when the returned data is empty. Failed calls are not charged.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
pagestringNo要查询的页码,使用正整数形式的字符串;首次查询填写"1"。每次调用返回一页,如需更多结果请单独请求后续页。—
shopIdstringYes必填的抖音电商店铺ID,填写数字字符串;不要填写商品ID或创作者UID。—

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_douyin_ecommerce_list_shop_products' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "page": "1",
    "shopId": "156741130"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 0,
  "data": {
    "page": 1,
    "products": [
      {
        "cover": "https://lf3-cm.ecombdstatic.com/obj/ecom-shop-material/png_m_c4bcb21a6fc80c665994184b22786790_sx_252904_www800-800",
        "month_sales": 250356,
        "price": 5.6,
        "product_id": "3780077097138126997",
        "product_tags": [
          "运费险"
        ],
        "title": "高档镜子全身镜软镜子贴墙自粘穿衣镜卧室宿舍衣柜镜家用全身镜子"
      }
    ],
    "shop_id": "156741130",
    "total": 19,
    "total_pages": 2
  },
  "message": null,
  "recordTime": "2026-11-18T13:49:53.931435574",
  "requestParams": {
    "body": null,
    "query": {
      "page": "1",
      "shopId": "156741130"
    }
  }
}

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