OpenAPI

creators lookalike

POST/v1/creators/lookalike

Authentication: X-API-Key
Required scope: creator:lookalike:search
Billing: Pricing follows your active account rules
Rate limits: View your active rate limits

Parameters

Send this request as a JSON body.

usernamestringOptional

达人用户名（不含 @）

platformstringOptional

达人所在平台

tiktok · instagram · youtube

profile_urlstringOptional

达人主页地址（自动解析平台和用户名）

target_platformstringOptional

目标搜索平台，不传则与种子达人同平台

tiktok · instagram · youtube

target_regionstringOptional

目标地区代码

target_languagestringOptional

目标语言代码

limitintegerOptional

返回数量

Default: 20

1 ≤ limit ≤ 50

follower_minintegerOptional

粉丝数下限

follower_maxintegerOptional

粉丝数上限

avg_views_minintegerOptional

平均观看量下限

avg_views_maxintegerOptional

平均观看量上限

female_rate_minnumberOptional

女性受众占比下限(%)

0 ≤ female_rate_min ≤ 100

langstringOptional

响应语言

cn · en

service_levelstringOptional

服务等级

Response

successbooleanRequired

dataobjectOptional

相似达人搜索结果

Show fields

itemsarrayRequired

Show fields

uidstringRequired

达人唯一标识

usernamestringOptional

用户名

nicknamestringOptional

昵称

avatar_urlstringOptional

头像链接

profile_urlstringOptional

主页链接

country_codestringOptional

国家/地区代码

followers_countintegerOptional

粉丝数

avg_viewsintegerOptional

近 10 条视频平均播放量

engagement_ratenumberOptional

近 10 条视频平均互动率

match_scorenumberOptional

相似度评分

totalintegerRequired

errorobjectOptional

错误详情

Show fields

codeintegerRequired

业务错误码

messagestringRequired

可读错误信息

metaobjectOptional

响应元数据

Show fields

request_idstringOptional

请求唯一标识

Default: ""

pageintegerOptional

当前页码

sizeintegerOptional

每页数量

totalintegerOptional

总数

quota_remainingintegerOptional

剩余配额（-1 表示不限制）

Default: -1

service_levelstringOptional

本次请求的服务等级

langstringOptional

响应语言（cn/en），为空表示未翻译

platformstringOptional

本次请求的达人平台

recall_typestringOptional

召回类型：hybrid / vector / scalar

credits_consumedintegerOptional

本次请求扣减的积分数

Default: 0

credits_remainingintegerOptional

积分余额（-1 不限制）

Default: -1

billable_unitsintegerOptional

Server-calculated billable units for this response

Default: 0

0 ≤ billable_units ≤ ∞

skill_namestringOptional

调用方 skill 名称

skill_current_versionstringOptional

调用方 skill 当前版本

skill_latest_versionstringOptional

服务端声明的最新 skill 版本

skill_min_supported_versionstringOptional

服务端声明的最低支持版本

skill_update_availablebooleanOptional

是否存在可用 skill 更新

Default: false

skill_update_requiredbooleanOptional

是否要求更新 skill 后再继续使用

Default: false

skill_update_messagestringOptional

skill 更新提示文案

skill_update_manifest_urlstringOptional

skill 更新 manifest URL

Request example

curl -X POST 'http://api.creativault.vip/openapi/v1/creators/lookalike' \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $CV_API_KEY" \
  --data '{
  "limit": 20
}'

This example is generated from the response schema.

Response example

{
  "success": true,
  "data": {
    "items": [
      {
        "uid": "example",
        "username": null,
        "nickname": null,
        "avatar_url": null,
        "profile_url": null,
        "country_code": null,
        "followers_count": null,
        "avg_views": null,
        "engagement_rate": null,
        "match_score": null
      }
    ],
    "total": 1
  },
  "error": null,
  "meta": {
    "request_id": "",
    "page": 1,
    "size": 1,
    "total": 1,
    "quota_remaining": -1,
    "service_level": "example",
    "lang": "example",
    "platform": "example",
    "recall_type": "example",
    "credits_consumed": 0,
    "credits_remaining": -1,
    "billable_units": 0,
    "skill_name": "example",
    "skill_current_version": "example",
    "skill_latest_version": "example",
    "skill_min_supported_version": "example",
    "skill_update_available": false,
    "skill_update_required": false,
    "skill_update_message": "example",
    "skill_update_manifest_url": "example"
  }
}

View error handling →