Chanmama Ad Video Material Search
107 credits/call
ae_chanmama_ad_video_material_search
Find high-performing Qianchuan video ad creatives by date range, keyword, product category, or ad type, with performance-based sorting.
107 credits/call
Pricing
107 credits/call
| Condition | Charge |
|---|---|
| Each call | 107 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
query | object | Yes | 查询条件对象。必填字段:start_date、end_date。其余字段可按需填写。 | — |
query.page | integer | No | 页码,默认为第1页(每页返回50条)。 | — |
query.type | enum (-1 | 1 | 2) | No | 素材类型::-1(不限)、1(直播引流广告素材)、2(商品挂链广告素材)。可选值:-1=不限;1=直播引流广告素材;2=商品挂链广告素材。 | — |
query.keyword | string | No | 视频标题/达人名称/直播间标题/商品/品牌/口播文案关键词(示例:拆箱)。 | — |
query.end_date | string | Yes | 结束时间。 | — |
query.sort_field | enum (nearly_3_play_count | total_play_count | digg_count | run_score) | No | 排序字段:nearly_3_play_count(近3日播放量)、digg_count(点赞数),total_play_count(总播放量),run_score(蝉妈妈跑量分)。可选值:nearly_3_play_count=近3日播放量;total_play_count=总播放量;digg_count=点赞数;run_score=跑量分。 | — |
query.start_date | string | Yes | 开始时间。 | — |
query.category_id | string | No | 带货商品分类ID/带货商品分类名称(示例:食品饮料、护肤品)。 | — |
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_ad_video_material_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"query": {
"end_date": "2026-11-06",
"keyword": "黄导",
"page": 1,
"sort_field": "digg_count",
"start_date": "2026-10-22",
"type": "-1"
}
}
}'Response exampleresponse.json
{
"code": 0,
"data": {
"data": {
"分页信息": {
"page": 1,
"size": 50,
"totalCount": 20,
"totalPage": 1
},
"素材列表": [
{
"商品id": "",
"商品标题": "",
"总播放量": 2203,
"收藏数": 1,
"点赞数": 4,
"素材ID": "WJVaKZohdQXncT0ZLOpkYmsjdlhNSSauaz99qNve56n4SPD83ucRGQ"
}
]
}
},
"msg": "success",
"rid": "7b0e04e337b1ca7d9aa5db00f5ed69f0"
}This example shows part of the response. Copied content is valid JSON.

