Chanmama Shop Live List

86 credits/call
ae_chanmama_shop_live_list

View a Chanmama shop's commerce livestreams for a selected date range, with livestream details and shop sales data.

VideoSocial
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 | begin_time | watch_count | shop_product_count | volume)No排序字段:volume(销量)、amount(销售额)、begin_time(开播时间)、watch_count(观看人次)、shop_product_count(小店商品数)。可选值:amount=销售额;begin_time=开播时间;watch_count=观看人次;shop_product_count=小店商品数;volume=销量。—
query.shop_idstringYes指定单个小店ID/小店名称。—
query.channelsenum (brand_self_author | shop_self_author | common_author)No直播达人类型,brand_self_author(品牌自营号)、shop_self_author(商家自营号)、common_author(达人号)。可选值:brand_self_author=品牌自营号;shop_self_author=商家自营号;common_author=达人号。—
query.end_timestringYes结束时间。—
query.start_timestringYes开始时间。—

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_live_list' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "query": {
      "channels": "brand_self_author",
      "end_time": "2026-11-11",
      "page": 3,
      "shop_id": "NQMwaPHT",
      "start_time": "2026-11-05"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 0,
  "data": {
    "data": {
      "list": [
        {
          "下播时间": "2026-11-07 01:25:04",
          "主播抖音号": "39697418595",
          "关联本店商品数": 29,
          "开播时间": "2026-11-06 19:23:53",
          "本店销售额": "25w~50w",
          "本店销售额指数": "68243.86"
        }
      ],
      "分页信息": {
        "当前页码": 3,
        "数据总页数": 3,
        "每页数据量大小": 10,
        "符合条件的总记录数(基于当前筛选条件)": 29
      },
      "汇总信息": {
        "周期内关联带货直播数": 29,
        "周期内关联直播带货商品数": 146,
        "周期内关联直播带货达人数": 2,
        "周期内直播销售额": "1000w+",
        "周期内直播销售额指数": "4257687.12",
        "周期内直播销量": "1w~2.5w"
      }
    }
  },
  "msg": "success",
  "rid": "b3722d865f4a29ad1494aa57a62e3007"
}

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