Chanmama Product Library Search

22 credits/call
ae_chanmama_product_library_search

Search Chanmama’s product library by keyword and filters such as category, price, sales, commission rate, sales channel, and audience profile. View product titles, images, prices, key metrics, and 30-day sales trends, and sort results by performance metrics. Some keyword or filter combinations may fail to return a result. A failed query does not mean that no products match. Once parameters are confirmed, avoid repeated identical requests in a short period.

Productivity
22 credits/call

Pricing

22 credits/call
ConditionCharge
Each call22 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
queryobjectYes查询条件对象。可按需填写筛选项;Schema 中没有必填的内部字段。—
query.pageintegerNo页码,默认为第1页(每页返回50条)。—
query.sortenum (mulit_commission_rate | duration_volume | duration_live_volume | duration_aweme_volume | duration_other_volume | duration_author_count | duration_live_count | duration_amount | duration_live_amount | duration_aweme_amount | duration_other_amount | history_total_volume | history_total_amount | duration_aweme_count | duration_pv | duration_product_rate)No排序字段:duration_volume(销量)、duration_amount(销售额)、duration_live_volume(直播销量)、duration_live_amount(直播销售额)、duration_aweme_volume(视频销量)、duration_aweme_amount(视频销售额)、duration_other_amount(商品卡销售额)、duration_other_volume(商品卡销量)、duration_author_count(关联达人数),history_total_volume(近一年销量)、history_total_amount(近一年销售额)、duration_product_rate(近30天转化率)、duration_aweme_count(关联视频数)、duration_live_count(关联直播数)。可选值:mulit_commission_rate=佣金比例;duration_volume=周期销量;duration_live_volume=周期直播销量;duration_aweme_volume=周期视频销量;duration_other_volume=周期商品卡销量;duration_author_count=关联达人数;duration_live_count=关联直播数;duration_amount=周期销售额;duration_live_amount=周期直播销售额;duration_aweme_amount=周期视频销售额;duration_other_amount=周期商品卡销售额;history_total_volume=近一年销量;history_total_amount=近一年销售额;duration_aweme_count=关联视频数;duration_pv=周期内浏览量;duration_product_rate=周期内转化率。—
query.pricestringNo商品价格区间,格式最小值-最大值(如0-1000)。—
query.channelenum (-1 | 1 | 2 | 3)No带货渠道:1(达人号为主)、2(品牌自营号为主)、3(商家自营号为主)。可选值:-1=不限;1=达人号为主;2=品牌自营号为主;3=商家自营号为主。—
query.keywordstringNo商品属性/商品标题关键字(示例:面包、洗面奶)。—
query.day_typeenum (1 | 7 | 30)No可选查询周期:1(昨天)、7(近7天)、30(近30天)。可选值:1=昨天;7=近7天;30=近30天。—
query.fans_ageenum (1 | 2 | 3 | 4 | 5)No观众画像年龄区间,1(18-23岁)、2(24-30岁)、3(31-40岁)、4(41-50岁)、5(50岁以上),单选。可选值:1=18-23岁;2=24-30岁;3=31-40岁;4=41-50岁;5=50岁以上。—
query.order_ageenum (1 | 2 | 3 | 4 | 5)No成交画像年龄区间,1(18-23岁)、2(24-30岁)、3(31-40岁)、4(41-50岁)、5(50岁以上),单选。可选值:1=18-23岁;2=24-30岁;3=31-40岁;4=41-50岁;5=50岁以上。—
query.fans_genderenum (0 | 1 | 2)No观众画像性别:-1(不限)、0(粉丝男性居多)、1(粉丝女性居多)。可选值:0=不限;1=观众画像-男性居多;2=观众画像-女性居多。—
query.most_volumeenum (-1 | 1 | 2 | 3)No销售方式:1(视频带货为主)、2(直播带货为主)、3(商品卡带货为主)。可选值:-1=不限;1=视频带货为主;2=直播带货为主;3=商品卡带货为主。—
query.order_genderenum (0 | 1 | 2)No成交画像性别,1(男性成交居多)、2(女性成交居多)。可选值:0=不限;1=成交画像-男性居多;2=成交画像-女性居多。—
query.fans_provincestringNo观众画像省份,如:福建省,仅支持单个省份。—
query.is_new_productenum (0 | 1)No填1筛选周期内新上架商品。可选值:0=不限;1=筛选新上架商品。—
query.duration_volumestringNo周期内销量区间,格式最小值-最大值(如0-1000)。—
query.multi_category_idstringNo商品分类ID/商品品类名称,可多选(多选用逗号分隔)。—
query.duration_author_countstringNo周期内关联达人数,格式最小值-最大值(如100-200、100-)。—
query.mulit_commission_ratestringNo精选联盟佣金比例区间,单位百分比,格式最小值-最大值(如10-20、10-)。—

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_product_library_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "query": {
      "channel": "1",
      "day_type": "30",
      "duration_author_count": "30-300",
      "duration_volume": "5000-",
      "most_volume": "1",
      "page": 1,
      "sort": "duration_volume"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 0,
  "data": {
    "data": {
      "list": [
        {
          "关联带货直播数": 0,
          "关联带货视频数": 854,
          "关联带货达人数": 219,
          "关联的带货达人数": 0,
          "分类信息": {
            "一级分类": "食品饮料",
            "三级分类": "零食/坚果/特产",
            "二级分类": 0
          },
          "周期内商品卡销售额": "0"
        }
      ],
      "分页信息": {
        "page": 1,
        "size": 50,
        "totalCount": 17,
        "totalPage": 1
      }
    }
  },
  "msg": "success",
  "rid": "bd3d55d7f1e637fbd3d577ed0a4fdba0"
}

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

Guides using this tool

See how this tool fits into real workflows