Chanmama Author Library Search

22 credits/call
ae_chanmama_author_library_search

Search Chanmama’s creator library using filters for profile, audience, content, product category, and sales performance.

Social
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.agestringNo达人年龄区间,可选值:18-23、24-30、31-40、41-50、50-,单选。—
query.pageintegerNo页码,默认为第1页(每页返回50条)。—
query.sortenum (inc_follower | follower_count | total_amount_30 | aweme_total_amount_30 | live_total_amount_30)No排序字段:follower_count(粉丝数)、inc_follower(粉丝增量)、total_amount_30(近30天销售额)、aweme_total_amount_30(近30天视频销售额)、live_total_amount_30(近30天直播销售额)。可选值:inc_follower=粉丝增量;follower_count=粉丝数;total_amount_30=近30日销售额;aweme_total_amount_30=近30日视频销售额;live_total_amount_30=近30日直播销售额。—
query.genderenum (-1 | 0 | 1)No达人性别:-1(不限)、0(男性)、1(女性)。可选值:-1=不限;0=男;1=女。—
query.contactenum (0 | 1)No填1筛选出简介里有联系方式的达人。可选值:0=不限;1=1。—
query.fans_ageenum (18-23 | 24-30 | 31-40 | 41-50 | 50-)No达人粉丝年龄区间,可选值:18-23、24-30、31-40、41-50、50-,单选。可选值:18-23=18-23岁;24-30=24-30岁;31-40=31-40岁;41-50=41-50岁;50-=50岁以上。—
query.jx_levelstringNo抖音精选联盟带货等级,多选以逗号分隔(如:1,2,3)。—
query.provincestringNo达人省份,如:福建省,仅支持单个省份。—
query.author_typeenum (0 | 1 | 2)No达人类型:0(不限)、1(直播达人)、2(视频达人)。可选值:0=全部;1=直播达人;2=视频达人。—
query.category_idstringNo商品名称,可填写商品品类名称或ID(示例:食品饮料、护肤品)。—
query.fans_genderenum (-1 | 0 | 1)No达人粉丝画像:-1(不限)、0(粉丝男性居多)、1(粉丝女性居多)。可选值:-1=不限;0=男;1=女。—
query.is_ai_authorenum (1)No填 1 筛选内容主要由 AI 生成的达人。—
query.fans_provincestringNo达人粉丝省份,如:福建省,仅支持单个省份。—
query.star_categorystringNo达人视频分类名称(示例:亲子、穿搭)。—
query.follower_countstringNo粉丝数区间,格式最小值-最大值(如0-1000)。—
query.is_shop_authorenum (0 | 1)No填1筛选出商家自营号。可选值:0=不限;1=是。—
query.fans_city_levelenum (-1 | 0 | 1 | 2 | 3 | 4 | 5 | 6)No达人粉丝城市等级:-1(不限)、0(新一线)、1(一线)、2(二线)、3(三线)、4(四线)、5(五线),单选。可选值:-1=不限;0=新一线;1=一线;2=二线;3=三线;4=四线;5=五线;6=其他。—
query.first_live_timeenum (3 | 7 | 15 | 30 | 90 | 180 | 180+)No达人首次开播时间:3(近3天)、7(近7天)、15(近15天)、30(近30天)、90(近90天)、180(近180天)、180+(超过180天),单选。可选值:3=近3天;7=近7天;15=近15天;30=近30天;90=近90天;180=近180天;180+=超过180天。—
query.author_self_playenum (0 | 1)No填1筛选出达人号。可选值:0=不限;1=是。—
query.clue_author_flagenum (0 | 1)No填1筛选出视频内容线索获客型账号。可选值:0=不限;1=是。—
query.first_aweme_timeenum (0 | 3 | 7 | 15 | 30 | 90 | 180 | 180+)No达人首次发布视频时间:3(近3天)、7(近7天)、15(近15天)、30(近30天)、90(近90天)、180(近180天)、180+(超过180天),单选。可选值:0=不限;3=近3天;7=近7天;15=近15天;30=近30天;90=近90天;180=近180天;180+=超过180天。—
query.active_fans_rangestringNo近30天活跃粉丝数区间,格式最小值-最大值(如0-1000)。—
query.verification_typeenum (0 | 1 | 2)No达人认证类型:0(不限)、1(黄V达人)、2(蓝V达人)。可选值:0=不限;1=黄V;2=蓝V。—
query.take_product_levelstringNo近30天带货销售额区间,格式最小值-最大值(如0-1000)。—
query.take_product_priceenum (-10 | 10-50 | 50-100 | 100-500 | 500-10000 | 10000-)No带货商品价格区间,格式最小值-最大值(如0-1000)。可选值:-10=小于10元;10-50=10-50元;50-100=50-100元;100-500=100-500元;500-10000=500-10000元;10000-=大于10000元。—
query.take_product_methodenum (0 | 2 | 1 | 4)No带货方式:0(不限)、1(视频带货为主)、2(直播带货为主)、4(图文带货为主)。可选值:0=不限;2=直播带货为主;1=视频带货为主;4=图文带货为主。—
query.is_brand_self_authorenum (0 | 1)No填1筛选出品牌自营号。可选值:0=不限;1=是。—
query.fans_top_consumer_groupstringNo达人粉丝八大人群画像:精致妈妈、小镇青年、新锐白领、都市蓝领、GenZ、小镇中老年、都市银发、资深中产,单选。—
query.has_brand_exclusive_liveenum (0 | 1)No填1筛选出有品牌专场直播的达人。可选值:0=不限;1=是。—
query.main_live_flow_struct_typeenum (0 | 3 | 1 | 2 | 5 | 6)No达人直播流量主要来源:0(不限)、1(短视频&投放素材引流为主)、2(关注为主)、3(推荐Feed流为主)、5(其他)、6(搜索为主),单选。可选值:0=不限;3=推荐feed流为主;1=短视频引流为主;2=关注为主;5=其他;6=搜索为主。—

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_author_library_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "query": {
      "category_id": "3C数码家电",
      "fans_gender": "0",
      "follower_count": "10000-100000",
      "is_brand_self_author": "0",
      "page": 1,
      "sort": "aweme_total_amount_30",
      "take_product_level": "1000000-10000000",
      "take_product_method": "1"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 0,
  "data": {
    "data": {
      "list": [
        {
          "AI达人": 0,
          "带货商品价格区间": "500-10000",
          "抖音号": "wang58582",
          "昨日新增粉丝数": 86,
          "活跃粉丝数": 14538,
          "直播平均UV价值": "1~2"
        }
      ],
      "分页信息": {
        "page": 1,
        "size": 50,
        "totalCount": 1,
        "totalPage": 1
      }
    }
  },
  "msg": "success",
  "rid": "f6ef1093be2541062602be841c8002f3"
}

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

Guides using this tool

See how this tool fits into real workflows