跳转到主要内容
Ayrshare 提供 直接发布 TikTok 视频、评论管理,以及使用 TikTok API 检索个人或商业 TikTok 账户的高级分析。TikTok 异步处理视频和照片,因此对于立即和已安排的帖子,JSON 响应都将为 status: “pending”。TikTok 完成处理后,你已注册的 Scheduled Action webhook 将被调用。

TikTok 视频帖子

直接发布的基本 TikTok 视频帖子的 JSON:
TikTok Video Post
示例 JSON 帖子响应:
TikTok Video Post Response
  • TikTok 目前不支持帖子文本中的换行。包含的换行将被 忽略。
  • 可以发布一个视频或最多 35 张图片。TikTok 不支持 视频和图片组合。详情请见下方。
  • 如果视频不以已知的扩展名结尾,请使用 isVideo
  • TikTok 还支持发送无帖子文本的媒体。如果你不希望包含帖子文本, 请发送空字符串 post: ""
  • 更多信息请参见 TikTok 媒体指南TikTok 授权

TikTok 视频要求

  • 请参见 TikTok 视频要求
  • 视频必须以已知的视频扩展名(如 mp4)结尾。请对 URL 进行反向代理, 使用 CDN 添加虚荣 URL, 或使用 /media 端点。
  • TikTok 的帖子文本字符限制为 2,200。
TikTok 限制 API 视频发布为每分钟 6 个视频,每天上限为 15 个视频。

TikTok 图片帖子

直接发布的基本 TikTok 图片(照片)帖子的 JSON:
TikTok Image Post
示例 JSON 响应:
TikTok Image Post Response
  • TikTok 目前不支持帖子文本中的换行。包含的换行将被 忽略。
  • 可以发布一个视频或最多 35 张图片。
  • TikTok 不支持视频和图片的组合。详情请见下方。
  • 图片必须为 JPG、JPEG 或 WEBP 类型。TikTok 不接受 PNG 媒体文件。
  • 你还可以使用 imageCoverIndex 选择其中一张图片作为封面照片。默认情况下, 使用第一张图片。详情请见下方。

TikTok 图片要求

  • 请参见 TikTok 图片要求
  • 一个帖子最多可以包含 35 张图片,每张图片 20 MB。
  • 图片必须为 JPG、JPEG 或 WEBP 类型。TikTok 不接受 PNG 媒体文件。
  • TikTok 的帖子文本字符限制为 2,200。
TikTok 限制 API 视频发布为每分钟 6 张照片,每天上限为 15 张 照片。

TikTok 处理

TikTok 对视频和图片进行异步处理,因此响应将会有 id 字段设置为 "pending"。 在 TikTok 完成处理后(通常在 1-2 分钟内),id 字段将被更新为 TikTok 视频的 id,并添加 postUrl
  • 你可以使用 webhook/history 端点检索 TikTok 帖子的最终状态,通常需要 1-2 分钟才可用。
  • 当用户在 TikTok 移动应用中发布视频时,将发送一个 “scheduled” webhook, 携带 subAction: "tikTokPublished"
  • TikTok 帖子上的 首个评论 被延迟:它在 tikTokPublished webhook 解析真实视频 id 时自动发布,而不是在发布 时间发布。视频 visibility 必须为 public,否则无法发布首个评论,并返回 评论错误。
  • 如果发生错误,例如 TikTok 无法处理视频或 Ayrshare 内部测试 失败,id 字段将设置为 “failed”,errors 字段将包含错误 详情。
  • idShare 用于内部引用待处理的视频。

TikTok 选项

发布 TikTok 视频或图片时,可以使用附加选项 视频发布示例:
TikTok Video Publishing
图片发布示例:
TikTok Image Publishing

选项

TikTok 帖子可用以下选项。 它们应添加到 tikTokOptions 对象中。 每个选项的详情请见下方。
TikTok Options
autoAddMusic
boolean
默认值:false
是否自动向帖子添加推荐音乐。 如果将此字段设为 true,你可以稍后在 TikTok 应用中更改音乐。媒体类型:image
disableComments
boolean
默认值:false
是否禁用已发布帖子的评论。媒体类型:video, image
disableDuet
boolean
默认值:false
禁用已发布视频的合拍。媒体类型:video
disableStitch
boolean
默认值:false
禁用已发布视频的拼接。媒体类型:video
draft
boolean
默认值:false
是否创建草稿帖子。更多信息请参见 草稿选项媒体类型:video 或 image
isAIGenerated
boolean
默认值:false
是否为视频帖子启用 AI 生成的内容开关。如果启用该开关,你的视频将在发布后被标记为 “Creator labeled as AI-generated”,且无法更改。 “Creator labeled as AI-generated” 标签表示内容完全由 AI 生成或经过 AI 大幅编辑。
只要你的视频不违反 TikTok 的 社区 准则,开启 AI 生成内容设置不会影响视频的分发 。
媒体类型:video
isBrandedContent
boolean
默认值:false
是否启用 品牌内容 开关。如果将此字段设为 true,视频将被标记为品牌内容,表明你与品牌有付费合作。视频上会附加 “Paid partnership” 标签。媒体类型:video, image
isBrandOrganic
boolean
默认值:false
是否启用品牌自然内容开关。如果将此字段设为 true,视频将被标记为品牌自然内容,表明你在推广自己或你的企业。视频上会附加 “Promotional content” 标签。媒体类型:video, image
imageCoverIndex
number
默认值:"0"
用作帖子封面的 mediaUrls 索引。媒体类型:image
title
string
帖子的标题。媒体类型:image
thumbNailOffset
number
用作视频封面的帧。更多信息请参见 视频缩略图选项媒体类型:video
visibility
string
默认值:"public"
帖子的分享方式和可见对象。值:publicprivatefollowersfriends更多信息请参见 可见性选项媒体类型:image

可见性选项

可见性描述
public对所有 TikTok 用户可见。
private私有,仅账户本身可见。
followers仅账户的关注者可见。
friends仅相互关注者可见。
私有帖子将保持在 pending 状态,在帖子公开之前不会发送 TikTok webhook。

视频缩略图

有两种方式为 TikTok 视频设置缩略图(也称为封面照片):
  1. 使用 thumbNailOffset 参数设置缩略图帧。
  2. 使用 thumbNail 参数从 URL 设置缩略图图片。
仅视频支持设置缩略图。

缩略图偏移量

通过选择偏移帧为 TikTok 视频设置缩略图。
TikTok Video Thumbnail Offset
偏移量是缩略图帧在毫秒中的位置。默认值为 0,即视频的第一帧。

缩略图 URL

通过从 URL 上传图片为 TikTok 视频设置缩略图。
TikTok Video Thumbnail URL
如果你使用 thumbNail 参数,thumbNailOffset 参数将被忽略。 更多信息请参见 TikTok 缩略图要求

TikTok 提及

通过在帖子文本中添加 @handle 来提及其他 TikTok 用户。例如:
TikTok Mention
请查看提及功能的重要规则

TikTok 草稿帖子

为 TikTok 视频或图片创建草稿帖子,允许你在发布前编辑视频或图片。
TikTok Video Draft Post
草稿视频或图片帖子将在 TikTok 应用底部的通知 Inbox 中找到。 查找 System notifications 消息,然后点击顶部的 Your content from Ayrshare is ready 消息。 Ayrshare 的 postUrl 将保持在 pending 状态,直到视频发布。草稿帖子不支持首个评论。 TikTok Draft Post

授权刷新

TikTok 必须_每年_通过 Social Accounts 页面重新授权。
  • 在授权到期前 15 天,将发送电子邮件和 webhook 社交操作通知。
  • 可以从 /user 端点检索所需的刷新日期和剩余天数。

字符限制

更多信息请参见 TikTok 字符限制

附加信息

更多 使用 TikTok API 的示例