tiktok-creative-center/
top-videos

TikTok Creative Centerのトップ動画チャートを国別に取得できます。再生数、エンゲージメント率、6秒視聴率で順位づけし、オーガニック再生数とCreator Marketplace IDも付きます。

TikTok Creative Center Top Videos API

国別チャート
日次・週次・長期
再生数とエンゲージメント率
結果1件あたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

TikTok Creative Center Top Videos

Creative Centerのトップ動画は、ある国で成果の高い動画としてTikTokが公開しているチャートで、再生数、エンゲージメント率、6秒視聴率のいずれかで順位づけされ、各動画のキャプション、クリエイター、チャート期間内の再生数、累計再生数、オーガニック再生数が示されます。このチャートからは、どの動画がその市場で注目を集めているか、リーチのどれだけがオーガニックか、どのクリエイターが繰り返し登場するかがわかります。

TikTok Creative Center Top Videos API の主な機能

  • 日次・週次・長期のチャートperiod で国ごとに読むチャートを選び、公開済みの最新版が自動的に使われます。
  • 3つの順位づけ指標sort_by でチャートを views、engagement_rate、six_second_view_rate のいずれかで並べ替えます。
  • リーチを3つに分解metrics には、チャート期間の views_count、organic_views_count、lifetime_views_count が、2つの比率とともに分けて入ります。
  • 動画とクリエイターの識別各行にキャプション、url、cover_url、author に加え、TikTok Creator Marketplace が受け付けるCreator Marketplace IDの creator_id が入ります。

TikTok Creative Center Top Videos API のパラメータ

パラメータ必須説明
country任意市場の2文字の国コードです(US、GB、JP など)。デフォルトは US です。
period任意読み取るチャートです。daily(デフォルト)、weekly、long_term から指定します。
sort_by任意順位づけの指標です。views(デフォルト)、engagement_rate、six_second_view_rate から指定します。
results_limit任意取得する動画の件数です。1〜100の範囲で指定し、デフォルトは20です。

TikTok Creative Center Top Videos API の使い方

国、期間、指標を選んで、チャートを読み取ります。

  1. {"country": "US", "period": "daily", "results_limit": 20} を /v1/tiktok-creative-center/top-videos に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から順位順に動画を読み取り、has_more が true の間は results.next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"US","period":"daily","sort_by":"views","results_limit":20}'

# creator_id on each item feeds TikTok Creator Marketplace.

TikTok Creative Center Top Videos API の主なユースケース

  • フックのベンチマーク: 国のチャートを six_second_view_rate で並べ、上位の動画のキャプションとカバーを見て、6秒を超えても視聴者をつなぎとめる冒頭のパターンを整理します。
  • オーガニックと有料のリーチの比較: 行ごとに organic_views_count を views_count で割って、自力で伸びた動画と、主に有料配信で伸びた動画を切り分けます。
  • 週次の市場スナップショット: 国ごとの週次チャートを保存し、id で行を突き合わせて、繰り返し登場する動画やクリエイター、入れ替わるフォーマットを確認します。
  • クリエイター候補リスト: チャートの行から creator_id を集め、重複を除いて Creator Marketplace に送ると、オーディエンスと料金の詳細がわかります。

TikTok Creative Center Top Videos API 活用のヒント

  • engagement_rate と six_second_view_rate は割合として読んでください。0.0265 は 2.65 ではなく、2.65パーセントです。
  • rank は選んだ sort_by での順位です。順位を比較してよいのは、country、period、sort_by が同じ実行どうしだけです。
  • 1人のクリエイターが複数の行を占めることがあるので、渡す前に重複した creator_id をまとめてください。Creator Marketplace は1リクエストにつき最大20個のIDを受け付けます。

TikTok Creative Center Top Videos API 以外に別の種類の公開TikTok Creative Centerデータが必要な場合は、これらのAPIをご利用ください。

他のプラットフォームを見る

TikTok Creative Centerのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

TikTok Creative Center Top Videos API — よくある質問

TikTok Creative Center Top Videos APIは、TikTok Creative Centerにある成果の高い動画のチャートを、国、期間、順位づけの指標を指定して取得するためのプログラムインターフェースです。各動画の順位、キャプション、クリエイター、チャート期間内・オーガニック・累計の再生数、エンゲージメント率、6秒視聴率を返します。

views はチャート期間内のリーチ順です。engagement_rate はエンゲージメント数を再生数で割った値の順で、反応を引き出す動画が上に来ます。six_second_view_rate は少なくとも6秒再生された視聴の割合の順で、冒頭が強い動画を見つけられます。

公開済みの最新版で、通常は現在の日付から2日ほど前のものです。週次チャートは日曜日に終わります。

両方のリーチが含まれます。views_count はチャート期間のすべての再生、organic_views_count は有料でない配信による分なので、後者が前者よりずっと小さい行は、主にプロモーションで伸びた動画です。

author.id はクリエイターのTikTokユーザーIDです。creator_id はCreator Marketplace IDで、TikTok Creator Marketplace が受け付ける値です。

views_count はチャート期間内の再生数だけなので、数か月前に公開された動画でも、いまも見られていればランクインします。公開以来の合計は lifetime_views_count でわかります。

すべての市場にすべての期間のチャートがあるわけではありません。タスクは結果0件で成功し、課金されないので、別の期間や国を無料で試せます。チャートが存在する場合は、1行につき0.5クレジットです。