TikTok API

検索

動画、アカウント、トップのいずれかのタブを対象に、キーワードでTikTokを検索します。キャプション、投稿者、いいね・コメント・シェア・再生の各数を取得できます。タブはcontent_typeで選択します。検索結果は全体を網羅するものではなく、ランキングの根拠も示されません。

プロフィール

ハンドルでTikTokアカウントを検索します。自己紹介、外部リンク、フォロワー数、フォロー数、いいね数、動画数、友達数、作成日を取得できます。ハンドルは@の有無を問わず指定できます。プロフィールURLやDouyinのsecUidは使用できません。非公開の分析データは含まれません。

ユーザーの動画

TikTokクリエイターの動画を、キャプション、公開日時、いいね・コメント・シェア・再生の各数とともに一覧表示します。min_likesで絞り込み、untilで公開日の上限を指定し、sortで新しい順、古い順、人気順に並べ替えられます。下書きと非公開の投稿は含まれません。

動画の詳細

URLから、TikTok動画1本のキャプション、投稿者、公開日時、いいね・コメント・シェア・再生の各数を取得します。コメントと文字起こしは別のアクションで取得できます。指標の履歴は保持しません。

コメント

TikTok動画のコメントを読み取ります。各コメントのいいね数、返信数、返信のリンク、クリエイターがいいねまたはピン留めしたかどうかを取得できます。トップレベルのコメント1件につき返信は最大2件のため、会話ツリー全体の取得は保証されません。

ハッシュタグ

ハッシュタグ付きで投稿されたTikTok動画を閲覧します。各動画には、キャプション、クリエイター、いいね・コメント・シェア・再生の各数が含まれます。タグは#の有無を問わず指定できます。一般的なテキスト検索ではありません。また、タグの総投稿量やトレンドも測定しません。

フォロワー

ハンドルを指定して、TikTokアカウントのフォロワー数、フォロー数、投稿数、いいね数の合計を確認します。丸められた数値を示すprecisionフラグも含まれます。返すのは件数で、フォロワーの名前は含まれません。

文字起こし

URLからTikTok動画の文字起こしを抽出します。全文に加え、タイムスタンプ付きのセグメントがある場合はそれも取得できます。最初にhas_transcriptを確認してください。音声が認識可能であること、翻訳されること、文字起こしが完全に正確であることは保証されません。

ショップ内商品検索

キーワードでTikTok Shopの商品を検索します。価格、元の価格、販売数、評価、レビュー数、カテゴリ、ショップ名を取得できます。市場はcountryで指定し（デフォルトはUS）、pageで結果をページ単位で取得します。在庫やGMVは算出しません。

ショップクリエイター詳細

ハンドルから、TikTok Shopクリエイターの規模を把握します。カテゴリ、フォロワー数、動画数、紹介している商品、販売数、平均再生数を取得できます。countryはクリエイターの国籍ではなく、Shopの市場を指定します。非公開の売上、コミッション、購入者は表示されません。

ハッシュタグ検索

keywordでTikTokのハッシュタグを検索します。各ハッシュタグには、ID、名前、リンク、説明、動画数、再生数が含まれます。1ページあたり20件で、next_page_tokenで次のページを取得します。検索対象はハッシュタグで、ハッシュタグが付いた動画は返しません。動画を取得するには、hashtagに名前を指定してください。

音楽検索

曲名やアーティスト名などのkeywordで、TikTokのサウンドライブラリを検索します。各サウンドには、ID、タイトル、アーティスト、アルバム、長さ、使用している動画数、オリジナルサウンドと商用ライブラリのフラグ、リリース日、カバー画像、短いプレビューリンクが含まれます。1ページあたり20件で、next_page_tokenで次のページを取得します。

音楽チャート

TikTokの音楽チャートを取得します。top50（デフォルト）またはviral50を指定できます。各サウンドには、rank、ID、タイトル、アーティスト、アルバム、言語、長さ、使用回数、商用ライブラリのフラグ、リリース日、カバー画像、プレビューリンクが含まれます。1回の呼び出しで全50件が返ります。

アカウント検索

keywordでTikTokのアカウントを検索し、TikTokの検索結果の順位順で返します。各アカウントにはユーザーID、ハンドル、表示名、sec_uid、フォロワー数、フォロー数、いいね数、動画数、認証状態、アバター、現在ライブ配信中かどうかが含まれます。1ページあたり20件で、next_page_tokenで次のページに進みます。

サウンドを使用した動画

music_idまたはサウンドページのリンクから、1つのサウンドを使用しているTikTok動画を一覧表示します。各動画には、キャプション、投稿者、投稿日時、再生・いいね・コメント・シェア・保存の各数、長さ、ハッシュタグ、広告・ピン留め・スライドショーのフラグが含まれます。1ページあたり約20件で、next_page_tokenで次のページを取得します。

コメントへの返信

TikTok動画の1件のコメントに付いた返信を、動画のurlと、commentsが返すコメントのidから読み取ります。各返信には、テキスト、いいね数、日時、返信者のハンドル・名前・ID、クリエイターがいいねしたかどうかが含まれます。1ページあたり最大20件で、next_page_tokenで次のページを取得します。

ショップの売れ筋商品

東南アジアまたはアジアの1市場について、TikTok Shopのベストセラーリストを取得します。対象市場はID、JP、MX、MY（デフォルト）、PH、SG、TH、VNです。各商品には、rank、ID、リンク、名前、価格、元の価格、通貨、販売数、評価、レビュー数、ショップ名、shop_idが含まれます。米国、英国、ブラジルにはベストセラーリストがありません。

ショップのカテゴリ別商品

選択した市場で、category_id（例：601450はビューティー・パーソナルケア）を指定して、TikTok Shopの1カテゴリの商品を一覧表示します。各商品には、ID、リンク、名前、価格、元の価格、通貨、販売数、評価、レビュー数、ショップ名、shop_idが含まれます。1ページあたり約15件で、next_page_tokenで次のページを取得します。

フォロー中

ハンドルを指定して、TikTokユーザーがフォローしているアカウントを一覧表示します。各アカウントには、ユーザーID、ハンドル、表示名、sec_uid、自己紹介、フォロワー数・フォロー数・いいね数・動画数、認証状況、アバター、国が含まれます。1ページあたり20件で、next_page_tokenで次のページを取得します。一覧を非公開にしているユーザーの場合は、空の一覧が返ります。

動画のダウンロードリンク

TikTok動画1本のダウンロードリンクを、urlから透かしなしで取得します。バックアップ付きのvideo_url、サイズ、幅と高さ、高画質版のリンク（ある場合）、透かし入りのリンク、音源、カバー画像、そしてリンクが無効になる日時を示すexpires_atが返されます。写真投稿の場合は、代わりにimage_urlsが返されます。

ライブルーム

ハンドルを指定して、TikTokアカウントが現在ライブ配信中かどうかを確認します。配信中の場合は、ルームID、タイトル、リンク、現在の視聴者数、ピーク時と累計の視聴者数、いいね数、シェア数、商品数、開始時刻、カバー画像、有効期限付きの配信リンクを取得できます。配信中でないアカウントの場合は、is_liveがfalseの行が1件返ります。

ショップのストア商品

選択した市場で、shop_idまたはストアのリンクから、TikTok Shopの1ストアの商品を一覧表示します。各商品には、ID、リンク、名前、価格、元の価格、通貨、販売数、評価、レビュー数、ショップ名、shop_idが含まれます。1ページあたり最大30件で、next_page_tokenで次のページを取得します。

ショップの商品レビュー

product_idまたは商品リンクから、TikTok Shopの商品1件の購入者レビューを取得します。各レビューには、星評価を示すrating、テキスト、投稿日時、購入したバリエーション、購入確認済みフラグとインセンティブ提供フラグ、写真、一部が伏せられた購入者名、国が含まれます。新しい順またはおすすめ順で並べ替えられ、ratingで特定の星評価のみに絞り込めます。1ページあたり20件です。

トレンドのハッシュタグ

TikTokで、特定の市場における過去7日間、30日間、または90日間のトレンドハッシュタグを取得します。業界を1つ指定して絞り込むこともできます。各ハッシュタグには、rank、ID、名前、リンク、動画数、再生数、日ごとの人気度を0〜100で示すtrendが含まれます。1ページあたり20件、全体で100件です。next_page_tokenで次のページを取得します。