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.
86 credits/call
Pricing
86 credits/call
| Condition | Charge |
|---|---|
| Each call | 86 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
query | object | Yes | 查询条件对象。必填字段:shop_id、start_time、end_time。其余字段可按需填写。 | — |
query.page | integer | No | 页码,默认为第1页(每页返回10条)。 | — |
query.sort | enum (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_id | string | Yes | 指定单个小店ID/小店名称。 | — |
query.channels | enum (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_time | string | Yes | 结束时间。 | — |
query.start_time | string | Yes | 开始时间。 | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest 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
{
"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.

