CreatiVaultCreatiVault
DeveloperDocs.skillsDeveloperDocs.apiDeveloperDocs.downloadSchema
DeveloperDocs.navigation

DeveloperDocs.api

TikTok ad detail

Read a creative. Media URLs may expire; missing metrics are null.

POST/v1/ads/tiktok/detail
DeveloperDocs.authentication
X-API-Key
DeveloperDocs.permission
ads:tiktok:detail
DeveloperDocs.billing
DeveloperDocs.free
DeveloperDocs.limits
DeveloperDocs.configuredLimits

DeveloperDocs.parameters

DeveloperDocs.jsonBody

ad_idstringDeveloperDocs.required

DeveloperDocs.response

successbooleanDeveloperDocs.required
dataobjectDeveloperDocs.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