CreatiVaultCreatiVault
DeveloperDocs.skillsDeveloperDocs.apiDeveloperDocs.downloadSchema
DeveloperDocs.navigation

DeveloperDocs.api

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
DeveloperDocs.authentication
X-API-Key
DeveloperDocs.permission
ads:tiktok:search
DeveloperDocs.billing
DeveloperDocs.configuredBilling
DeveloperDocs.limits
DeveloperDocs.configuredLimits

DeveloperDocs.parameters

DeveloperDocs.jsonBody

pageintegerDeveloperDocs.optional

DeveloperDocs.defaultValue: 1

1 ≤ page ≤ 1000

sizeintegerDeveloperDocs.optional

DeveloperDocs.defaultValue: 20

1 ≤ size ≤ 100

country_codestringDeveloperDocs.optional

国家代码, 逗号分隔

industrystringDeveloperDocs.optional

商业, 逗号分隔

objectivestringDeveloperDocs.optional

目标, 逗号分隔

material_formatstringDeveloperDocs.optional

素材版式, 逗号分隔

budgetstringDeveloperDocs.optional

素材版式, 逗号分隔

like_gteintegerDeveloperDocs.optional

点赞数大于等于

0 ≤ like_gte ≤ ∞

like_lteintegerDeveloperDocs.optional

点赞数小于等于

0 ≤ like_lte ≤ ∞

ctr_gtenumberDeveloperDocs.optional

点击率大于等于

0 ≤ ctr_gte ≤ ∞

ctr_ltenumberDeveloperDocs.optional

点击率小于等于

0 ≤ ctr_lte ≤ ∞

keywordstringDeveloperDocs.optional

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

sort_bystringDeveloperDocs.optional

DeveloperDocs.defaultValue: "tec_update_time"

tec_update_time · like · ctr

sort_orderstringDeveloperDocs.optional

DeveloperDocs.defaultValue: "DESC"

ASC · DESC

DeveloperDocs.response

successbooleanDeveloperDocs.required
dataarrayDeveloperDocs.optional
DeveloperDocs.showFields
idstringDeveloperDocs.required
ad_titlestringDeveloperDocs.optional
urlstringDeveloperDocs.optional
coverstringDeveloperDocs.optional
country_codearrayDeveloperDocs.optional
DeveloperDocs.showFields

DeveloperDocs.schemaUnavailable

objectivesarrayDeveloperDocs.optional
DeveloperDocs.showFields

DeveloperDocs.schemaUnavailable

industry_enamestringDeveloperDocs.optional
material_format_enamestringDeveloperDocs.optional
likeintegerDeveloperDocs.optional
ctrnumberDeveloperDocs.optional

上游 CTR 指标；缺失为 null

costintegerDeveloperDocs.optional

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

brand_namestringDeveloperDocs.optional
landing_page_urlstringDeveloperDocs.optional
errorobjectDeveloperDocs.optional

错误详情

DeveloperDocs.showFields
codeintegerDeveloperDocs.required

业务错误码

messagestringDeveloperDocs.required

可读错误信息

metaobjectDeveloperDocs.optional

响应元数据

DeveloperDocs.showFields
request_idstringDeveloperDocs.optional

请求唯一标识

DeveloperDocs.defaultValue: ""

pageintegerDeveloperDocs.optional

当前页码

sizeintegerDeveloperDocs.optional

每页数量

totalintegerDeveloperDocs.optional

总数

quota_remainingintegerDeveloperDocs.optional

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

DeveloperDocs.defaultValue: -1

service_levelstringDeveloperDocs.optional

本次请求的服务等级

langstringDeveloperDocs.optional

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

platformstringDeveloperDocs.optional

本次请求的达人平台

recall_typestringDeveloperDocs.optional

召回类型：hybrid / vector / scalar

credits_consumedintegerDeveloperDocs.optional

本次请求扣减的积分数

DeveloperDocs.defaultValue: 0

credits_remainingintegerDeveloperDocs.optional

积分余额（-1 不限制）

DeveloperDocs.defaultValue: -1

billable_unitsintegerDeveloperDocs.optional

Server-calculated billable units for this response

DeveloperDocs.defaultValue: 0

0 ≤ billable_units ≤ ∞

skill_namestringDeveloperDocs.optional

调用方 skill 名称

skill_current_versionstringDeveloperDocs.optional

调用方 skill 当前版本

skill_latest_versionstringDeveloperDocs.optional

服务端声明的最新 skill 版本

skill_min_supported_versionstringDeveloperDocs.optional

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

skill_update_availablebooleanDeveloperDocs.optional

是否存在可用 skill 更新

DeveloperDocs.defaultValue: false

skill_update_requiredbooleanDeveloperDocs.optional

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

DeveloperDocs.defaultValue: false

skill_update_messagestringDeveloperDocs.optional

skill 更新提示文案

skill_update_manifest_urlstringDeveloperDocs.optional

skill 更新 manifest URL