协议管理
在使用某些功能，例如线索广告前，需要签订协议表明已知晓使用需要遵守的规则。协议管理API使您能够签订协议，检查是否已签订某项功能的协议，以及获取某项功能已签订的协议。 本组包含以下接口： 查看协议 签订协议 检查协议状态
完整资料目录
共 1986 份资料 · 第 7 / 20 页
查看协议
您可以使用本接口查看协议内容。您需要使用 term_type 字段指定希望查看的协议类型，目前仅支持查看线索广告协议。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/term/get/ /v1.3/term/get/ 请求参数类型 advertiser_id : number
签订协议
您可以使用本接口签订协议，目前仅支持签订线索广告的协议。 签订完成后，您可以使用 /term/check/ 查看协议状态。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/term/confirm/ /v1.3/term/confirm/ 请求参数类型 advertiser_id
检查协议状态
您可以使用本接口检查协议的签订情况，确认签订完成后才可进行协议相关内容的操作。 若协议已签订完成，您可以通过 /term/get/ 获取协议。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/term/check/ /v1.3/term/check/ 请求参数类型 adverti
账号 API
通过账号 API，你可以以编程方式管理企业号和个人账号的活动并获取报表数据，从而获取深度洞察和规模化的控制。 注意 为了确保账号 API 的合规使用，自 2026 年 3 月 20 日 00:00 (GMT+0) 起，开发者在提交新的开发者应用或申请新增包含“TikTok Accounts”权限范围的权限前，必须填写 账号 API 访问申请表 。请务必仔细遵
创意工具 · API Reference
创意工具提供了各种简单常用的创意资产（包括图片、视频和广告）的预览、生成和优化功能。请查看 创意工具 了解目前支持的功能。 本组以下接口： 图片裁剪 广告或创意素材预览 分享创意资产 删除创意资产 获取推荐智能文案 智能推荐行动引导文案 创建智能修复任务 获取智能修复任务结果 获取创意疲劳检测结果
概览 · Marketing API / Campaign Management
本概览介绍了TikTok For Business广告层级的结构和重要概念。 您可以使用推广系列管理API，提升广告表现，提高运营效率和管理规模，最终实现您的业务目标。
推广目标
推广目标是指推广行为背后希望达成的业务目标，以及希望用户在看到您的广告时采取的操作。例如，您可以通过创建广告，吸引用户访问网站或下载应用。在上述例子中，您可以将推广目标分别设为 TRAFFIC 和 APP_PROMOTION 。 您需要在推广系列层级设置推广目标。 注意 推广目标在设置后不可修改。 TikTok API for Business支持以下推广目
不同币种的预算校验比例和取值范围
本文列出了不同币种的预算校验比例及精度，并提供两个数据列表，供您查询推广系列层级和广告组层级各个币种对应的每日预算的取值范围。欲了解预算详情及如何设置预算，请查看 预算 。 不同币种的预算校验比例及精度 请查看下表，了解不同币种允许的预算校验比例及精度。预算校验比例可用于计算广告组层级和推广系列层级的预算金额取值范围。您可以查看 预算-预算设置指南 了解预算
地区代码
名称 代码 安道尔 AD 阿联酋 AE 阿富汗 AF 安提瓜和巴布达 AG 安圭拉 AI 阿尔巴尼亚 AL 亚美尼亚 AM 安哥拉 AO 南极洲 AQ 阿根廷 AR 美属萨摩亚 AS 奥地利 AT 澳大利亚 AU 阿鲁巴 AW 奥兰 AX 阿塞拜疆 AZ 波黑 BA 巴巴多斯 BB 孟加拉国 BD 比利时 BE 布基纳法索 BF 保加利亚 BG 巴林 BH
时区信息
下表列出了可用的时区代码和对应的时区。若想获取时区代码的完整列表，可使用 /tool/timezone/ 。 时区代码可用于以下 API 操作中： 自动规则 使用 /optimizer/rule/create/ 、 /optimizer/rule/update/ 或 /optimizer/rule/list/ 创建、更新或获取自动规则时，将时区代码传给请求参
视频素材
视频是可用于创建广告的创意素材。您还可以在创意工具如 智能微电影 ， 智能配乐 ， 一键优化 ，和 视频智能修复 中使用视频ID。此外，视频还可用于 /catalog/video_package/create/ 创建的视频包中，您需要通过 video_id 指定视频。 本组包含以下接口： 上传视频 更新视频名称 获取视频信息 搜索视频 获取视频智能封面
上传视频
您可以使用本接口上传视频到素材库，获得的视频ID可以直接进行广告投放，也可以用于新的素材的制作和生成。 文件上传接口超时时间为 10 秒，传输速度由网络带宽决定。请控制上传文件大小。 如果您上传在广告账户下已存在的视频，接口将会返回已存在视频的信息。 注意 我们推荐您在上传视频时开启智能修复。智能修复 API 可以自动检测并修复您视频存在的问题，使其符合投放
创建手动推广系列
本文介绍了如何创建一个推广系列。 使用 /campaign/create/ 创建一个常规的推广系列。您可以在推广系列层级进行以下设置。 若想了解 TikTok 广告管理平台上推广系列层级的功能对应的 API 参数，请查看 TikTok 广告管理平台的推广系列功能与 API 配置间的映射 。 advertiser_id ：广告主 ID。您可以从您的 TikTo
页面管理
即时体验页面是一种加载快速的轻量级网页，在 TikTok 上的加载速度比标准网页快 11 倍。页面 API 可以使您检索广告账户中的页面，并创建、验证或刷新 TikTok 即时体验页面编辑器 SDK 的访问令牌。 若想了解不同类型的即时体验页面的详情，请查看 即时体验页面 。若想了解如何使用 TikTok 即时体验页面编辑器 SDK，请查看 即时体验页面编辑
文件上传
您可以将视频、图片和音乐上传到TikTok文件库，文件库中的文件会保留24小时，逾期文件将过期，无法使用到广告中。对于大于20MB的文件，您可以分片依次上传至文件库。文件库中的文件可转移到素材库，从而在广告中使用。 请查看 上传视频、图片和音乐-上传视频、图片和音乐文件 ，了解将单个文件或多个分片文件上传至文件库的步骤。 本组包含以下接口： 上传单个文件 请
上传单个文件
您可以使用本接口上传文件到文件库，文件上传的传输速度由网络宽带决定。请控制上传文件大小，单个文件不超过100MB。 上传完成后会返回 file_id 。后续您可以通过 file_id 获取文件库中的文件，将其上传到TikTok素材库。 注意 文件库只会保存您的文件24个小时，逾期文件将会过期。若您想在广告中使用的文件已过期，您需重新将文件上传至文件库。 v1
请求分片上传
您可以使用本接口创建分片上传任务，请求分片上传。 任务创建后，需使用 /file/transfer/upload/ 依次上传分片文件。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/file/start/upload/ /v1.3/file/start/upload/ 请求参数
进行分片上传
您可以使用本接口将处理好的文件块上传。在此之前，您需要使用 /file/start/upload 接口返回的 start_offset 和 end_offset 将文件进行分片。 当从本接口返回的 start_offset 和 end_offset 相等的时候，意味着最后一个分片已经上传完毕。随后您需调用 /file/finish/upload/ 完成分片上
完成分片上传
您可以使用本接口完成分片上传任务。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/file/finish/upload/ /v1.3/file/finish/upload/ 请求参数类型 advertiser_id : number advertiser_id : string
试玩广告
试玩广告是一种互动广告样式，通过提供简短而精彩的体验吸引用户下载应用或游戏。通过试玩广告，用户可以先体验应用或游戏，然后再决定是否下载。该广告样式以游戏化的方式呈现广告，让每一次展示都取得最大成效，从而有效地优化千次展示成本 (CPM)。 如需了解试玩广告的益处及其最佳设计实践，参见 试玩广告 。 如需了解如何上传用于创建广告的试玩素材，参见 上传试玩素材
上传试玩素材 · API Reference / Playable Ads
此接口可用于上传试玩素材。 v1.2 与 v1.3 接口对比 下表概述了 v1.2 接口与 v1.3 接口之间的差异。 变更 v1.2 v1.3 接口路径 /v1.2/playable/upload/ /v1.3/playable/upload/ 请求参数类型 advertiser_id : number advertiser_id : string 返回参
查看试玩素材状态
此接口用于查看已上传试玩素材的验证和审核状态。 v1.2 与 v1.3 接口对比 下表概述了 v1.2 接口与 v1.3 接口之间的差异。 变更 v1.2 v1.3 接口路径 /v1.2/playable/validate/ /v1.3/playable/validate/ 请求参数类型 advertiser_id : number playable_id
保存试玩素材
此接口可用于保存试玩素材。 v1.2 与 v1.3 接口对比 下表概述了 v1.2 接口与 v1.3 接口之间的差异。 变更 v1.2 v1.3 接口路径 /v1.2/playable/save/ /v1.3/playable/save/ 请求参数类型 advertiser_id : number playable_id : number advertise
获取试玩素材
此接口可用于获取试玩素材列表。 v1.2 与 v1.3 接口对比 下表概述了 v1.2 接口与 v1.3 接口之间的差异。 变更 v1.2 v1.3 接口路径 /v1.2/playable/get/ /v1.3/playable/get/ 请求参数类型 advertiser_id : number playable_id : number advertise
删除试玩素材
此接口可用于删除试玩素材。 只能删除已保存的试玩素材。你可以使用 /playable/save/ 接口保存试玩素材。 v1.2 与 v1.3 接口对比 下表概述了 v1.2 接口与 v1.3 接口之间的差异。 变更 v1.2 v1.3 接口路径 /v1.2/playable/delete/ /v1.3/playable/delete/ 请求参数类型 adve
概览 · Organic API / Accounts API
企业号是专供 TikTok 上商家使用的特殊 TikTok 账户类型。企业号提供一系列拓展功能，用以满足商家的推广和商业需求。若您想了解详细信息，请参考 TikTok 商务帮助中心的 关于 TikTok 企业账户 。 个人账号则是供 TikTok 上普通用户使用的 TikTok 账号类型。欲了解个人账号的详情，可查看 Personal and Busines
账号
企业号是一种独特的 TikTok 账号类型，专供 TikTok 上的企业使用。它提供了一系列功能，可满足商家的推广和商业需求。个人账号是一种面向 TikTok 普通用户的 TikTok 账号。 你可以查看 用户指南 ，详细了解授权和获取访问令牌的流程以及账号 API 的频控限制。 本组包含以下接口： 访问令牌检查工具 通过访问令牌获取授权的 TikTok 账
授权 · Organic API / Accounts API / Guides / Get started
使用账号 API 前，开发者需要从商家获取管理商家账户的授权。 前提 已创建 TikTok For Business 账号。欲了解更多详情，请查看 创建 TikTok For Business 账号 。 已注册成为开发者。欲了解更多详情，请查看 注册成为开发者 。 已创建开发者应用，应用的权限范围需包含“TikTok Accounts”下账号 API 接口的
获取访问令牌 · Organic API / Accounts API / Guides / Get started
TikTok 账号用户授权后，您会收到的授权码，您可向以下接口发送请求，获取后续申请访问接口所需的 TikTok 账号访问令牌以及用于刷新访问令牌的 TikTok 账号刷新令牌。 欲获取 TikTok 账号用户授予的 TikTok 账号权限范围信息，可将生成的访问令牌传入 /tt_user/token_info/get/ 接口进行查询。 访问令牌到期 Tik
频控规则 · Organic API / Accounts API / Guides / Get started
每个已授权 TikTok 账户和 API 接口的分钟级调用限制（QPM）为 40。此外，还存在一个单独的、适用于所有账号 API 接口的合计频控限制，该限制受分配给您的开发者应用的全局频控限制等级影响。以下表格概述了单个开发者应用基于全局频控等级的账号 API 接口合计频次限制。 全局频控限制等级 所有账号 API 接口的 QPM 初级 600 标准级 1,
广告评论
已和TikTok企业号绑定的用户发布的的普通视频广告以及Spark Ads，若已开启评论，则可使用评论管理API管理广告下的评论。您可以获取、回复、删除、导出评论或更新评论状态。 您还可以定义和管理屏蔽词。当评论中出现屏蔽词时，该评论会被自动隐藏，变为只对创建评论的用户可见。屏蔽词管理的相关接口可见 广告评论 - 屏蔽词管理 。 本组包含以下接口： 获取评论
获取评论列表
您可以使用本接口获取广告账户所发视频广告下的评论。 您需设置搜索值及想要获取评论的时间区间。本接口可返回导流广告以及Spark Ads的评论。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/comment/list/ /v1.3/comment/list/ 请求参数类型 adv
获取关联评论
您可以使用本接口获取关联评论。 若评论类型为 COMMENT ，返回该评论及其所有回复。若评论类型为 REPLY ，返回该回复及原评论。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/comment/reference/ /v1.3/comment/reference/ 请求参
更新评论状态
您可以使用本接口将一个或一组评论设为隐藏或可见。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/comment/status/update/ /v1.3/comment/status/update/ 请求参数类型 advertiser_id : number comment_i
创建评论导出任务
您可以使用本接口创建评论导出任务。 评论导出任务创建后，您可以使用 /comment/task/check/ 查询任务状态。等任务完成后，您可以调用 /comment/task/download/ 下载导出的评论。 评论会到导出到一个表格里。包含以下几列数据：评论内容、点赞数、回复数、评论类型、评论时间、所属推广系列名称、所属广告组名称、所属广告名称。如果评
获取评论导出任务状态
您可以使用本接口查询评论导出任务的状态。 任务完成后，您可以调用 /comment/task/download/ 下载导出的评论。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/comment/task/check/ /v1.3/comment/task/check/ 请求参数
下载导出的评论
您可以使用本接口在下载任务完成后下载导出的评论。 下载的评论文件格式是CSV。评论会到导出到一个表格里。包含以下几列数据：评论内容、点赞数、回复数、评论类型、评论时间、所属推广系列名称、所属广告组名称、所属广告名称。如果评论提及另一个用户名，则这部分内容会被处理成 “@user_name”。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口
覆盖和频次广告 · API Reference
覆盖和频次广告是TikTok For Business为广告客户提供的新型解决方案，可以实现可预测的覆盖人数、可控的覆盖频率并确保投放量，以及提供更加灵活和透明的广告体验。欲了解覆盖和频次广告的详情以及如何创建覆盖和频次推广系列，请查看 这里 。 注意 覆盖和频次广告目前已全量，开发者均可以使用本功能进行开发。但是广告账号需要在本功能的白名单内，相关的应用才
创建覆盖和频次广告组
此接口可用于创建覆盖和频次广告组。 如需查看详细说明，参见 创建覆盖和频次推广系列 。 v1.2 与 v1.3 接口对比 下表概述了 v1.2 接口与 v1.3 接口之间的差异。 变更 v1.2 v1.3 接口路径 /v1.2/adgroup/rf/create/ /v1.3/adgroup/rf/create/ 请求参数名称 external_type e
更新覆盖和频次广告组
此接口可用于更新覆盖和频次广告组。 v1.2 与 v1.3 接口对比 下表概述了 v1.2 接口与 v1.3 接口之间的差异。 变更 v1.2 v1.3 接口路径 /v1.2/adgroup/rf/update/ /v1.3/adgroup/rf/update/ 请求参数名称 age operation_system connection_type devi
获取覆盖和频次广告库存预估
您可以使用本接口获取覆盖和频次广告的库存预估。参考 这里 了解更多库存预估的细节，及该接口返回结果与TikTok广告管理平台预测结果的匹配关系。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/adgroup/rf/inventory/estimate/ /v1.3/rf/inv
获取操作系统列表
您可以使用本接口获取受众操作系统版本枚举值列表。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/tools/os_version/ /v1.3/tool/os_version/ 请求参数类型 advertiser_id : number advertiser_id : stri
OAuth 授权
使用 Marketing API 前，您（即开发者）需要从广告主获取管理他们账户的授权。 前提条件 已创建 TikTok For Business 账号。欲了解更多详情，请查看 创建TikTok For Business账号 。 已注册成为开发者。欲了解更多详情，请查看 注册成为开发者 。 已创建开发者应用。欲了解更多详情，请查看 创建开发者应用 。 步骤
获取访问令牌 · Marketing API / Get started
广告主 授权 后，您会收到的授权码（ auth_code ），您可向以下接口发送请求，获取后续申请访问接口所需的访问令牌（ access_token ）。 生成访问令牌 若您想获取长期访问令牌时将 Content-Type 设置为 application/json ，您可以向 /oauth2/access_token/ 接口发送POST请求。需要在请求中传入
使用经授权的帖子创建 Spark Ads
本章节介绍了使用经授权的帖子创建或更新 Spark Ads 的接口。除了通过经授权的帖子，您还可以使用以下方法创建 Spark Ads。 点击 此处 了解用其他方法创建 Spark Ads 的不同步骤。 通过将视频广告推送至关联的企业号创建 通过从关联的企业号提取帖子创建 通过从商务中心中其他创作者授权的账户提取帖子创建 本组包含以下接口： 获取 Spark
获取 Spark Ads 帖子信息
您可以使用本接口通过从帖子所有者处获得的授权码，查询有权发布为广告的 Spark Ads 帖子（视频）信息。 使用前需知 确保已从创作者（TikTok 帖子所有者）那里获得授权码。 你可以通过以下步骤，请创作者生成授权码： 打开 TikTok 应用，点击想分享的帖子上的三点状图标。 在分享菜单中点击**“广告设置”**。 开启**“广告授权”**。 选择授权
应用授权码
您可以使用本接口应用授权码。从视频主获得授权码后，授权并不会立即生效。您需要使用授权码将广告账户与Spark Ads帖子相连接。 对于拼接或者合拍帖子或者源视频提及了其他视频，广告主在推广帖子前还需要获得源视频的授权。在本接口中，你需要使用 auth_code 来传入当前视频的授权码，并用 original_post_auth_code 来传入源视频的授权码
获取 Spark Ads 帖子列表
您可以使用本接口获取已授权给某一广告账户的 Spark Ads 帖子列表。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/tt_video/list/ /v1.3/tt_video/list/ 请求参数类型 advertiser_id : number advertiser_i
解除 Spark Ads 帖子绑定
若 Spark Ads 帖子的授权已过期或已取消，您可以使用本接口对帖子进行解绑。解绑 Spark Ads 帖子意味着该帖子从广告账户的已授权 Spark Ads 帖子列表中移除。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/tt_video/unbind/ /v1.3/tt
广告账号
广告账号是TikTok Ads 的基础账号，每个用户在创建和管理广告前，必须拥有广告账号，或者已获得广告主授予的管理广告账号权限。 本组包含以下接口： 获取广告账号列表 获取广告账号信息
获取广告账号列表
您可以使用本接口获取授予某一开发者应用权限的广告账号列表。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/oauth2/advertiser/get/ /v1.3/oauth2/advertiser/get/ 请求参数类型 app_id : number app_id : st
获取时区列表
您可以使用本接口来查询时区列表，返回的列表中包含了每个时区对于GMT的偏移。 需注意返回的偏移（ gmt_offset ）为固定值，不随夏令时或冬令时变化。例如，纽约（ America/New_York ）对应的偏移固定返回 GMT-05:00 ，无论纽约当前是否使用夏令时。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内
获取品牌安全合作伙伴授权状态
您可以使用本接口获取品牌安全合作伙伴的授权状态。 目前只支持Zefr一家合作伙伴。 在使用Zefr的服务前，需要前往 https://measurement.zefr.com/tiktok/connect 完成设置。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/tools/b
获取 TikTok 应用内链接
您可以使用本接口获取 TikTok 公开网址的对应应用内链接。获取的地址可以用于创建覆盖和频次广告中，需要将地址传入广告的 deeplink 字段。 注意 应用内链接目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1
商务中心-账单组
商务中心是面向各类规模组织和机构的一站式业务中心。通过商务中心，各组织和机构可以在 TikTok 上合作开展营销活动，让宣传内容覆盖目标受众。账单组是一组共享相同发票和付款方式的广告账户。您可以使用商务中心-账单组API管理商务中心下的账单组。 本组包含以下接口： 创建账单组 修改账单组 获取账单组列表 获取账单组广告账户列表
获取账单组广告账户列表
您可以使用本接口获取一个账单组绑定的广告账户列表。 代理商商务中心和直客商务中心都能执行账单组相关操作。 注意 只有拥有财务经理或财务分析师权限的用户才能在商务中心执行资金管理和发票的相关操作。您可以使用 /bc/member/invite/ 和 /bc/member/update/ 设置或更改成员权限。 v1.2与v1.3版本对比 以下表格概括了 v1.2
广告诊断
广告诊断功能能够分析您的广告组，诊断存在问题，并提供建议。广告诊断 API 使您能够获取广告组的诊断结果，并给出有关素材、出价、预算和事件追踪有关的诊断建议。 本组包含以下接口： 获取广告组诊断
获取广告组诊断
您可以使用本接口获取对于活跃广告组的诊断，包括存在的问题以及改进或提升的建议。 无对应建议的广告组将不会返回。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/tools/diagnosis/get/ /v1.3/tool/diagnosis/get/ 请求参数类型 advert
自动规则
通过自动规则，您可以新建基于规则的任务在 TikTok 广告管理平台上自动检查和管理推广系列、广告组和广告。如果您想了解如何使用TikTok广告管理平台上的自动规则，请参考以下文章。 自动规则简介 如何创建并应用自动规则 自动规则条件 本组包含以下接口： 创建规则 根据ID获取规则 根据条件获取规则 获取规则结果 获取结果详情 更新规则 更改规则状态 规则绑
创建规则
您可以使用本接口创建自动规则。 重要提示 目前，该接口仅支持直客广告主。自动规则通知会直接路由至开发者注册的邮箱地址。因此，管理多个广告主的 SaaS 平台及技术公司无法使用此接口，因为系统无法将通知分别路由至其管理的各个广告主。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/
根据ID获取规则
您可以使用本接口根据ID获取规则。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/optimizer/rule/get/ /v1.3/optimizer/rule/get/ 请求参数类型 advertiser_id : number rule_ids : number[] ad
根据条件获取规则
您可以使用本接口根据条件获取规则。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/optimizer/rule/list/ /v1.3/optimizer/rule/list/ 请求参数类型 advertiser_id : number advertiser_id : stri
获取规则结果
您可以使用本接口获取规则结果。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/optimizer/rule/result/list/ /v1.3/optimizer/rule/result/list/ 请求参数类型 advertiser_id : number advertis
获取结果详情
您可以使用本接口获取结果详情。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/optimizer/rule/result/get/ /v1.3/optimizer/rule/result/get/ 请求参数类型 advertiser_id : number exec_id :
更新规则
您可以使用本接口更新规则。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/app/track/ /v1.3/app/track/ 请求参数类型 advertiser_id : number dimensions_id : number[] rule_id : number ad
更新规则状态
您可以使用本接口开启、关闭以及删除一组规则。更新过程中任何一条规则更新失败，整个更新操作会失败，所有规则都不会更新。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/optimizer/rule/update/status/ /v1.3/optimizer/rule/update
规则绑定/解绑
您可以使用本接口将规则与多个对象绑定，或将之前绑定的规则与对象解除绑定。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/optimizer/rule/batch_bind/ /v1.3/optimizer/rule/batch_bind/ 请求参数类型 advertiser_i
更改日志
更改日志能够显示您的广告账户、推广系列、广告组以及广告的改动记录，有利于代理商和企业监测团队成员所做的改动。您可以通过更改日志API获取特定广告账户和广告实体（推广系列，广告组以及广告）的更改记录，也可使用更改日志数据进行故障排除。您可以在返回中查看更改时间、所更改的对象、更改细节、以及进行更改的操作者。 欲获取更改日志文件，您需先通过 /changelog
创建更改日志下载任务
您可以使用本接口根据您传入的参数创建更改日志下载任务。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/activities/task/create/ /v1.3/changelog/task/create/ 请求参数名称 opt_types order_field operat
创意素材表现数据 · API Reference / Creative Reports
您可以使用本组接口获取获取广告表现与行业基准值的对比数据，以及秒级表现数据。 本组包含以下接口： 获取广告表现对比数据 获取秒级表现数据
获取广告表现对比数据
您可以使用本接口获取广告表现与行业基准值的对比数据。 注意 通过本接口返回的所有数据都有30~48小时的延迟。 使用前需知 请确保您要与行业基准值对比的广告在对比的时间窗口期内均已累积了至少1,000次展示。若广告在对比的时间窗口期内已累积的展示次数少于1,000，将返回空结果。若想检查广告在某个时间区间内的展示数，可调用 /report/integrate
获取秒级表现数据
您可以使用本接口获取广告的秒级表现数据，或视频素材的视频洞察数据。 欲了解视频洞察数据的用途，请查看 创意素材表现数据-视频洞察数据 。 注意 通常一只广告视频的长度不超过60秒，并且60秒内的视频效果最佳，因此我们只提供视频前60秒的数据。如果视频长度超过60秒，此时视频一般为Pangle版位投放的视频，所有60秒之后的数据会被归因（累计）到第60秒。 通
创建 TikTok for Business 账号
在使用 TikTok API for Business 或 TikTok for Business MCP 服务器之前，您需要在 TikTok for Business Developers 门户网站完成注册。要创建 TikTok for Business 账号，请完成以下步骤。 步骤 导航至 TikTok for Business Developers 首
注册成为开发者
在创建应用和开始开发之前，您需要注册成为开发者。要注册成为开发者，请完成以下步骤。 步骤 登录 TikTok for Business Developers 后，单击 成为开发者 。 填写您的姓名和联系邮箱。我们建议您设置如下的邮箱格式 developers+tiktok@company.com ，并与团队中所有的开发人员共享登录凭证，确保每个人都能访问开发
创建开发者应用
在进行开发和集成之前，您需要创建一个开发者应用。要创建一个开发者应用，请完成以下步骤。 注意 在申请开发者应用前，确保您的开发者个人资料已经通过审核。否则，将会出现错误。点击 此处 获取更多关于开发者注册的信息。 步骤 登录 TikTok For Business Developers 平台，点击 创建应用 。 在创建应用的页面中，填写您的应用名称，请使用描
应用权限范围
请参阅 API参考 ，获取API接口完整列表及对应的权限。 更新应用权限范围 如果需要更新开发者应用权限范围，您无需创建一个新的开发者应用或提交工单。您可以自主更新权限范围。 请执行以下步骤： 登录后，单击 应用管理 ，然后单击要更新的开发者应用名称。 选择后，单击 权限范围 。 在出现的页面中，单击编辑图标并选择要申请的新权限。 请用 英文 填写更新权限的
沙箱账户
通过使用 TikTok API for Business 沙箱账户，您可以轻松地进行调试，而不会影响您真实的TikTok广告账户。 注意 如果您在2020年11月4日之前创建了一个沙箱账户，您必须再创建一个新的沙箱账户，因为旧的广告主ID和访问令牌不再有效。 拥有 TikTok 沙箱账户的开发人员具有以下能力： 在沙箱环境中使用大部分 TikTok API
创建广告组 · Marketing API / Campaign Management / Guides / Ad group
本文介绍了如何创建一个广告组。 使用 /adgroup/create/ 创建一个广告组。您可以在广告组层级进行下列设置。 若想了解 TikTok 广告管理平台上广告组层级的功能对应的 API 参数，请查看 TikTok 广告管理平台的推广系列功能与 API 配置间的映射 。 常规信息 advertiser_id ：广告主 ID。 campaign_id ：推
商务中心
您可以使用商务中心API高效管理多个TikTok广告账户、用户、资产和财务。您还可以使用报表API生成 商务中心报表 。 了解商务中心的概念、优势和类型，请参阅 概览 。 了解商务中心成员、合作伙伴、资产管理、资金管理设置和商务中心报表的常见使用案例，请参阅 用户指南 。 商务中心创建 ：创建 TikTok 商务中心将使您能够在安全集中的环境中管理多个用户的
报表管理 · Marketing API
您可以使用报表管理 API，以同步或异步模式为您的竞价广告与合约广告生成报表。 了解报表管理 API 的基本概念，请参阅 概览 。 了解同步报表和异步报表，以及不同的报表类型，请参阅 用户指南 。 同步报表和异步报表 ：介绍如何生成同步报表和异步报表。 报表类型 ：介绍基础报表、受众分析报表、试玩素材报表、DSA报表、商务中心报表和最大成交额广告报表的 使用
生成同步报表
您可以通过生成同步报表，获取实时数据。 步骤 使用 /report/integrated/get/ 并进行以下设置： 对于基础报表，受众分析报表，试玩素材报表或 DSA 报表 若您要使用 /report/integrated/get/ 创建一个基础报表，受众分析报表，试玩素材报表或 DSA 报表： 广告主 ID ：使用 advertiser_id 或 adv
生成异步报表
您可以生成异步报表，异步报表能够获取的数据没有时间限制。 注意 异步报表目前为白名单功能。如需使用此功能，请通过 白名单功能管理 申请。 步骤 请执行以下步骤以获得异步报表： 使用 /report/task/create/ 接口 创建一个异步报表任务。您需要传入以下字段： 广告主ID ：使用 advertiser_id 字段指定广告主ID。这是一个必填字段。
减少同步报表超时错误的最佳实践
由于吞吐量的限制，使用同步模式获取大量数据可能导致请求超时。为减少或避免请求超时，我们建议您遵循以下最佳实践。 使用筛选条件分小批次获取数据 使用 campaign_ids , adgroup_ids , ad_ids 作为筛选条件（ filtering ），分批获取数据。每次请求最多可以传入 100 个 ID（注意：如果是推广系列 ID，则最多可以传入 3
报表类型
根据您希望生成报表的数据类型，我们提供以下 6 种报表类型：基础报表、受众分析报表、试玩素材报表、DSA 报表、商务中心报表和最大成交额广告报表。 以下表格提供了这些报告类型的概述，以及它们与竞价广告和合约广告的兼容情况。 报表类型 描述 支持竞价广告 支持合约广告 基础报表 使用该报表类型获取四个层级的广告消耗和表现数据：推广系列、广告组、广告、 广告账户
常见问题 · Marketing API / Reporting / Guides
本文总结了使用报表管理API时的常见问题。 数据不一致 Q1: 我注意到 API 报表和 TikTok 广告管理平台的报表之间存在数据不一致，为什么会出现这种情况？ 数据不一致可能有几大原因。在寻求帮助之前，请检查以下可能性： 不同的报表类型和维度：API报表类型与TikTok广告管理平台上的类型不同。例如，API 报表类型为基础报表，而 TikTok 广告
报表数据延迟
在通过报表 API 创建报表时需注意，报表中某些数据字段可能存在数据延迟。数据延迟的时间取决于报表基于的数据类型和具体字段。 两种数据源 数据延迟源于 TikTok 广告管理平台上的两种数据类型（实时数据和离线数据）及对应的刷新机制。 实时数据刷新频繁，请求数据后需等待时间短。实时数据第二天会通过离线数据进行微调，从而保证数据的准确性。 离线数据与实时数据相
基础报表
基础报表是一种报表类型，您可以通过此类报表获取最全面的广告数据，包括广告消耗和表现数据、视频播放数据、互动数据，以及应用内事件和网页事件数据。 支持的维度 获取基础报表支持的维度，请参阅 此处 。 支持的指标 获取基础报表支持的指标，请参阅 此处 。 支持的筛选条件 获取基础报表支持的筛选条件，请参阅 此处 。 支持的Lifetime指标 基础报表在广告主层
受众分析报表
受众分析报表是一种报表类型，您可以通过此类报表获取受众数据，包括年龄、性别、地区或兴趣分类。 注意 受众分析报表中的数据不是实时数据。有10-12小时的数据处理延迟。 不支持使用CHUNK模式 （ query_mode = CHUNK ）生成受众分析报表。CHUNK模式仅支持同步基础报表。 我们已优化了通过 /report/integrated/get/ （
试玩素材报表
试玩素材报表是一种报表类型，您可以通过此类报表获取获取试玩广告的数据。 注意 试玩素材报表返回试玩素材的投放数据。请求此类报表时，您无需指定 data_level 。 不支持使用CHUNK模式 （ query_mode = CHUNK ）生成试玩素材报表。CHUNK模式仅支持同步基础报表。 支持的维度 获取试玩素材报表支持的维度，请参阅 此处 。 支持的指标
DSA 报表
DSA 报表是一种报表类型，您可以通过此类报表获取 商品来源为商品库的视频购物广告 或 Dynamic Showcase Ads（动态产品广告）的数据。 注意 为商品来源为商品库的视频购物广告请求异步 DSA 报表目前为白名单功能，如需使用此功能，请联系您的 TikTok 销售代表。 若要为商品来源为商品库的视频购物广告请求 DSA 报表，则仅支持异步模式。
（已废弃）合约广告报表
重要提示 若想拉取 TopView 广告的报表数据，可使用 基础报表 或 受众分析报表 ，并在 筛选条件 buying_type 中指定 RESERVATION_TOP_VIEW 。 合约广告报表是一种报表类型，您可以通过此类报表获取 合约 广告账号中的广告的消耗和表现数据。目前，若想请求合约广告报表，需将 service_type 设置为 RESERVAT
兴趣分类
兴趣分类目前在TikTok API for Business平台上主要有三种用途。 其中一种典型使用场景是设置广告定向选项时传入具体的兴趣分类，从而缩小您希望定位的受众范围。 另一种用途是请求报表时传入准确的兴趣分类，使报表数据按兴趣分类进行分组。若想在请求受众分析报表时传入兴趣分类，请查看 受众分析报表 。 最后，兴趣分类还可以对返回数据进行分类。目前在
概念解释
本节解释了API For Business文档中常出现的概念。 平台 概念 定义 TikTok for Business TikTok for Business 是一个提供产品和解决方案的全球化平台，帮助各种规模的品牌产生商业影响。请访问其 网站 以了解更多信息。 TikTok Creator Marketplace TikTok Creator Marke
获取账单组列表
您可以使用本接口获取一个商务中心下的所有账单组。 代理商商务中心和直客商务中心都能执行账单组相关操作。 注意 只有拥有财务经理或财务分析师权限的用户才能在商务中心执行资金管理和发票的相关操作。您可以使用 /bc/member/invite/ 和 /bc/member/update/ 设置或更改成员权限。 v1.2与v1.3版本对比 以下表格概括了 v1.2与
创建账单组
您可以使用本接口在商务中心下创建一个账单组。 代理商商务中心和直客商务中心都能执行账单组相关操作。 注意 只有拥有财务经理或财务分析师权限的用户才能在商务中心执行资金管理和发票的相关操作。您可以使用 /bc/member/invite/ 和 /bc/member/update/ 设置或更改成员权限。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1
修改账单组
您可以使用本接口修改账单组的设置。 代理商商务中心和直客商务中心都能执行账单组相关操作。 注意 只有拥有财务经理或财务分析师权限的用户才能在商务中心执行资金管理和发票的相关操作。您可通过 /bc/member/invite/ 和 /bc/member/update/ 来设置或更改用户权限。 v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3 接口
回复评论
您可以使用本接口回复评论。 绑定以下两类认证身份，并且拥有评论管理权限的广告主可以回复已有的一级评论： 自定义用户 （ CUSTOMIZED_USER ） TikTok 用户（ TT_USER ） v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/comment/post/ /v1
删除评论
您可以使用本接口删除评论。 绑定以下两类认证身份，并且拥有评论管理权限的广告主可以删除自己的评论： 自定义用户 （ CUSTOMIZED_USER ） TikTok用户（ TT_USER ） v1.2与v1.3版本对比 以下表格概括了 v1.2与v1.3接口的变化。 变化内容 v1.2 v1.3 接口路径 /v1.2/comment/delete/ /v1.
认证身份 · Marketing API / Campaign Management / Guides / Ad
通过使用认证身份（广告发布身份）功能，您可以采用不同的方式创建 Spark Ads：将帖子从 TikTok For Business 账户推送至关联的企业号，从关联的企业号企业号提取帖子，从创作者的授权码提取帖子，或从创作者授权的账户提取帖子。 目前有五种类型的认证身份： 自定义用户（ CUSTOMIZED_USER ）：此类型的认证身份为虚拟TikTok账