ログイン無料トライアルを開始
easyCoexistence 公式 API

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 動画を投稿します。

share_id

publish の呼び出しで返され、status の呼び出しに publish_id として渡される値です。例: v_pub_url~v1.2345123456789123456

Nov 16, 2023

それ以降、TikTok は検証されていないドメインまたは URL プレフィックスの URL からの動画を公開しません。

6 a minute

publish エンドポイント経由で行える、アカウントあたりの動画投稿数の上限です。1 日最大 15 件です。

3 min

PUBLISH_COMPLETE の後に post_ids が表示されるまでの所要時間です。TikTok は 3 分後に再試行するよう案内しています。

post_id

投稿がモデレーションを通過し、インサイトを照会できる状態になると、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 はオンのままで、キャプション付きの動画を公開します:

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: 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 で始まります。

The publish response
{
  "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 での全体の流れは以下のとおりです:

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 でステータス確認を置き換えられますか?

はい。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、理由がそのままの内容で返されます。

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 に対し、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 が使用するメディアルートです。

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 は設定を変更しない場合でも、すべての呼び出しでこのオブジェクトを必須としています。
  • publish のレスポンスで投稿 ID を探すこと。返されるのは share_id のみです。投稿 ID は status の呼び出し、または publicly_available webhook から取得します。
  • タイムアウトした publish 呼び出しを繰り返すこと。最初のリクエストが TikTok に届いている可能性があるため、再送する前にアカウントの最新の投稿を確認してください。
  • コード 0 を公開済みの動画と解釈すること。これは TikTok がタスクを受け付けたことを意味し、ダウンロード後の確認でファイルが失敗する可能性があります。
EasyCoexistence で実現する

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 監視

確認日