開発

TikTok APIの使い方:Content Posting APIの審査と投稿自動化の実装コード

コンテンツの自由度と柔軟性

TikTok APIは1本のAPIではありません。ログイン連携のLogin Kit、プロフィールと動画一覧を読むDisplay API、動画を投稿するContent Posting API、研究者向けのResearch API、広告運用向けのAPI for Businessに分かれ、申請先も審査も別です。この記事では2026年11月17日時点のTikTok for Developersの公式ドキュメントをもとに、APIごとの違い、OAuthのトークン交換、Display APIでの取得、Direct Postでの動画投稿をcurlとPythonで示します。投稿自動化の可否を分ける審査(Audit)の制限と、審査で見られる投稿画面の要件もあわせて整理します。

まとめ:TikTok APIで投稿自動化を組む前に決めるAPI種別と審査の段取り

動画を自動で公開したいなら、使うのはContent Posting APIのDirect Postとvideo.publishスコープです。ただし審査前のアプリは24時間で5ユーザーまで、しかも投稿は本人だけが見られるSELF_ONLYに限られます。公開投稿を本番で動かすには審査が前提で、審査ではクリエイター名の表示や公開範囲の手動選択など、投稿画面の作りまで確認されます。

読み取りだけならDisplay APIで足ります。利用者自身のプロフィールと投稿動画の一覧が取れ、上限は1分あたり600回です。他人の動画やハッシュタグを横断検索するResearch APIは、日本の企業や大学が申請できる対象地域に入っていません。社内の公式アカウントへ予約投稿したいだけなら、自社でAPIを組むより審査済みの外部ツールを選ぶほうが早く確実です。

TikTok APIの種類と役割:ログイン・動画取得・投稿・広告の違い

Login Kit・Display API・Content Posting APIの入口はTikTok for Developersの開発者ポータルです。ここで作ったアプリに、使いたい製品とスコープを追加して申請します。広告運用のAPIだけは別ポータルで、アカウントも別に作ります。

開発者ポータルで申請する各APIと用途・必要スコープの対応表

API できること 主なスコープ
Login Kit TikTokアカウントでのログイン user.info.basic
Display API 本人のプロフィールと動画一覧の取得 user.info.basic
video.list
Content Posting API 動画と写真の投稿・下書き送信 video.publish
video.upload
Research API 公開データの横断検索 研究者の個別申請
API for Business 広告の作成と配信結果の取得 別ポータルで認可

どのAPIも、利用者がLogin KitのOAuth画面で許可したスコープの範囲でしか呼べません。Display APIの導入ガイドも、Login Kitでのアクセストークン取得を前提にしています。実務ではまずLogin Kitを通し、そのトークンで他のAPIを呼ぶ順番になります。

Research APIは日本の企業・研究者が申請できない対象地域の制限

Research APIの製品ページが挙げる申請対象は、米国・欧州・カナダ・ブラジルの研究者です。大学はEEA・英国・スイスなど、非営利の研究機関はEU域内という条件が付き、商業目的から独立していることや倫理審査の証明も求められます。

日本は2026年11月時点の対象に入っていません。「競合アカウントの投稿をハッシュタグで集計したい」という企画は、公式APIでは組めないと判断してください。Display APIで取れるのは、認可した本人の動画だけです。

広告運用のAPI for Businessは別ポータルでの開発者登録が前提

広告の入稿やレポート取得は、TikTok for Developersではなく、TikTok API for Businessの側で扱います。公式SDKのGitHubリポジトリのREADMEは、TikTok For Businessアカウントの作成、開発者登録、開発者アプリの作成、認可と認証の取得を前提手順に挙げています。

同じSDKはJava・Python・JavaScript版を用意し、呼び出しには広告主IDとアクセストークンを渡します。オーガニック投稿の自動化と広告の自動化はアプリも審査も別物なので、要件定義の段階で分けて見積もります。

開発者ポータルでのアプリ登録とLogin KitのOAuth認可を通す手順

TikTokのOAuthは認可コード方式です。仕組みの全体像はOAuth 2.0の認可フローと認証との違いで確認できます。ここではTikTok固有の制約に絞ります。

アプリ作成からスコープ申請までの開発者ポータル上での作業手順

  1. 開発者ポータルにログインし、アプリを作成してクライアントキーとクライアントシークレットを控える
  2. 製品としてLogin Kitを追加し、リダイレクトURIを登録する
  3. Display APIやContent Posting APIを追加し、必要なスコープを選ぶ
  4. 非公開に設定したテスト用アカウントで、認可から投稿までを試す
  5. アプリの説明や利用目的を整えて審査を申請する

クライアントシークレットはContent Sharing Guidelinesでも、第三者への共有やオープンソースへの埋め込みを禁じています。トークン交換は必ずサーバー側で行う構成にします。

リダイレクトURIの登録制約とWeb・モバイルで分かれるPKCEの要否

Login Kit for Webのドキュメントでは、リダイレクトURIは最大10件、1件512文字未満、httpsで始まる絶対URIと決められています。クエリパラメータや#を含むURIは登録できません。

戻り先の画面を切り替えたいときは、URIに値を足すのではなくstateに乗せます。stateは推測できない乱数にし、コールバックで送った値と一致するかを確かめてCSRFを防ぎます。PKCEのcode_verifierはモバイルアプリとデスクトップアプリで必須で、Webアプリの例には含まれていません。

認可コードをアクセストークンへ交換するcurlと2時間・180日の期限

コールバックで受け取ったcodeをURLデコードし、Get a User Access Tokenのとおりフォーム形式で送ります。

curl -X POST "https://open.tiktokapis.com/v2/oauth/token/" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "client_key=${TIKTOK_CLIENT_KEY}" \
  --data-urlencode "client_secret=${TIKTOK_CLIENT_SECRET}" \
  --data-urlencode "code=${AUTH_CODE}" \
  --data-urlencode "grant_type=authorization_code" \
  --data-urlencode "redirect_uri=https://example.com/tiktok/callback"

応答のaccess_tokenは2時間、refresh_tokenは180日で切れます。トークン管理のガイドは、期限を固定値で持たずexpires_inとrefresh_expires_inの秒数から更新時刻を決めるよう勧めています。

更新は同じエンドポイントにgrant_type=refresh_tokenで送ります。リフレッシュの仕様ではトークンがローテーションされ、新しいrefresh_tokenが出た時点で古いものは使えません。複数のワーカーが同時に更新すると片方が失効トークンを掴むので、更新処理は利用者ごとにロックを取って1本化します。

Display APIでプロフィールと投稿動画一覧を取得するリクエスト例

Display APIのエンドポイントは/v2/user/info/、/v2/video/list/、/v2/video/query/の3本です。返す項目はクエリのfieldsで明示します。

user/infoとvideo/listでfieldsを指定して取得するcurlの書き方

# プロフィール(GET)
curl -X GET "https://open.tiktokapis.com/v2/user/info/?fields=open_id,avatar_url,display_name" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}"

# 投稿動画の一覧(POST・新しい順)
curl -X POST "https://open.tiktokapis.com/v2/video/list/?fields=id,title,duration,cover_image_url,embed_link" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"max_count": 20}'

一覧は作成日時の降順で返り、応答のhas_moreがtrueならcursorを使って続きを取ります。video.listは認可した本人の動画を読むスコープで、自社サイトに公式アカウントの最新動画を並べる用途に向いています。

毎分600回のスライディングウィンドウ制限と429時の待機設計

Rate Limitsのページによると、user/info・video/query・video/listはそれぞれ1分あたり600回です。1分間のスライディングウィンドウで数え、超えるとHTTP 429とrate_limit_exceededが返ります。

Webページの表示ごとにAPIを呼ぶ作りだと、アクセスの山で上限に届きます。動画一覧は数分おきのバッチで取得してデータベースに保存し、ページはそこから描画する構成にしてください。429を受けたら指数的に待ち時間を延ばし、上限の引き上げはサポートページから申請します。

Content Posting APIの動画投稿実装と公開・下書きの選択

投稿にはDirect PostとUploadの2つの方式があります。どちらを選ぶかで、必要なスコープと利用者の操作が変わります。

video.publishとvideo.uploadを公開・下書きの用途で選ぶ基準

Direct Postはvideo.publishを使い、アプリからそのままプロフィールへ公開します。一方のUploadはvideo.uploadで動画を下書きとして送り、利用者がTikTokアプリの受信通知から編集を続けて投稿を確定します。

完全な自動公開を求めるならDirect Post一択です。編集や音源の選択を人がアプリで仕上げる運用なら、Uploadのほうが投稿画面の実装要件が軽く済みます。動画がサーバー上にあるならPULL_FROM_URL、利用者の端末にあるならFILE_UPLOADを使うのがガイドラインの指定です。PULL_FROM_URLは、配信元のドメインかURLプレフィックスを開発者ポータルで所有確認しておく必要があります。

creator_info取得から公開状態確認までPythonで書く投稿処理の流れ

Direct Postの導入ガイドの手順を、requestsで1本にまとめた例です。公開範囲は、取得したprivacy_level_optionsから利用者が選んだ値を渡します。

import os
import time
import requests

API = "https://open.tiktokapis.com/v2"
HEADERS = {
    "Authorization": f"Bearer {os.environ['TIKTOK_ACCESS_TOKEN']}",
    "Content-Type": "application/json; charset=UTF-8",
}

def post_video(path, title, privacy_level):
    # 1. 投稿先アカウントの状態を取得(公開範囲の選択肢・最大秒数)
    info = requests.post(f"{API}/post/publish/creator_info/query/",
                         headers=HEADERS, timeout=30).json()
    if info["error"]["code"] != "ok":
        raise RuntimeError(info["error"])
    if privacy_level not in info["data"]["privacy_level_options"]:
        raise ValueError("選べない公開範囲です")

    # 2. 投稿を初期化(10MB単位で分割。5MB未満は1チャンク)
    size = os.path.getsize(path)
    chunk = min(size, 10_000_000)
    count = size // chunk
    body = {
        "post_info": {
            "title": title,
            "privacy_level": privacy_level,
            "disable_comment": False,
            "disable_duet": True,
            "disable_stitch": True,
            "brand_content_toggle": False,
        },
        "source_info": {
            "source": "FILE_UPLOAD",
            "video_size": size,
            "chunk_size": chunk,
            "total_chunk_count": count,
        },
    }
    init = requests.post(f"{API}/post/publish/video/init/",
                         headers=HEADERS, json=body, timeout=30).json()
    if init["error"]["code"] != "ok":
        raise RuntimeError(init["error"])
    publish_id = init["data"]["publish_id"]
    upload_url = init["data"]["upload_url"]

    # 3. チャンクを順番どおりにPUT(途中は206、最後は201)
    with open(path, "rb") as f:
        for i in range(count):
            start = i * chunk
            end = size - 1 if i == count - 1 else start + chunk - 1
            f.seek(start)
            data = f.read(end - start + 1)
            r = requests.put(upload_url, data=data, timeout=300, headers={
                "Content-Type": "video/mp4",
                "Content-Length": str(len(data)),
                "Content-Range": f"bytes {start}-{end}/{size}",
            })
            r.raise_for_status()

    # 4. 公開完了か失敗まで確認(上限は1分30回なので間隔を空ける)
    while True:
        time.sleep(10)
        st = requests.post(f"{API}/post/publish/status/fetch/",
                           headers=HEADERS, json={"publish_id": publish_id},
                           timeout=30).json()
        status = st["data"]["status"]
        if status in ("PUBLISH_COMPLETE", "FAILED"):
            return st["data"]

初期化のvideo/initは、Direct Postのリファレンスで1トークンあたり1分6回に制限されています。titleはUTF-16で2,200文字まで、brand_content_toggleは必須項目です。creator_infoのリファレンスによると、公開アカウントではPUBLIC_TO_EVERYONE、非公開アカウントではFOLLOWER_OF_CREATORが選択肢に入ります。

5MB〜64MBのチャンク分割とContent-Rangeヘッダーの組み立て方

Media Transfer Guideの規則は次の4点です。分割の計算を誤ると、初期化は通ってもアップロードの段階で弾かれます。

  • 各チャンクは5MB以上64MB以下。最後のチャンクだけ端数を吸収して128MBまで許される
  • 5MB未満のファイルは分割せず、chunk_sizeにファイル全体のバイト数を入れる
  • total_chunk_countはvideo_sizeをchunk_sizeで割った切り捨てで、1〜1000個
  • 50,000,123バイトを10,000,000バイトで送るなら、1回目はContent-Range: bytes 0-9999999/50000123

切り捨てで数えるので、端数は最後のチャンクに足し込みます。上のコードでendを最後だけsize - 1にしているのはこのためです。動画はMP4・WebM・MOV、H.264などのコーデックで、最大4GB・10分まで送れます。

status fetchのFAILED理由と再試行してよいエラーの見分け方

Get Post Statusのfail_reasonは、再試行してよいものと止めるべきものに分かれます。

fail_reason 対応
internal 時間をおいて再試行
video_pull_failed 配信元URLを確認して再試行
file_format_check_failed 形式を変換してから再送
duration_check_failed 最大秒数に収めて再送
spam_risk_too_many_posts 翌日まで投稿を止める
auth_removed 再認可を依頼し再試行しない

状態確認は1トークンあたり1分30回までです。投稿が多いサービスでは、ポーリングの代わりに開発者ポータルでWebhook URLを設定して完了通知を受けます。受信側の署名検証と重複通知の扱いはWebhookの署名検証と冪等性の実装と同じ考え方で組めます。

審査(Audit)前の制限と通過に必要な投稿画面のUX実装要件

Content Posting APIで一番時間がかかるのは、コードではなく審査への対応です。審査前の制限を知らずに本番日程を組むと、公開日に投稿が非公開のまま並ぶ事態になります。

未審査アプリは24時間5ユーザー・SELF_ONLY投稿に限られる制限

Content Sharing Guidelinesによると、未審査のアプリが投稿できるのは24時間で最大5ユーザーまでで、投稿はすべてSELF_ONLYになります。投稿先が公開アカウントの場合、初期化の時点で返るのはHTTP 403のunaudited_client_can_only_post_to_private_accountsです。開発中は、テスト用アカウントを非公開に設定して検証します。

審査を通ると公開制限の解除を申請でき、申請フォームの利用見積もりをもとに24時間あたりのアクティブクリエイター数の上限が決まります。クリエイター1人の投稿は1日15件前後が目安で、この枠はDirect Postを使う全アプリで共有です。上限に届くとspam_risk_too_many_postsが返ります。

公開範囲の初期値なし・同意文言など投稿画面に必須のUX実装項目

審査では、投稿画面がガイドラインの要件を満たしているかが見られます。実装の抜けが多い順に並べると次のとおりです。

  • 公開範囲はprivacy_level_optionsから利用者が手動で選び、初期値を入れない
  • コメント・デュエット・スティッチの許可は初期状態をオフにし、無効な項目はグレーアウトする
  • 投稿ボタンの前にMusic Usage Confirmationへの同意文言を表示する
  • 商用コンテンツの開示設定を初期オフで置き、Promotional contentとPaid partnershipの表示を出し分ける
  • 投稿先のクリエイターのニックネームと動画のプレビューを表示する
  • 自動生成したタイトルやハッシュタグを利用者が編集でき、宣伝用の透かしを足さない

どれも「利用者が内容を確認して自分で投稿を決めた」状態を担保するための要件です。裏で一括投稿する画面のないバッチは、この要件を満たせません。

TikTok API投稿自動化を自社開発すべき条件と見送るべき運用パターン

ここまでの制約を踏まえると、投稿自動化を自社で開発して元が取れる場面はかなり限られます。判断の分かれ目は、投稿の主体が誰かです。

自社開発が見合うのはクリエイター本人が投稿操作する自社サービス

自社開発を選ぶのは、動画編集サービスやEC・店舗アプリのように、自社の利用者が自分のTikTokアカウントを連携して投稿する場合です。投稿画面は自社サービスの中にあり、審査要件のUXをそのまま製品の機能として作れます。利用者が増えるほど、他社ツールへの送客ではなく自社サービスの価値になります。

この場合の工数は、OAuthとトークン更新、チャンク送信、状態確認、審査要件の画面、Webhook受信の5つです。InstagramのInstagram Graph APIの投稿機能やYouTube Data API v3のアップロードも同時に載せるなら、トークン保管と投稿キューを共通部品にすると後から足しやすくなります。設計から審査対応までまとめて任せたい場合は、外部APIとの連携開発として相談いただけます。

社内アカウントへの予約投稿だけなら審査の想定外として開発を見送る

自社の公式アカウント1つへ予約投稿したいだけなら、Direct Postの自社開発は見送ります。ガイドラインは、テスト用途や社内限定の用途を想定していないと明記しています。審査を通る見込みが立たないまま開発費をかけることになり、通らなければ投稿はずっとSELF_ONLYのままです。

この場合は、すでに審査を通った外部の投稿管理ツールを契約するか、Uploadで下書きを送って担当者がアプリで仕上げる運用にします。投稿の頻度や体制そのものを見直したいときは、企業アカウントのSNS運用体制とKPIから先に決めるほうが手戻りがありません。

TikTok APIの審査・認証・投稿上限についてよくある質問

開発を始める前に確認されることの多い5点を、公式ドキュメントの記載をもとに答えます。

未審査のまま公開投稿しようとするとどうなりますか?

投稿先が公開アカウントなら、video/initの時点でHTTP 403のunaudited_client_can_only_post_to_private_accountsが返り、投稿は始まりません。非公開アカウントへの投稿は通りますが、公開範囲は本人だけが見られるSELF_ONLYに限られます。未審査で投稿できるのは24時間で5ユーザーまでなので、社内テストでも、この人数枠を超えないことが条件です。公開投稿を本番で使うには、審査を通したうえで公開制限の解除を申請します。

TikTok APIでほかのユーザーの動画やハッシュタグを検索できますか?

企業向けに開かれている範囲ではできません。Display APIで取れるのは、Login Kitで認可した本人のプロフィールと投稿動画だけです。公開データの横断検索ができるのはResearch APIですが、申請できるのは米国・欧州・カナダ・ブラジルの研究者や非営利機関で、日本は2026年11月時点の対象外です。競合分析が目的なら、TikTok公式の分析画面や広告向けの機能で取れる範囲から設計し直します。

アクセストークンの有効期限が切れたらどうすればよいですか?

アクセストークンは2時間で切れるので、保存しているrefresh_tokenをgrant_type=refresh_tokenで送って取り直します。更新のたびに新しいrefresh_tokenが返り、古いものはその時点で使えなくなるため、必ず上書き保存します。refresh_token自体の期限は180日で、これも切れたら利用者に再認可を依頼するしかありません。期限は応答の秒数から計算し、固定値で持たない設計にします。

1つのアカウントに1日何本まで投稿できますか?

Content Sharing Guidelinesの目安は、クリエイター1人あたり1日15件前後です。この枠はDirect Postを使うすべてのアプリで共有されるため、利用者がほかの投稿ツールも使っていれば、自社アプリから送れる本数はさらに減ります。上限に届くとspam_risk_too_many_postsが返るので、翌日まで投稿を止め、利用者にその旨を表示します。この投稿上限と、初期化APIの1分6回というレート制限は別の集計です。

動画ファイルはどの形式とサイズまでAPIで送れますか?

Media Transfer Guideによると、形式はMP4(推奨)・WebM・MOV、コーデックはH.264(推奨)・H.265・VP8・VP9です。フレームレートは23〜60FPS、縦横はそれぞれ360〜4096ピクセルで、ファイルは最大4GB、長さは10分まで送れます。ただし実際に投稿できる秒数はアカウントごとに違うため、creator_infoのmax_video_post_duration_secと照らしてから初期化します。

関連記事

お気に入りに入れた記事の一覧

一創の公式 SNS

X では毎朝の新着記事と IT ニュースの速報を、YouTube・TikTok・Instagram・LinkedIn・Facebook では記事の解説動画を配信しています。

この記事は以下の記事からリンクされています

資料請求

今日のトレンド記事 直近 24 時間で、いつもより多く読まれている記事

  1. 2026.11.13 テックブログ 宝くじ公式サイト不正アクセス:4,436名の対象確認とパスワード再設定、変更された仕組み
  2. 2026.11.14 テックブログ Gitの脆弱性6件:CVE-2026-111760の再帰クローン対策と2.56.1への更新手順
  3. 2026.11.14 テックブログ ImageMagickの脆弱性VU#580079:policy.xmlの許可リスト設定と影響判定の手順
  4. 2026.11.14 テックブログ Check Point脆弱性CVE-2026-123039:Gaiaのroot権限昇格を確かめるコマンドと侵害調査の手順
  5. 2026.11.13 テックブログ KARTEの不正アクセス:JINS約1,829万件など利用企業の漏えい一覧と、タグ・配信・データ連携を確かめる手順【11月17日時点】

RELATED POSTS 関連記事

目次