Chanmama Author Live List
22 credits/call
ae_chanmama_author_live_list
View a Chanmama creator's livestream sessions for a date range, with session details and performance metrics.
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 | 必填,所有查询条件必须放在此 query 对象内,不得打平到顶层。必填字段为 author_id、start_date、end_date;可选字段为 page、sort。本工具日期字段是 start_date/end_date,不是 start_time/end_time。不得把达人 ID 当作 JSON 字段名,不添加 Schema 未声明字段。 | — |
query.page | integer | No | 页码,默认为第1页(每页返回10条)。 | — |
query.sort | enum (begin_time | total_user | live_penetration_rate | user_peak | user_value | volume | amount) | No | 排序字段:amount(销售额)、volume(销量)、begin_time(开播时间)、total_user(场观)。可选值:begin_time=开播时间;total_user=观看人次;live_penetration_rate=直播穿透率;user_peak=人气峰值;user_value=uv价值;volume=销量;amount=销售额。 | — |
query.end_date | string | Yes | 必填,查询结束日期,字符串 YYYY-MM-DD,放在 query.end_date。不要写成 end_time,不传时间戳;不得早于 start_date,历史直播查询不要填写晚于当前日期的时间。可查询范围以当前数据源实际覆盖为准。 | — |
query.author_id | string | Yes | 必填,单个达人 ID、达人昵称或抖音号,均按字符串传入;本接口支持昵称和抖音号,不强制转成纯数字 ID。为提高目标识别稳定性,只有达人名称或抖音号时,优先用 ae_chanmama_author_search 检索并确认目标,再使用返回的达人 ID;该搜索工具已作为强前置提示关联。已有确认有效的达人 ID 可直接复用,不重复搜索。昵称/抖音号直传能力仍保留,强关联不是运行时强制拦截。禁止猜测或占位值。必须放在 query.author_id,不得放到顶层,也不得把 ID 值当作字段名。 | — |
query.start_date | string | Yes | 必填,查询起始日期,字符串 YYYY-MM-DD,放在 query.start_date。不要写成 start_time,不传时间戳;与 end_date 同传时,start_date 不得晚于 end_date。可查询范围以当前数据源实际覆盖为准。 | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
Response exampleresponse.json
This example shows part of the response. Copied content is valid JSON.

