TikTok API for Business のスコープ:各権限で開放される内容
TikTok の API for Business は、2 つの層でアクセスを許可します。開発者アプリは TikTok Accounts の下で権限を保持し、Video Publish や Manage Account Comment などの権限がエンドポイントを開放します。アカウント所有者の認可により、user.insights や video.list などのアクセストークンのスコープが与えられ、返されるフィールドが決まります。/tt_user/token_info/get/ は、トークンが持つスコープを一覧表示します。
easyCoexistence は、TikTok のアカウント所有者に、アプリが保持する権限を 1 回のサインインでまとめて求めます。
TikTok Accounts のスコープ ID。Accounts API のプロフィール、投稿、コメント、公開の各エンドポイントの上位にある第一階層の権限です。
アカウントのプロフィールデータにおける is_business_account と has_advanced_access の元になるスコープ。
アプリが comment.update の Webhook イベントを受け取るために、所有者が付与し、有効に保つ必要があるスコープ。
投稿を公開せず下書きとしてアップロードするために、トークンに必要なスコープ。
TikTok が開発者アプリの権限変更を審査するのにかかる営業日数。
2 層の TikTok 権限とは何ですか?
アプリ権限とトークンスコープです。アプリ権限は「My Apps」「該当アプリ」「Scope of permission」の順に選択し、TikTok が審査します。3 段階があり、第一階層の権限は配下のすべてのエンドポイントを対象とします。トークンスコープは、アカウント所有者がアプリを認可した際に承認した内容で、トークンごとに scope としてカンマ区切りの 1 つの文字列で返されます。呼び出しには、そのエンドポイントに対するアプリの権限が必要で、一部のレスポンスフィールドはトークン側のスコープも必要とします。
各エンドポイントを開放するアプリ権限はどれですか?
TikTok の API リファレンスは、Accounts API のエンドポイントごとに、それを開放する TikTok Accounts 配下の権限を示します(該当しない場合もあります)。権限スコープのリファレンスと Webhook ガイドでは、同じ区分を Business User、Business Media、Business Comment、Business Content と呼んでいるため、両方の名称が使われることを想定してください:
どのトークンスコープがどのフィールドを開放しますか?
/business/get/ と /business/video/list/ の TikTok のリファレンスは、レスポンスフィールドごとに必要な権限を示しています。さらに、2 つの別の機能がそれぞれ独自のスコープを指定しています:
- user.info.basic:
display_nameとprofile_image。 - user.info.username: username。2023 年 6 月までは user.info.basic が必要でした。
- user.info.profile:
profile_deep_link、bio_description、is_verified。 - user.info.stats:
following_count、followers_count、total_likes、videos_count。 - user.account.type:
is_business_accountとhas_advanced_access。 - user.insights: 日次のアカウント指標、および年齢、性別、国、都市別のフォロワー内訳。
- video.list:
item_id、caption、share_url、likes、comments、shares、reach、video_viewsなどの投稿フィールド。 - video.insights: 視聴時間、全編視聴率、リテンション、流入元、視聴者の内訳、投稿が生み出すクリック数。
- comment.list: comment.update Webhook。TikTok はこれを、アプリ内コンテンツのコメントと返信の読み取りとして説明しています。
- video.upload:
upload_to_draftまたはis_draftを使った、動画または写真投稿の下書きとしてのアップロード。
スコープはどうやって確認しますか?
/tt_user/token_info/get/ に app_id と アクセストークンを渡して呼び出します。すると、トークンの scope と、アカウントの creator_id が返されます。TikTok のスコープ文字列の例には video.publish と comment.list.manage も含まれています。これらの名称は公開とコメント管理のエンドポイントに対応していますが、TikTok のリファレンスはどちらのフィールドにも紐づけていません。
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
-H 'Content-Type: application/json' \
-d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"app_id": "<APP_ID>",
"creator_id": "<OPEN_ID>",
"scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
}
}easyCoexistence の TikTok 接続は何を要求しますか?
開発者アプリが保持するすべての権限で、いずれも TikTok の同意画面に表示されます。easyCoexistence は、アカウント所有者を、TikTok のポータルがアプリ用に生成する TikTok アカウント保有者の認可 URL に誘導します。この URL にはすでに権限が記載されており、easyCoexistence は独自の state 値を追加するだけです。所有者は TikTok が表示する内容を承認し、TikTok が返すスコープ文字列は接続情報とともに保存されます。その後 easyCoexistence がアカウントに対して呼び出すエンドポイントは次のとおりです:
- /business/get/:プロフィール、日次指標、フォロワー内訳の取得。
- /business/video/list/:投稿と、その指標の取得。
- /business/video/publish/、/business/photo/publish/、/business/publish/status/:公開。
- /business/comment/list/、/business/comment/reply/create/、/business/comment/hide/、/business/comment/delete/:コメントの操作。
- /business/webhook/update/(アプリ単位):コメント Webhook の設定。
後から権限を追加するにはどうしますか?
2 段階で、レイヤーごとに 1 つずつ行います。アプリについては、「My Apps」「該当アプリ」「Scope of permission」の順に開き、編集し、新しいスコープに合った理由を記入して送信します。TikTok の審査には 2〜3 営業日かかる場合があります。また、2026 年 3 月 20 日以降は、TikTok Accounts を含むリクエストに Accounts API Access Application Form が必要です。トークンについては、所有者がアプリを再度認可します。トークンは発行時に承認されたスコープを保持するためです。
権限が不足している場合はどうなりますか?
呼び出しの場合、TikTok の戻りコードは 40001 で、関連する操作に対する権限がないことを示します。その修正方法として、権限スコープのリファレンスが案内されます。フィールドの場合、リファレンスは所有者がそのスコープを付与した後にのみ利用可能になると記載しており、修正方法は、そのスコープを付けてアプリを再度認可してもらうことです。依頼する前に、/tt_user/token_info/get/ でトークンのスコープを確認してください。
よくある間違い
- 接続済みアカウントが新しいアプリ権限を自動的に得られると考えること。各所有者がアプリを再度認可するまで、トークンは認可時に承認されたスコープを保持したままです。
- user.account.type を付けずに is_business_account を要求すること。TikTok は、そのスコープを持つトークンにのみ、このフィールドと has_advanced_access を利用可能にします。
- comment.list なしで comment.update を待つこと。TikTok は、所有者の当該スコープの認可が有効なあいだだけコメントイベントを送信します。
- アプリ権限の名称をトークン内で検索すること。スコープ文字列には video.list などの名称が使われ、Get Account Media などの名称はアプリの設定に属します。
そのため、Claude、ChatGPT、または独自のコードから、ツールを通じて投稿、コメント対応、インサイトの取得ができます。get_social_credentials は、Accounts API の他のエンドポイント向けに、同じトークンを独自のコードに渡します。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
TikTok API for Business では、どのスコープを使いますか?
アカウント所有者が、TikTok Accounts のアプリ権限に加えて付与する、user.info.basic、user.info.stats、user.insights、video.list、video.insights、comment.list、video.upload などのトークンスコープです。
TikTok のコメント Webhook には、どの権限が必要ですか?
アプリには TikTok Accounts と Business Comment が必要で、所有者は comment.list を付与しなければなりません。この認可が期限切れになるか取り消されると、イベントは停止します。
新しい TikTok スコープは、発行済みのトークンにも適用されますか?
いいえ。トークンは発行時に承認されたスコープを保持するため、新しいスコープを追加するには、アカウント所有者がアプリを再度認可する必要があります。
TikTok が新しい権限を承認するまでにどのくらいかかりますか?
TikTok によると、権限変更の審査には 2〜3 営業日かかる場合があります。TikTok Accounts を先に追加するリクエストには、Accounts API Access Application Form が必要です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日