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.
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 | 查询条件对象。可按需填写筛选项;Schema 中没有必填的内部字段。 | — |
query.page | integer | No | 页码,默认为第1页(每页返回50条)。 | — |
query.sort | enum (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.price | string | No | 商品价格区间,格式最小值-最大值(如0-1000)。 | — |
query.channel | enum (-1 | 1 | 2 | 3) | No | 带货渠道:1(达人号为主)、2(品牌自营号为主)、3(商家自营号为主)。可选值:-1=不限;1=达人号为主;2=品牌自营号为主;3=商家自营号为主。 | — |
query.keyword | string | No | 商品属性/商品标题关键字(示例:面包、洗面奶)。 | — |
query.day_type | enum (1 | 7 | 30) | No | 可选查询周期:1(昨天)、7(近7天)、30(近30天)。可选值:1=昨天;7=近7天;30=近30天。 | — |
query.fans_age | enum (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_age | enum (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_gender | enum (0 | 1 | 2) | No | 观众画像性别:-1(不限)、0(粉丝男性居多)、1(粉丝女性居多)。可选值:0=不限;1=观众画像-男性居多;2=观众画像-女性居多。 | — |
query.most_volume | enum (-1 | 1 | 2 | 3) | No | 销售方式:1(视频带货为主)、2(直播带货为主)、3(商品卡带货为主)。可选值:-1=不限;1=视频带货为主;2=直播带货为主;3=商品卡带货为主。 | — |
query.order_gender | enum (0 | 1 | 2) | No | 成交画像性别,1(男性成交居多)、2(女性成交居多)。可选值:0=不限;1=成交画像-男性居多;2=成交画像-女性居多。 | — |
query.fans_province | string | No | 观众画像省份,如:福建省,仅支持单个省份。 | — |
query.is_new_product | enum (0 | 1) | No | 填1筛选周期内新上架商品。可选值:0=不限;1=筛选新上架商品。 | — |
query.duration_volume | string | No | 周期内销量区间,格式最小值-最大值(如0-1000)。 | — |
query.multi_category_id | string | No | 商品分类ID/商品品类名称,可多选(多选用逗号分隔)。 | — |
query.duration_author_count | string | No | 周期内关联达人数,格式最小值-最大值(如100-200、100-)。 | — |
query.mulit_commission_rate | string | No | 精选联盟佣金比例区间,单位百分比,格式最小值-最大值(如10-20、10-)。 | — |
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_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
{
"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

