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.
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.age | string | No | 达人年龄区间,可选值:18-23、24-30、31-40、41-50、50-,单选。 | — |
query.page | integer | No | 页码,默认为第1页(每页返回50条)。 | — |
query.sort | enum (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.gender | enum (-1 | 0 | 1) | No | 达人性别:-1(不限)、0(男性)、1(女性)。可选值:-1=不限;0=男;1=女。 | — |
query.contact | enum (0 | 1) | No | 填1筛选出简介里有联系方式的达人。可选值:0=不限;1=1。 | — |
query.fans_age | enum (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_level | string | No | 抖音精选联盟带货等级,多选以逗号分隔(如:1,2,3)。 | — |
query.province | string | No | 达人省份,如:福建省,仅支持单个省份。 | — |
query.author_type | enum (0 | 1 | 2) | No | 达人类型:0(不限)、1(直播达人)、2(视频达人)。可选值:0=全部;1=直播达人;2=视频达人。 | — |
query.category_id | string | No | 商品名称,可填写商品品类名称或ID(示例:食品饮料、护肤品)。 | — |
query.fans_gender | enum (-1 | 0 | 1) | No | 达人粉丝画像:-1(不限)、0(粉丝男性居多)、1(粉丝女性居多)。可选值:-1=不限;0=男;1=女。 | — |
query.is_ai_author | enum (1) | No | 填 1 筛选内容主要由 AI 生成的达人。 | — |
query.fans_province | string | No | 达人粉丝省份,如:福建省,仅支持单个省份。 | — |
query.star_category | string | No | 达人视频分类名称(示例:亲子、穿搭)。 | — |
query.follower_count | string | No | 粉丝数区间,格式最小值-最大值(如0-1000)。 | — |
query.is_shop_author | enum (0 | 1) | No | 填1筛选出商家自营号。可选值:0=不限;1=是。 | — |
query.fans_city_level | enum (-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_time | enum (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_play | enum (0 | 1) | No | 填1筛选出达人号。可选值:0=不限;1=是。 | — |
query.clue_author_flag | enum (0 | 1) | No | 填1筛选出视频内容线索获客型账号。可选值:0=不限;1=是。 | — |
query.first_aweme_time | enum (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_range | string | No | 近30天活跃粉丝数区间,格式最小值-最大值(如0-1000)。 | — |
query.verification_type | enum (0 | 1 | 2) | No | 达人认证类型:0(不限)、1(黄V达人)、2(蓝V达人)。可选值:0=不限;1=黄V;2=蓝V。 | — |
query.take_product_level | string | No | 近30天带货销售额区间,格式最小值-最大值(如0-1000)。 | — |
query.take_product_price | enum (-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_method | enum (0 | 2 | 1 | 4) | No | 带货方式:0(不限)、1(视频带货为主)、2(直播带货为主)、4(图文带货为主)。可选值:0=不限;2=直播带货为主;1=视频带货为主;4=图文带货为主。 | — |
query.is_brand_self_author | enum (0 | 1) | No | 填1筛选出品牌自营号。可选值:0=不限;1=是。 | — |
query.fans_top_consumer_group | string | No | 达人粉丝八大人群画像:精致妈妈、小镇青年、新锐白领、都市蓝领、GenZ、小镇中老年、都市银发、资深中产,单选。 | — |
query.has_brand_exclusive_live | enum (0 | 1) | No | 填1筛选出有品牌专场直播的达人。可选值:0=不限;1=是。 | — |
query.main_live_flow_struct_type | enum (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-KeyRequest coderequest.sh
Response exampleresponse.json
This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows

