Chanmama Shop Library Search

43 credits/call
ae_chanmama_shop_library_search

Find and rank Chanmama shops using sales, audience, delivery location, product activity, and selling-channel filters.

Social
43 credits/call

Pricing

43 credits/call
ConditionCharge
Each call43 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
queryobjectYes查询条件对象。可按需填写筛选项;Schema 中没有必填的内部字段。—
query.pageintegerNo页码,默认为第1页(每页返回50条)。—
query.sortenum (amount | volume | total_product_num | expr_score | author_count | live_count | aweme_count)No排序字段:total_product_num(动销商品数)、dvolume(销量)、amount(销售额)、author_count(关联达人数)。可选值:amount=销售额;volume=销量;total_product_num=动销商品数;expr_score=商品体验分;author_count=关联带货达人数;live_count=关联带货直播数;aweme_count=关联带货视频数。—
query.channelstringNo带货渠道:1(达人号为主)、2(品牌自营号为主)、3(商家自营号为主)。—
query.day_typestringNo可选查询周期:day(昨天)、week(近7天)、month(近30天)。—
query.fans_ageenum (2 | 3 | 4 | 5 | 6)No受众画像年龄区间,1(18-23岁)、2(24-30岁)、3(31-40岁)、4(41-50岁)、5(50岁以上),单选。可选值:2=18-23岁;3=24-30岁;4=31-40岁;5=41-50岁;6=50岁以上。—
query.category_idstringNo商品名称/商品分类,可填写商品品类名称或ID(示例:食品饮料、护肤品、牙膏)。—
query.fans_genderenum (-1 | 0 | 1)No受众画像性别,-1(不限)、0(男性居多)、1(女性居多)。可选值:-1=不限;0=男性居多;1=女性居多。—
query.most_volumestringNo销售方式:1(视频带货为主)、2(直播带货为主)、3(商品卡带货为主)。—
query.deliver_areastringNo主要发货地,如:福建省,仅支持单个省份。—
query.is_new_productstringNo填1筛选周期内新上架商品。—
query.most_live_volumeenum (0 | 51)No填51筛选直播带货为主的小店。可选值:0=不限;51=筛选直播带货为主的小店。—
query.most_aweme_volumeenum (0 | 51)No填51筛选视频带货为主的小店。可选值:0=不限;51=筛选视频带货为主的小店。—
query.bring_channel_shopenum (0 | 1)No填1筛选商家自营销售为主的小店。可选值:0=不限;1=筛选商家自营号带货为主的小店。—
query.duration_avg_pricestringNo客单价区间,格式最小值-最大值(如0-1000)。—
query.bring_channel_brandenum (0 | 1)No填1筛选品牌自营销售为主的小店。可选值:0=不限;1=筛选品牌自营号带货为主的小店。—
query.duration_avg_amountstringNo周期内销售额区间,格式最小值-最大值(如0-1000)。—
query.bring_channel_authorenum (0 | 1)No填1筛选达人号销售为主的小店。可选值:0=不限;1=筛选达人号带货为主的小店。—

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_shop_library_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "query": {
      "category_id": "风筝",
      "day_type": "month",
      "page": 1,
      "sort": "amount"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 0,
  "data": {
    "data": {
      "list": [
        {
          "主营类目": "礼品文创",
          "关联带货直播数": "-",
          "关联带货视频数": "-",
          "关联带货达人数": "-",
          "客单价": "-",
          "小店ID": "npCPZCLw"
        }
      ],
      "分页信息": {
        "当前页数": 1,
        "总记录数": 8,
        "总页数": 1,
        "每页大小": 50
      }
    }
  },
  "msg": "success",
  "rid": "035a055c173811eb7701448e675c38b0"
}

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