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 の使い方
国、期間、指標を選んで、チャートを読み取ります。
- {"country": "US", "period": "daily", "results_limit": 20} を /v1/tiktok-creative-center/top-videos に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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を受け付けます。
関連API
TikTok Creative Center Top Videos API 以外に別の種類の公開TikTok Creative Centerデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Creative Center Top Ads API — 成果の高い広告をキーワードと期間で閲覧し、キャプション、CTR、いいね数、広告動画を返します。
- TikTok Creative Center Ad Analysis API — トップ広告1件を、クリックスルーと視聴維持率のカーブで1秒ごとに分析します。
- TikTok Creative Center Trending Hashtags API — 国別のトレンドハッシュタグのランキングを、投稿数、再生数、人気度カーブとともに取得します。
- TikTok Creative Center Hashtag Insights API — トレンドハッシュタグ1つについて、人気度カーブ、上位の国、サンプル動画を詳しく調べます。
- TikTok Creator Marketplace API — Creator Marketplace のカードを、フォロワーの属性、再生数の中央値、最低料金とともに取得します。