Chanmama Author Recommend

22 credits/call
ae_chanmama_author_recommend

Get Chanmama creator recommendations for brand seeding, live or video product sales, or creators similar to a selected account. Similar-creator recommendations may fail for some creators even when their profiles are available. If the inputs are correct, avoid repeating the same query.

Social
22 credits/call

Pricing

22 credits/call
ConditionCharge
Each call22 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
queryobjectYes查询条件对象。必填字段:recommend_type。其余字段可按需填写。—
query.pageintegerNo页码,默认为第1页(每页返回50条)。—
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.author_idsstringNorecommend_type=4时必需填写,填写参考达人ID/达人名称,多个用英文逗号分隔。—
query.brand_codesstringNorecommend_type=1时必需填写,填写品牌ID/品牌名称(示例:韩束、洗面奶、牛奶面包)。—
query.fans_genderenum (-1 | 1 | 2)No填0筛选出粉丝男性居多的达人,填1筛选出粉丝女性居多的达人。可选值:-1=不限;1=男性居多;2=女性居多。—
query.product_wordstringNorecommend_type=2和3时必需填写,填写商品词(示例:洗面奶、牛奶面包)。—
query.follower_countstringNo粉丝数区间,格式最小值-最大值(如0-1000)。—
query.recommend_typeenum (1 | 2 | 3 | 4)Yes推荐场景:1(按品牌名称推荐潜力合作的视频种草达人)、2(按商品名称推荐潜力合作的直播带货达人)、3(按商品名称推荐潜力合作的视频带货达人)、4(推荐与达人相似的其他达人)。可选值:1=根据品牌推荐营销种草达人;2=根据商品词推荐直播带货达人;3=根据商品词推荐视频带货达人;4=根据达人推荐其他相似达人/对标达人。—
query.live_average_amountstringNo直播场均销售额区间,格式最小值-最大值(如0-1000),recommend_type=2时有效。—
query.aweme_average_amountstringNo视频平均销售额区间,格式最小值-最大值(如0-1000),recommend_type=3时有效。—

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_recommend' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "query": {
      "follower_count": "10000-50000",
      "page": 1,
      "product_word": "电动轮椅",
      "recommend_type": "2"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 0,
  "data": {
    "data": {
      "list": [
        {
          "推荐信息": {
            "推荐理由": ""
          },
          "最新视频": [
            {}
          ],
          "达人信息": {
            "活跃粉丝数": 3112,
            "粉丝数": 33685,
            "达人id": "GFz37xX0dqR2hzBFR9e14fBba2XBXIB2",
            "达人主营类目": [],
            "达人分类": "居家",
            "达人昵称": "夜炬电子程"
          },
          "达人数据": {
            "匹配度": 0.7041,
            "场均销售额": "1w~2.5w",
            "场均销售额指数": "3415.58",
            "带货商品价格段": [],
            "平均场观": 44597,
            "平均赞粉比": 0.15
          }
        }
      ],
      "分页信息": {
        "page": 1,
        "size": 50,
        "totalCount": 1,
        "totalPage": 1
      }
    }
  },
  "msg": "success",
  "rid": "51e0396c8db295943637af49582b1bd4"
}

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