CreatiVaultCreatiVault
SkillsOpenAPIDownload schema
Documentation navigation

OpenAPI

creators instagram search

POST/v1/creators/instagram/search
Authentication
X-API-Key
Required scope
creator:instagram:search
Billing
Pricing follows your active account rules
Rate limits
View your active rate limits

Parameters

Send this request as a JSON body.

keywordstringOptional

搜索关键词

union_user_idsarrayOptional

达人 union_user_id 列表，最多 200 条

Show fields

Schema details are unavailable for this endpoint.

profile_urlsarrayOptional

达人主页链接列表，最多 200 条

Show fields

Schema details are unavailable for this endpoint.

langstringOptional

响应语言：cn（中文）/ en（英文），默认 en

Default: "en"

cn · en

country_codestringOptional

国家代码，多选逗号分隔

genderstringOptional

性别：'男性' | '女性'

industrystringOptional

三级英文类目，逗号分隔

has_emailbooleanOptional

是否有邮箱

has_whatsappbooleanOptional

是否有WhatsApp

is_product_kolbooleanOptional

是否带货达人

is_ai_creatorbooleanOptional

是否AI达人

language_codestringOptional

语言代码筛选，多选逗号分隔，不区分大小写，如 'en,zh'

followers_cnt_gteintegerOptional

粉丝数 - 最小值

0 ≤ followers_cnt_gte ≤ 1000000000

followers_cnt_lteintegerOptional

粉丝数 - 最大值

0 ≤ followers_cnt_lte ≤ 1000000000

last10_avg_video_view_count_gtenumberOptional

近10条视频平均播放量 ≥

0 ≤ last10_avg_video_view_count_gte ≤ 1000000000

last10_avg_video_view_count_ltenumberOptional

近10条视频平均播放量 ≤

0 ≤ last10_avg_video_view_count_lte ≤ 1000000000

last10_avg_video_interaction_rate_gtenumberOptional

近10条视频平均互动率 ≥

0 ≤ last10_avg_video_interaction_rate_gte ≤ 100

last10_avg_video_interaction_rate_ltenumberOptional

近10条视频平均互动率 ≤

0 ≤ last10_avg_video_interaction_rate_lte ≤ 100

last_video_publish_time_gtestringOptional

最近视频发布时间起始

last_video_publish_time_ltestringOptional

最近视频发布时间截止

audience_country_code_liststringOptional

受众国家代码(多选逗号分隔)

audience_language_liststringOptional

受众语言(多选逗号分隔)

audience_age_liststringOptional

受众年龄(多选逗号分隔)

female_ratio_gtenumberOptional

受众女性占比 ≥

0 ≤ female_ratio_gte ≤ 100

female_ratio_ltenumberOptional

受众女性占比 ≤

0 ≤ female_ratio_lte ≤ 100

sort_fieldstringOptional

排序字段

sort_orderstringOptional

排序方式

Default: "desc"

asc · desc

pageintegerOptional

页码

Default: 1

1 ≤ page ≤ 200

sizeintegerOptional

每页数量

Default: 50

1 ≤ size ≤ 100

service_levelstringOptional

服务等级：S1 / S2 / S3，默认 S1

crm_filterobjectOptional

私域达人过滤配置

Show fields
enabledbooleanOptional

Default: false

modestringOptional

Default: "exclude"

exclude · include

exclude_cooperatedbooleanOptional

Default: false

exclude_blockedbooleanOptional

Default: false

require_collectedbooleanOptional

Default: true

group_idsarrayOptional
Show fields

Schema details are unavailable for this endpoint.

tagsarrayOptional
Show fields

Schema details are unavailable for this endpoint.

cooperation_statusesarrayOptional
Show fields

Schema details are unavailable for this endpoint.

is_recommendedbooleanOptional
is_focusedbooleanOptional

Response

Schema details are unavailable for this endpoint.