Chanmama Live Library Search
22 credits/call
ae_chanmama_live_library_search
Search and rank Chanmama livestreams within a selected date range by host, location, category, audience, and sales performance. Finding a creator by name does not guarantee that their livestream records are available for the selected date range. A failed query does not mean the creator had no livestreams. If the parameters are correct and the query still fails, avoid consecutive identical retries, and do not automatically remove the creator filter or expand the date range.
22 credits/call
Pricing
22 credits/call
| Condition | Charge |
|---|---|
| Each call | 22 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
query | object | Yes | 查询条件对象。必填字段:live_begin_time、live_end_time。其余字段可按需填写。 | — |
query.page | integer | No | 页码,默认为第1页(每页返回50条)。 | — |
query.sort | enum (total_user | user_peak | begin_time | duration | product_size | amount | volume) | No | 排序字段:amount(销售额)、volume(销量)、begin_time(开播时间)、total_user(场观)、user_peak(人气峰值)、duration(直播时长)、product_size(商品数)。可选值:total_user=观看人次;user_peak=人气峰值;begin_time=开播时间;duration=直播时长;product_size=商品数;amount=销售额;volume=销量。 | — |
query.volume | string | No | 直播销量区间,格式最小值-最大值(如0-1000)。 | — |
query.keyword | string | No | 直播达人名称(示例:贾乃亮)。 | — |
query.province | string | No | 直播省份(示例:福建省)。 | — |
query.live_state | enum (-1 | 2) | Yes | 直播状态。-1 不限,2 正在直播。 | — |
query.live_end_time | string | Yes | 结束日期(示例:2025-05-02)。 | — |
query.star_category | string | No | 达人视频分类名称(示例:亲子、穿搭)。 | — |
query.follower_count | string | No | 粉丝数区间,格式最小值-最大值(如0-1000)。 | — |
query.is_take_product | enum (0 | 1) | No | 填1带货直播间。可选值:0=不限;1=筛选带货直播间。 | — |
query.live_begin_time | string | Yes | 开始日期(示例:2025-05-02)。 | — |
query.multi_category_id | string | No | 带货商品分类ID/带货商品品类名称/商品名称,多选时按逗号分隔。 | — |
query.is_brand_exclusive | enum (0 | 1) | No | 填1筛选品牌自播直播间。可选值:0=不限;1=品牌自播直播间。 | — |
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_live_library_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"query": {
"is_take_product": "1",
"keyword": "彤彤生鲜优选",
"live_begin_time": "2026-11-04",
"live_end_time": "2026-11-10",
"live_state": -1,
"sort": "amount"
}
}
}'Response exampleresponse.json
{
"code": 0,
"data": {
"data": {
"list": [
{
"author": {
"single_tags": {},
"粉丝数": 360404,
"达人id": "_HyLiM3ozPBt-z5nq4SPV6m1nw-6XzpR",
"达人昵称": "彤彤生鲜优选"
},
"下播时间": "2026-11-05 19:37:07",
"人气峰值": 1557,
"商品数": 14,
"平均在线人数": 715,
"开播时间": "2026-11-05 16:00:41"
}
],
"分页信息": {
"page": 1,
"size": 50,
"totalCount": 5,
"totalPage": 1
}
}
},
"msg": "success",
"rid": "67a0b25d727e20306a979e76a34df22b"
}This example shows part of the response. Copied content is valid JSON.

