CreatiVaultCreatiVault
SkillsOpenAPIDownload schema
Documentation navigation

OpenAPI

TikTok ad search

Filter and paginate TikTok Creative Center creatives. Budget tiers are not actual spend; missing metrics are null.

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

Parameters

Send this request as a JSON body.

pageintegerOptional

Default: 1

1 ≤ page ≤ 1000

sizeintegerOptional

Default: 20

1 ≤ size ≤ 100

country_codestringOptional

国家代码, 逗号分隔

industrystringOptional

商业, 逗号分隔

objectivestringOptional

目标, 逗号分隔

material_formatstringOptional

素材版式, 逗号分隔

budgetstringOptional

素材版式, 逗号分隔

like_gteintegerOptional

点赞数大于等于

0 ≤ like_gte ≤ ∞

like_lteintegerOptional

点赞数小于等于

0 ≤ like_lte ≤ ∞

ctr_gtenumberOptional

点击率大于等于

0 ≤ ctr_gte ≤ ∞

ctr_ltenumberOptional

点击率小于等于

0 ≤ ctr_lte ≤ ∞

keywordstringOptional

关键词搜索（模糊匹配 keyword_list）

sort_bystringOptional

Default: "tec_update_time"

tec_update_time · like · ctr

sort_orderstringOptional

Default: "DESC"

ASC · DESC

Response

successbooleanRequired
dataarrayOptional
Show fields
idstringRequired
ad_titlestringOptional
urlstringOptional
coverstringOptional
country_codearrayOptional
Show fields

Schema details are unavailable for this endpoint.

objectivesarrayOptional
Show fields

Schema details are unavailable for this endpoint.

industry_enamestringOptional
material_format_enamestringOptional
likeintegerOptional
ctrnumberOptional

上游 CTR 指标；缺失为 null

costintegerOptional

预算等级，不代表实际金额

brand_namestringOptional
landing_page_urlstringOptional
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