API で TikTok に動画を投稿する方法
TikTok の API for Business で動画を投稿するには、POST /business/video/publish/ に、アカウントの 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 動画を投稿します。
publish の呼び出しで返され、status の呼び出しに publish_id として渡される値です。例: v_pub_url~v1.2345123456789123456
それ以降、TikTok は検証されていないドメインまたは URL プレフィックスの URL からの動画を公開しません。
publish エンドポイント経由で行える、アカウントあたりの動画投稿数の上限です。1 日最大 15 件です。
PUBLISH_COMPLETE の後に post_ids が表示されるまでの所要時間です。TikTok は 3 分後に再試行するよう案内しています。
投稿がモデレーションを通過し、インサイトを照会できる状態になると、post.publish.publicly_available webhook で送信されます。
最初の呼び出しの前に必要なものは何ですか?
3 つ必要です。トークン交換で得られる TikTok アカウントのアクセストークンと、そのアカウントの open_id。TikTok Accounts の下で Video Publish 権限を持つ開発者アプリ。そして、アプリに対して確認済みのドメインまたは URL プレフィックスの下にある、公開された HTTPS または HTTP の URL 上の動画です。TikTok はファイルを自分でダウンロードするため、URL に到達可能な状態を保つ必要があります。TikTok は少なくとも 30 分間有効な URL を推奨しています。
投稿リクエストはどのような形式ですか?
Access-Token ヘッダーにアカウントのトークンを指定し、Content-Type を application/json にして、https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ に POST します。JSON ボディでは、business_id でアカウントを、video_url でファイルを、post_info で投稿の設定を指定します。以下の例では、コメント、Duet、Stitch はオンのままで、キャプション付きの動画を公開します:
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: UTF-16 で数えて 2,200 文字まで。#ハッシュタグと @メンションは最大 30 件まで使えます。post_info.is_brand_organicとis_branded_content: TikTok の表で必須と示されている、「Promotional content」と「Paid partnership」のラベルです。post_info.disable_comment、disable_duet、disable_stitch: true にするとコメント、Duet、Stitch をオフにします。3 つとも既定値は false です。
TikTok は何を返しますか?
通常のレスポンス形式で、投稿タスクの ID が data に入ります。コード 0 は、TikTok がタスクを受け付けたことを意味します。動画が公開されたことを意味するわけではありません。TikTok はまだファイルをダウンロードし、確認し、投稿をモデレーションする必要があります。TikTok の例では、動画の share_id は v_pub_url で始まり、写真投稿の share_id は p_pub_url で始まります。
{
"code": 0,
"message": "Ok",
"request_id": "20210817034316010245031056097316BA",
"data": {
"share_id": "v_pub_url~v1.2345123456789123456"
}
}投稿が公開されるまで、どのように追跡しますか?
GET /business/publish/status/ を使い、business_id と、publish_id として share_id を渡します。TikTok がファイルを取得している間、status は PROCESSING_DOWNLOAD を返します。投稿がモデレーションを通過すると PUBLISH_COMPLETE を返し、失敗時は理由付きで FAILED を返します。投稿が一般公開されて閲覧可能になると、PUBLISH_COMPLETE と一緒に post_ids が届きます。反映には最大 3 分ほどかかることがあります。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"])
breakWebhook でステータス確認を置き換えられますか?
はい。event_type として VIDEO を購読するアプリであれば、/business/webhook/update/ を使ってできます。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 に接続した他のクライアントに、普通の言葉で依頼してください。アシスタントは list_social_accounts で得た account_id、HTTPS の video_url、キャプションを指定して publish_tiktok_post を呼び出します。コメントをオフにしたい場合は disable_comment も指定します。結果には TikTok の share_id が含まれます。account_id とその share_id を指定して get_tiktok_publish_status を実行すると、TikTok のステータス、post_ids、理由がそのままの内容で返されます。
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 に対し、ec_live_ キーを Bearer トークンとして指定して GET /channels/{id}?credentials=1 を呼び出すと、credentials オブジェクトを含むチャネルが返ります。credentials には api_base、business_id、現在の access_token、token_expires_at が含まれます。その後、ステータス確認、動画リスト、コメント、インサイトは自分のコードから実行できます。計画が必要なのは投稿です。直接の publish 呼び出しでは video_url が加工されずに TikTok に渡されます。URL プロパティは開発者アプリ自身の ID とシークレットで追加します。easyCoexistence のアプリが確認済みのプレフィックスは、publish_tiktok_post が使用するメディアルートです。
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>'設定方法
- 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.
- 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.
- 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/.
- Keep the share_idStore data.share_id from the response, the ID of this publishing task.
- Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
- 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 は設定を変更しない場合でも、すべての呼び出しでこのオブジェクトを必須としています。
- publish のレスポンスで投稿 ID を探すこと。返されるのは share_id のみです。投稿 ID は status の呼び出し、または publicly_available webhook から取得します。
- タイムアウトした publish 呼び出しを繰り返すこと。最初のリクエストが TikTok に届いている可能性があるため、再送する前にアカウントの最新の投稿を確認してください。
- コード 0 を公開済みの動画と解釈すること。これは TikTok がタスクを受け付けたことを意味し、ダウンロード後の確認でファイルが失敗する可能性があります。
HTTPS リンク、キャプション、コメントの有無を指定すると、ファイルは確認済みのメディアルートを通じて TikTok に届きます。投稿の確認には get_tiktok_publish_status を使います。料金は接続 1 件あたり月額 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 プレフィックス上の URL にある必要があります。
API で投稿した動画の ID はどうやって取得しますか?
/business/publish/status/ で status が PUBLISH_COMPLETE になり、投稿が公開されてから返される post_ids から取得します。または、post.publish.publicly_available webhook の post_id から取得します。
API で TikTok の動画を後で投稿するよう予約できますか?
publish エンドポイントは呼び出された時点で投稿し、時刻を指定するフィールドはありません。easyCoexistence は予約投稿を独自のキューで保持し、指定した時刻に TikTok を呼び出します。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日