Chanmama Shop Product List

86 credits/call
ae_chanmama_shop_product_list

View products with sales activity from a Chanmama shop during a selected period, including product details and performance metrics.

ProductivitySocial
86 credits/call

Pricing

86 credits/call
ConditionCharge
Each call86 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
queryobjectYes查询条件对象。必填字段:shop_id、start_time、end_time。其余字段可按需填写。—
query.pageintegerNo页码,默认为第1页(每页返回10条)。—
query.sortenum (amount | price | volume | author_count | live_count | aweme_count)No排序字段:volume(销量)、amount(销售额)、price(商品价格)、live_count(关联带货直播数)、aweme_count(关联带货视频数)、author_count(关联带货达人数)。可选值:amount=销售额;price=商品价格;volume=销量;author_count=关联带货达人数;live_count=关联带货直播数;aweme_count=关联带货视频数。—
query.keywordstringNo商品标题关键词(示例:面包、洗面奶)。—
query.shop_idstringYes指定单个小店ID/小店名称。—
query.end_timestringYes结束时间。—
query.bring_wayenum (0 | 1 | 2)No带货方式,1(直播带货为主)、2(视频带货为主)。可选值:0=不限;1=筛选直播带货为主;2=筛选视频带货为主的商品。—
query.start_timestringYes开始时间。—
query.is_new_corpenum (0 | 1)No填1筛选出新上架商品。可选值:0=不限;1=筛选新上架商品。—

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_chanmama_shop_product_list' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "query": {
      "end_time": "2026-11-10",
      "keyword": "乌灵胶囊",
      "page": 1,
      "shop_id": "DjGxiwqt",
      "start_time": "2025-11-11"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 0,
  "data": {
    "data": {
      "category": [
        {
          "类目": [
            {}
          ]
        }
      ],
      "价格分布": [
        {
          "价格范围": ">=500元",
          "商品数": 0,
          "销售额": "0",
          "销售额指数": "-",
          "销量": "0",
          "销量指数": "-"
        }
      ],
      "分页信息": {
        "当前页码": 1,
        "总数据量": 1,
        "总页数": 1,
        "每页数量": 10
      },
      "周期内数据": {
        "周期内关联带货直播数": 0,
        "周期内关联带货视频数": 9,
        "周期内商品总数": 1,
        "周期内总销售额": "2.5w~5w",
        "周期内总销售额指数": "6648.41",
        "周期内总销量": "250~500"
      },
      "品牌列表": [
        {
          "品牌名称": "佐力",
          "商品数": 1
        }
      ],
      "商品列表": [
        {
          "volume_distribution": [
            {}
          ],
          "公开佣金": 0,
          "关联带货直播数": 0,
          "关联带货视频数": 9,
          "品牌名称": "佐力",
          "商品ID": "B7pgXHbQnktFo8Hilpmv1X4BwZKh01md"
        }
      ]
    }
  },
  "msg": "success",
  "rid": "c018a36aaf09da2fdab2e5c2c40aec07"
}

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

Guides using this tool

See how this tool fits into real workflows