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.

Social
22 credits/call

Pricing

22 credits/call
ConditionCharge
Each call22 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
queryobjectYes必填,所有查询条件必须放在此 query 对象内,不得打平到顶层。必填字段为 author_id、start_date、end_date;可选字段为 page、sort。本工具日期字段是 start_date/end_date,不是 start_time/end_time。不得把达人 ID 当作 JSON 字段名,不添加 Schema 未声明字段。—
query.pageintegerNo页码,默认为第1页(每页返回10条)。—
query.sortenum (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_datestringYes必填,查询结束日期,字符串 YYYY-MM-DD,放在 query.end_date。不要写成 end_time,不传时间戳;不得早于 start_date,历史直播查询不要填写晚于当前日期的时间。可查询范围以当前数据源实际覆盖为准。—
query.author_idstringYes必填,单个达人 ID、达人昵称或抖音号,均按字符串传入;本接口支持昵称和抖音号,不强制转成纯数字 ID。为提高目标识别稳定性,只有达人名称或抖音号时,优先用 ae_chanmama_author_search 检索并确认目标,再使用返回的达人 ID;该搜索工具已作为强前置提示关联。已有确认有效的达人 ID 可直接复用,不重复搜索。昵称/抖音号直传能力仍保留,强关联不是运行时强制拦截。禁止猜测或占位值。必须放在 query.author_id,不得放到顶层,也不得把 ID 值当作字段名。—
query.start_datestringYes必填,查询起始日期,字符串 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-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_chanmama_author_live_list' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "query": {
      "author_id": "yAh7djCCJdmo65hMsHoN_Y6iqGFzAHVq",
      "end_date": "2026-11-10",
      "page": 2,
      "sort": "begin_time",
      "start_date": "2026-11-03"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 0,
  "data": {
    "data": {
      "list": [
        {
          "uv价值": "5~10",
          "下播时间": "2026-11-04 11:59:34",
          "人气峰值": 54,
          "商品数": 8,
          "客单价": "2800~3000",
          "平均停留时间": 0
        }
      ],
      "分页信息": {
        "page": 2,
        "size": 10,
        "totalCount": 12,
        "totalPage": 2
      },
      "周期内直播总销售额": "100w~250w",
      "周期内直播总销售额指数": "268616.15",
      "周期内直播总销量": "500~1000",
      "周期内直播总销量指数": "188.21"
    }
  },
  "msg": "success",
  "rid": "9db591d4cbc61b4abb8441ee380339f7"
}

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