登入開始免費試用
easyCoexistence 官方 API

如何透過 API 將影片發布到 TikTok

透過 TikTok 的 API for Business 發布影片,需向 /business/video/publish/ 發送 POST 請求,附上帳戶的 business_id、位於已驗證網域或 URL 前綴下的 video_url,以及包含說明文字與設定的 post_info 物件,並在 Access-Token 標頭中附上存取權杖。TikTok 會回傳 share_id;將其作為 publish_id 傳給 /business/publish/status/,直至狀態顯示 PUBLISH_COMPLETE 並出現 post_ids 為止。

easyCoexistence 可透過 Claude、ChatGPT 或你自己的代理,使用 publish_tiktok_post 發布 TikTok 影片:傳入 HTTPS 連結、說明文字及是否開啟留言,再以 get_tiktok_publish_status 追蹤貼文狀態;檔案則經由已驗證的媒體路由傳送至 TikTok。

share_id

由發布請求回傳,例如 v_pub_url~v1.2345123456789123456,並作為 publish_id 傳給狀態查詢。

Nov 16, 2023

自此以後,若影片網址的網域或 URL 前綴未經驗證,TikTok 會拒絕發布。

6 a minute

TikTok 透過發布端點對每個帳戶的影片發布數量設有上限,每日最多 15 則。

3 min

post_ids 在 PUBLISH_COMPLETE 後需要多久才會出現;TikTok 建議三分鐘後重試。

post_id

影片通過審核後,會在 post.publish.publicly_available webhook 中發送,供查詢其洞察數據。

首次呼叫前需要準備什麼?

需要三樣東西:來自權杖交換的 TikTok 帳戶存取權杖與帳戶的 open_id;在 TikTok Accounts 下擁有 Video Publish 權限的開發者應用程式;以及位於應用程式已驗證網域或 URL 前綴下、可透過公開 HTTPS 或 HTTP URL 存取的影片。TikTok 會自行下載檔案,因此該網址必須保持可連線,TikTok 建議網址至少有效 30 分鐘。

發布請求的樣子是什麼?

向 https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ 發送 POST 請求,在 Access-Token 標頭中附上帳戶存取權杖,並將 Content-Type 設為 application/json。JSON 主體在 business_id 中指定帳戶、在 video_url 中指定檔案、在 post_info 中指定發布設定;以下範例會發布一則附說明文字的影片,並保持留言、Duet 與 Stitch 為開啟狀態:

Publish a video with curl
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "business_id": "<OPEN_ID>",
    "video_url": "https://media.example.com/tiktok/launch.mp4",
    "post_info": {
      "caption": "Our new menu is live #food",
      "is_brand_organic": false,
      "is_branded_content": false,
      "disable_comment": false,
      "disable_duet": false,
      "disable_stitch": false
    }
  }'

各個主體欄位的作用是什麼?

依 TikTok 參考文件列出的影片發布欄位,由最上層開始。封面、AI 生成標籤、位置、草稿及僅廣告選項也位於同一主體中:

  • business_id:來自權杖交換的帳戶 open_id。
  • video_url:TikTok 下載的檔案,支援 MP4、MOV 或 WebM,須位於已驗證的網域或 URL 前綴下。
  • post_info:每次呼叫均必填,即使為空物件,並包含發布的各項設定。
  • post_info.caption:最多 2,200 個字元(以 UTF-16 計算),可包含 #主題標籤及最多 30 個 @提及。
  • post_info.is_brand_organic 與 is_branded_content:「推廣內容」及「付費合作」標籤,TikTok 的表格將其標示為必填。
  • post_info.disable_comment、disable_duet 與 disable_stitch:設為 true 會關閉留言、Duet 或 Stitch;三者預設均為 false。

TikTok 會回傳什麼?

標準回應格式,其中 data 內含發布任務的 ID。代碼 0 表示 TikTok 已接受該任務,但不代表影片已上線:TikTok 仍需下載檔案、檢查並審核該發布內容。在 TikTok 的範例中,影片的 share_id 以 v_pub_url 開頭,圖片貼文的則以 p_pub_url 開頭。

The publish response
{
  "code": 0,
  "message": "Ok",
  "request_id": "20210817034316010245031056097316BA",
  "data": {
    "share_id": "v_pub_url~v1.2345123456789123456"
  }
}

如何追蹤貼文直至上線?

使用 GET /business/publish/status/,並傳入 business_id 及 share_id 作為 publish_id。TikTok 下載檔案時 status 顯示 PROCESSING_DOWNLOAD;貼文通過審核後顯示 PUBLISH_COMPLETE;若失敗則顯示 FAILED 並附上原因。貼文可公開檢視時,post_ids 會隨 PUBLISH_COMPLETE 一併出現,但可能延遲最多三分鐘。以下是完整流程的 Python 範例:

Publish and follow a video in Python
import os, time, requests

API = "https://business-api.tiktok.com/open_api/v1.3"
HEADERS = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"]}
BUSINESS_ID = os.environ["TIKTOK_BUSINESS_ID"]  # open_id from the token exchange

def call(method, path, **kwargs):
    body = requests.request(method, f"{API}/{path}", headers=HEADERS, timeout=30, **kwargs).json()
    if body.get("code") != 0:  # errors arrive in code, usually with HTTP 200
        raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
    return body["data"]

share_id = call("POST", "business/video/publish/", json={
    "business_id": BUSINESS_ID,
    "video_url": "https://media.example.com/tiktok/launch.mp4",
    "post_info": {"caption": "Our new menu is live #food",
                  "is_brand_organic": False, "is_branded_content": False},
})["share_id"]

for _ in range(30):
    time.sleep(60)  # each check is a call; TikTok's stages take minutes
    s = call("GET", "business/publish/status/",
             params={"business_id": BUSINESS_ID, "publish_id": share_id})
    if s["status"] == "FAILED":
        raise RuntimeError(s.get("reason"))
    if s["status"] == "PUBLISH_COMPLETE" and s.get("post_ids"):
        print("Live:", s["post_ids"])
        break

Webhook 能否取代狀態查詢?

可以,適用於透過 /business/webhook/update/ 訂閱 event_type VIDEO 的應用程式。TikTok 會在下載並檢查檔案後發送 post.publish.failed 或 post.publish.complete;審核通過後,發送含新 post_id 的 post.publish.publicly_available;若貼文日後不再公開,則發送 post.publish.no_longer_publicly_available。每個事件都會以 publish_id 標示任務,其值與 share_id 相同。

如何透過 MCP 發布影片?

在 Claude、ChatGPT 或其他連接至 https://easycoexistence.com/api/mcp 的用戶端中,以日常語言提出要求即可。助手會呼叫 publish_tiktok_post,並傳入來自 list_social_accounts 的 account_id、HTTPS 格式的 video_url、說明文字,若要關閉留言則加上 disable_comment。結果會包含 TikTok 的 share_id;get_tiktok_publish_status 則根據 account_id 與該 share_id,回傳 TikTok 當前的狀態、post_ids 及原因。

The MCP tool calls and their results
publish_tiktok_post {
  "account_id": "<ACCOUNT_ID>",
  "video_url": "https://media.example.com/tiktok/launch.mp4",
  "caption": "Our new menu is live #food",
  "disable_comment": false
}
=> { "share_id": "v_pub_url~v1.2345123456789123456",
     "note": "TikTok is processing the post. Check it with get_tiktok_publish_status." }

get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "v_pub_url~v1.2345123456789123456" }
=> { "status": "PUBLISH_COMPLETE", "post_ids": ["<POST_ID>"] }

publish_tiktok_post 會向 TikTok 發送什麼?

根據你的請求,向相同端點發出一次呼叫。你的連結會以 easyCoexistence 自有已驗證媒體路由產生的簽署連結傳送至 TikTok,因此無需另行驗證;說明文字與 disable_comment 會按你提供的內容傳送;is_brand_organic 與 is_branded_content 則設為 false。其餘設定,例如 Duet、Stitch、封面及 AI 生成標籤,則保留 TikTok 的預設值,影片會以公開貼文形式發布,這也是該端點的設計。

使用 Partner API 的憑證可以做什麼?

以該帳戶身分直接呼叫 TikTok。在 https://easycoexistence.com/api/v1 上使用 GET /channels/{id}?credentials=1,並以你的 ec_live_ 金鑰作為 bearer 權杖,即可取得含 credentials 物件的頻道資料:包括 api_base、business_id、目前有效的 access_token 及 token_expires_at。狀態查詢、影片列表、留言與洞察數據,皆可由你自己的程式碼執行。發布功能則需要事先規劃:直接發布呼叫會將 video_url 原樣傳給 TikTok,網址屬性需以開發者應用程式自身的 ID 與密鑰新增;而 easyCoexistence 應用程式已驗證的前綴,即其媒體路由,也就是 publish_tiktok_post 所使用的路由。

Credentials from the Partner API, then a direct status check
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
  -H "Authorization: Bearer $EC_API_KEY"

# "credentials": {
#   "platform": "tiktok",
#   "api_base": "https://business-api.tiktok.com/open_api/v1.3",
#   "business_id": "<OPEN_ID>",
#   "access_token": "<ACCESS_TOKEN>",
#   "token_expires_at": "2026-11-01T09:00:00.000Z", ...
# }

curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/publish/status/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'publish_id=<SHARE_ID>'

設定方法

  1. Get the token and the account IDExchange the owner's authorization code at /tt_user/oauth2/token/, and keep access_token for the header and open_id for business_id.
  2. Host the videoPut the MP4, MOV or WebM file under a domain or URL prefix verified for your app, where it stays reachable for at least 30 minutes.
  3. Call the publish endpointPOST business_id, video_url and post_info, with the caption, the two brand flags and the engagement switches, to /business/video/publish/.
  4. Keep the share_idStore data.share_id from the response, the ID of this publishing task.
  5. Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
  6. Record the post IDTake it from post_ids, or from post_id in the post.publish.publicly_available webhook, to read the video's metrics later.

常見錯誤

  • 漏掉 post_info。TikTok 要求每次呼叫都必須包含該物件,即使沒有任何設定需要更改。
  • 在發布回應中尋找貼文 ID。回應只包含 share_id;貼文 ID 須從狀態查詢或 publicly_available webhook 取得。
  • 重複發送逾時的發布呼叫。第一次請求可能已到達 TikTok,因此在重新發送前,請先查看帳戶最新的貼文。
  • 將代碼 0 視為影片已上線。這只表示 TikTok 已接受任務,檔案在下載後仍可能未能通過檢查。
使用 EasyCoexistence 完成這項設定

每個連接每月 US$ 9 至 US$ 0.75,連接越多越便宜,首 3 天免費試用。

常見問題

哪個端點可以發布影片到 TikTok?

POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/,在 Access-Token 標頭中附上帳戶存取權杖,JSON 主體包含 business_id、video_url 與 post_info。

TikTok API 能否直接上傳影片檔案?

/business/video/publish/ 不可以。它接受 video_url,並從該網址取得檔案,因此影片必須位於已驗證網域或 URL 前綴下的網址。

如何取得透過 API 發布的影片 ID?

可從 /business/publish/status/ 在狀態為 PUBLISH_COMPLETE 且貼文已公開後讀取 post_ids;或從 post.publish.publicly_available webhook 中的 post_id 取得。

能否透過 API 預約 TikTok 影片的發布時間?

發布端點在被呼叫時即發布,沒有時間欄位。easyCoexistence 會在自身的佇列中保存預約貼文,並於你設定的時間呼叫 TikTok。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期