TikTok Creative Center API
TikTok Creative Centerのランキングを、成果の高い広告、国別のトレンドハッシュタグ、トップ動画のチャート、Creator Marketplaceのカードとして、クエリできるデータに変えます。
利用できるTikTok Creative Center API
Top Ads、Trending Hashtags、Top Videos はランキングを読み取ります。Ad Analysis、Hashtag Insights、Creator Marketplace は、それらのランキングから取り出した1件の広告、1つのハッシュタグ、または複数のクリエイターをさらに詳しく調べます。

tiktok-creative-center/top-ads
広告結果1件あたり0.5クレジット

tiktok-creative-center/ad-analysis
広告1リクエストあたり1クレジット

tiktok-creative-center/trending-hashtags
検索結果1件あたり0.5クレジット

tiktok-creative-center/trending-hashtag-detail
検索1リクエストあたり0.5クレジット

tiktok-creative-center/top-videos
投稿結果1件あたり0.5クレジット

tiktok-creative-center/creator-cards
プロフィール結果1件あたり0.5クレジット
取得できるCreative Centerのデータ
各エンドポイントは、選んだ広告、ハッシュタグ、チャート、クリエイターについてCreative Centerが表示する内容から作成した、安定したSocQのレコードを返します。
成果の高い広告
Creative Centerが選んだ広告について、キャプション、業種、目的、クリック率スコア、いいね数、広告動画を取得できます。1件の広告については、配信対象の国、インプレッションのパーセンタイル、1秒ごとのクリック率カーブと視聴維持率カーブも取得できます。
トレンドハッシュタグ
7日、30日、90日の国別ランキングを、順位、投稿数、再生回数、日別の人気度カーブとともに取得できます。Hashtag Insights では、1つのタグについてスコア順の人気の国とサンプル動画のIDが加わります。
トップ動画のチャート
国ごとの日次、週次、長期のチャートを、キャプション、クリエイター、期間内の再生数、オーガニック再生数、累計再生数、エンゲージメント率、6秒視聴率、クリエイターのMarketplace IDとともに取得できます。
Creator Marketplaceのカード
フォロワーの年齢、性別、国、端末の割合、再生数の中央値、エンゲージメント率とフォロワー増加率、クリエイターがスポンサー動画に掲載している開始料金を取得できます。
SocQとTikTok Creative Center
Creative Centerは、Webの画面でランキングを閲覧するためのTikTokの調査サイトです。SocQは同じランキングを、保存、比較、組み合わせができるAPIレコードとして返します。
| 機能 | SocQ | TikTok Creative Center |
|---|---|---|
| アクセス方法 | APIキーとJSONレコード | Webの画面 |
| 一括収集 | 1タスクで最大300件の広告、100個のハッシュタグ、または100本の動画 | ページごとの閲覧 |
| 追加の分析 | あるランキングのIDを次のエンドポイントに渡せる | ページ間を手動で移動 |
| 出力 | 説明付きの安定したSocQフィールド | 視覚的なチャートとカード |
TikTok Creative Center APIの仕組み
6つのエンドポイントはすべて、送信、ポーリング、読み取りという同じ非同期ライフサイクルを使います。
1. ランキングを読み取る
キーワード、国、期間などの条件を Top Ads、Trending Hashtags、Top Videos に送信します。
2. タスクをポーリング
返された task_id を使い、処理が成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
3. さらに詳しく調べる
広告の id を Ad Analysis に、ハッシュタグの id を Hashtag Insights に、creator_id の値を Creator Marketplace に送信します。
SocQのAPIキーで認証します。Top Ads のデフォルトは20件で、最大300件まで指定できます。
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"skincare","time_range":"30d","sort_by":"likes"}'
# Then analyze one ad:
# POST /v1/tiktok-creative-center/ad-analysis
# {"ad_id":"7697084527089729557"}
# Poll GET /v1/tasks/{task_id}TikTok Creative Center APIの主なユースケース
競合広告の検索
キーワードで Top Ads を検索していいね数順に並べ、各広告の業種、目的、クリック率スコアを読み取って、カテゴリでどんなクリエイティブの切り口が評価されているかを把握します。
広告の離脱ポイントの診断
Top Ads の id を Ad Analysis に渡し、click_through_curve と retention_curve を1秒ごとに比べて、視聴者がどこでクリックし、どこで離れるかを見ます。
市場別のハッシュタグ追跡
対象の国ごとのトレンドハッシュタグを定期的に取得し、popularity_curve で、まだ上り調子のタグを確認してから投稿を計画します。
フックとリーチのベンチマーク
国の動画チャートを six_second_view_rate で並べ、organic_views_count と views_count を比べて、視聴者をつなぎとめる冒頭と、主にプロモーションで伸びた動画を見分けます。
クリエイター候補の絞り込み
動画チャートから creator_id の値を取り、Creator Marketplace のカードで、オーディエンスの割合、再生数の中央値、エンゲージメント率、掲載されている開始料金を比べます。
データの範囲
結果は、ランキング、市場、期間ごとにCreative Centerが公開している内容に従います。
- Top Adsに載るのは、Creative Centerの成果基準を満たし、広告主が表示を許可した広告です。TikTokのすべての広告ではなく、厳選されたものです。
- 動画チャートは遅れて公開され、日次チャートは約2日遅れ、週次チャートは日曜日に終わる週のものです。チャートのない市場は結果が0件になり、課金されません。
- Creator Marketplaceのカードがあるのは、TikTokのCreator Marketplaceに登録しているクリエイターだけです。照会はMarketplace IDで行うため、ほかから取得したIDは一致しません。
- ハッシュタグのランキングで指定できるのは国と期間だけで、業種での絞り込みはありません。ランキングの行では、上位の国とサンプル動画は Hashtag Insights が返します。
- クリック率スコア、パーセンタイル、人気度の値は、Creative Centerが報告する相対的な指標であり、アカウント単位のキャンペーンレポートではありません。
TikTok Creative Center APIに関するよくある質問
TikTok Creative Center APIとは何ですか?
TikTok Creative Center APIは、TikTok Creative Centerのトップ広告、トレンドハッシュタグ、トップ動画のチャート、Creator Marketplaceのカードを、正規化されたJSONレコードとして読み取るためのプログラムインターフェースです。
TikTokアカウントや広告アカウントは必要ですか?
いいえ。リクエストにはSocQのAPIキーを使い、Creative Centerが公開調査ページで公開しているランキングを読み取ります。
ランキングから特定の広告、ハッシュタグ、クリエイターの詳細へはどう進みますか?
各ランキングが、詳細エンドポイントの受け取るIDを返します。広告の id は Ad Analysis に、ハッシュタグの id は同じ country とあわせて Hashtag Insights に、Top Videos の creator_id は Creator Marketplace に渡します。
Top AdsとTop Videosは何が違いますか?
Top Adsは有料のTikTok広告を、クリック率スコア、業種、目的とともに返します。Top Videosは国別の動画チャートを、再生数、オーガニック再生数、エンゲージメント率、各クリエイターのMarketplace IDとともに返します。
データはどのくらい新しいですか?
各リクエストは、その時点でCreative Centerが公開している内容を返し、すべてのレコードに collected_at のタイムスタンプが付きます。日次の動画チャートは現在の日付から2日ほど遅れ、週次チャートは日曜日に終わります。
各エンドポイントの料金はどうなっていますか?
Top Ads、Trending Hashtags、Top Videos、Creator Marketplace は返された結果1件につき0.5クレジットです。Ad Analysis は1リクエストにつき1クレジット、Hashtag Insights は1リクエストにつき0.5クレジットです。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
YouTube API
対応する公開YouTubeのチャンネルプロフィール、動画の詳細、チャンネルの動画、コメント、ショート、キーワード・ハッシュタグの検索結果、取得可能な文字起こしを、正規化された1つの非同期ワークフローで取得できます。
Facebook API
公開Facebookページのプロフィール、投稿、グループ投稿、コメント、キーワードに一致するイベント、取得可能な動画の文字起こしを取得できます。アカウント情報、コンテンツ、取得元、形式、場所、メディア、リアクション、参加状況、エンゲージメントのフィールドは正規化されています。
X API
公開プロフィール、フォロワー・フォロー中の関係、ポスト、返信、引用、リツイートしたユーザー、検索結果、現在のトレンドを取得できます。一貫した形式の結果を調査やモニタリングに活用できます。
LinkedIn API
既知のURLから、公開LinkedInのプロフィール、企業、投稿、求人のデータを取得できます。アカウント情報、職歴、企業、コンテンツ、エンゲージメント、求人のフィールドは正規化されています。
Reddit API
既知のURLから公開Redditの投稿とコメントを取得したり、サブレディットの新着・トップ・人気の投稿を閲覧したり、キーワードと公開期間で議論を検索したりできます。
Pinterest API
公開Pinterestプロフィールのデータ取得、既知のピンの解決、指定したプロフィールのピンの取得、キーワード検索ができ、クリエイター、コンテンツ、ビジュアルトレンドの調査に活用できます。