登录开始免费试用
easyCoexistence 官方 API

TikTok 媒体 URL:已验证的域名和 URL 前缀

TikTok 的 API for Business 会从以下 URL 下载帖子媒体:video_url、custom_thumbnail_url 和 photo_images。每个 URL 都必须位于开发者应用已验证所有权的域名或 URL 前缀之下。域名通过 DNS TXT 记录验证,前缀则通过放在其下的签名文件验证,两项都经由 /business/property/add/ 和 /business/property/verify/ 完成,调用时需带上应用的 ID 和密钥。

easyCoexistence 从自有的已验证 URL 前缀向 TikTok 提供您的媒体:publish_tiktok_post 接收来自 Claude、ChatGPT 或您自有代码的 HTTPS 链接,并在 TikTok 下载时从该链接流式传输文件,因此您的域名无需验证。

Nov 16, 2023

此后,TikTok 会拒绝不在已验证域名或 URL 前缀上的视频 URL。

Oct 15, 2025

此后,URL 属性端点同样需要开发者应用的密钥。

1 / 2

property_type 取值:1 表示域名,2 表示 URL 前缀。

0, 1, 2

property_status 取值包括 pending、verified 和未验证,未验证表示验证尝试失败,须重新进行。

Apr 7, 2023

在此之前已发布视频的开发者,其视频 URL 所在的域名已自动设为已验证。

5 MB

/business/comment/image/upload/ 接受的最大图片,以 multipart 表单数据提交,用于评论或回复。

TikTok 会下载哪些 URL?

两个发布端点中的每个媒体字段,都是 TikTok 在接受调用后自行抓取的 URL,因此文件须保持可访问,直至下载完成:

  • video_url:视频,TikTok 建议至少保持 30 分钟有效。
  • custom_thumbnail_url:用作视频封面的图片。
  • photo_images:图文帖子最多 35 张图片。
  • 超时:TikTok 为下载提供一小时时间,超时后帖子会因 video_pull_failed 或 photo_pull_failed 而失败。

域名与 URL 前缀有何区别?

两者区别在于您证明拥有的范围,以及因此哪些 URL 算作已验证。域名适合您拥有或控制的主机上的媒体,前缀适合您只能上传文件的主机上的某个文件夹。TikTok 对每种属性类型的规则如下:

DomainURL prefix
What it isA site you own, such as example.com or a subdomainhttps:// plus a host, a path and a final /, such as https://www.example.com/videos/
ProofA DNS TXT record holding the signatureA file named file_name, holding the signature, uploaded under the prefix
CoversURLs on the domain and its subdomainsURLs that begin with the prefix
Leaves outThe parent: verifying video.example.com leaves example.com unverifiedSibling paths: /folder/user/ leaves /folder/public/ unverified
RedirectsNot applicableNot followed; a prefix answering 3xx is invalid

如何验证属性?

通过两次调用完成,二者都使用开发者应用的 app_id 和 secret 进行身份验证,而不是账户令牌,两次调用之间需放置证明文件:

  • 添加:POST /business/property/add/,参数为 url_property_meta(包含 property_type 和 url);响应返回 signature,前缀还会返回 file_name,property_status 为 0。
  • 证明:域名需将签名写入 DNS TXT 记录;前缀则需将签名写入公开文件,文件名为 file_name,扩展名为单个 .txt,并位于该前缀之下。
  • 检查:使用相同的 url_property_meta 调用 POST /business/property/verify/;property_status 为 1 表示已验证,为 2 表示尝试失败。
Add a URL prefix
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/property/add/' \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "<APP_ID>",
    "secret": "<APP_SECRET>",
    "url_property_meta": { "property_type": 2, "url": "https://media.example.com/tiktok/" }
  }'

# data.url_property_info: url, property_type, property_status (0), signature, file_name

如何列出或删除属性?

使用 app_id 和 secret 调用 GET /business/property/list/,将返回 url_property_info_list,其中每条记录包含 property_type、url、property_status、signature 和 file_name。已验证域名的子域名无需单独调用即视为已验证,但只有在被添加过的情况下才会出现在列表中。POST /business/property/delete/ 携带 app_id、secret 和 url_property_meta,可删除应用不再拥有或控制的属性。

能否上传文件而不是 URL?

帖子不能。Accounts API 只支持通过 URL 发布,包括草稿在内;其唯一的上传端点 /business/comment/image/upload/ 以 multipart 表单数据接收评论图片,支持 JPG、JPEG、WebP 和 PNG 格式,大小不超过 5 MB,并返回用于评论或回复的 image_uri。分块文件上传属于 developers.tiktok.com 上的 Content Posting API,这是一个拥有独立应用的单独 API,其中传输方式称为 FILE_UPLOAD。

未验证的 URL 会怎样?

TikTok 会拒绝从该 URL 发布。API for Business 参考文档说明了视频和图片的这一规则,但没有为此定义专门的返回代码,因此请查看响应中的代码和消息。developers.tiktok.com 上的 Content Posting API 将同一情况称为 url_ownership_unverified,返回 HTTP 403。在任何属性通过验证之前要测试视频端点,TikTok 会发布一个无需验证的测试视频 URL:

TikTok's test video URL for /business/video/publish/
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4

easyCoexistence 如何将您的媒体交给 TikTok?

通过 easyCoexistence 自有的一个已验证 URL 前缀:https://easycoexistence.com/api/social/media/。publish_tiktok_post 接收您的 HTTPS 链接,并在发送任何内容之前即拒绝 http://,然后向 TikTok 提供该前缀下的一个链接,其中包含一个用于标识您文件的签名令牌,6 小时后过期,并保留文件的扩展名。TikTok 抓取该链接时,easyCoexistence 会验证令牌、确认您的链接使用公网地址上的 HTTPS,并直接从您的链接流式传输文件(包括范围请求和重定向),且不作存储。如果您的链接失败,TikTok 无法下载文件,帖子将发布失败。

What TikTok receives in place of your link
Your link:       https://cdn.example.com/videos/launch.mp4
Sent to TikTok:  https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4

常见错误

  • 验证了子域名却将文件托管在其父域名上。已验证的 video.example.com 只覆盖其自身的子域名,不包括 example.com 本身。
  • 通过重定向提供前缀的签名文件。TikTok 不会为 URL 前缀跟随重定向,并将 3xx 响应视为无效。
  • 把签名文件保存为 name.txt.txt。TikTok 要求文件名与 file_name 一致,且扩展名只能是单个 .txt。
  • 发布调用后立即删除文件。TikTok 之后会在最多一小时内下载该文件,如果链接失效,帖子将发布失败。
使用 EasyCoexistence 完成这些操作

每个连接每月从 US$ 9 降至 US$ 0.75,连接越多价格越低,前 3 天免费。

常见问题

为什么 TikTok 要求媒体 URL 经过验证?

TikTok 表示,验证视频 URL 的所有权有助于其遵守关于版权内容和用户安全的政策。

已验证的 TikTok 域名是否涵盖其子域名?

是的。已验证域名的子域名视为已验证,不过 /business/property/list/ 只会显示被添加过的子域名。

TikTok 的 API for Business 能否从 S3 或 CDN 链接发布?

可以,前提是该链接位于应用已验证的域名或 URL 前缀之下,例如您可控制的存储桶或 CDN 路径上的某个前缀。

图片帖子是否也需要经过验证的 URL?

需要。TikTok 的图片端点明确说明,图片帖子无法从未验证的图片 URL 发布。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间