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.

Video
107 credits/call

Pricing

107 credits/call
ConditionCharge
Each call107 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
queryobjectYes查询条件对象。必填字段:start_date、end_date。其余字段可按需填写。—
query.pageintegerNo页码,默认为第1页(每页返回50条)。—
query.typeenum (-1 | 1 | 2)No素材类型::-1(不限)、1(直播引流广告素材)、2(商品挂链广告素材)。可选值:-1=不限;1=直播引流广告素材;2=商品挂链广告素材。—
query.keywordstringNo视频标题/达人名称/直播间标题/商品/品牌/口播文案关键词(示例:拆箱)。—
query.end_datestringYes结束时间。—
query.sort_fieldenum (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_datestringYes开始时间。—
query.category_idstringNo带货商品分类ID/带货商品分类名称(示例:食品饮料、护肤品)。—

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_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
JSONPartial content
{
  "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.