文档导航

OpenAPI

TikTok 素材详情

获取单条素材的公开信息。媒体链接可能失效;缺失指标返回 null。

POST/v1/ads/tiktok/detail
认证方式
X-API-Key
所需 scope
ads:tiktok:detail
计费
免费
限流
查看当前限流规则

请求参数

该请求使用 JSON 请求体提交。

ad_idstring必填

响应

successboolean必填
dataobject可选
展开字段
idstring必填
ad_titlestring可选
urlstring可选
coverstring可选
country_codearray可选
展开字段

该接口暂不提供 Schema 详情。

objectivesarray可选
展开字段

该接口暂不提供 Schema 详情。

industry_enamestring可选
material_format_enamestring可选
likeinteger可选
ctrnumber可选

上游 CTR 指标;缺失为 null

costinteger可选

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

brand_namestring可选
landing_page_urlstring可选
errorobject可选

错误详情

展开字段
codeinteger必填

业务错误码

messagestring必填

可读错误信息

metaobject可选

响应元数据

展开字段
request_idstring可选

请求唯一标识

默认值: ""

pageinteger可选

当前页码

sizeinteger可选

每页数量

totalinteger可选

总数

quota_remaininginteger可选

剩余配额(-1 表示不限制)

默认值: -1

service_levelstring可选

本次请求的服务等级

langstring可选

响应语言(cn/en),为空表示未翻译

platformstring可选

本次请求的达人平台

recall_typestring可选

召回类型:hybrid / vector / scalar

credits_consumedinteger可选

本次请求扣减的积分数

默认值: 0

credits_remaininginteger可选

积分余额(-1 不限制)

默认值: -1

billable_unitsinteger可选

Server-calculated billable units for this response

默认值: 0

0 ≤ billable_units ≤ ∞

skill_namestring可选

调用方 skill 名称

skill_current_versionstring可选

调用方 skill 当前版本

skill_latest_versionstring可选

服务端声明的最新 skill 版本

skill_min_supported_versionstring可选

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

skill_update_availableboolean可选

是否存在可用 skill 更新

默认值: false

skill_update_requiredboolean可选

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

默认值: false

skill_update_messagestring可选

skill 更新提示文案

skill_update_manifest_urlstring可选

skill 更新 manifest URL