TikTok Creative Center Top Ads
TikTok Creative CenterのTop Adsは、TikTokで成果を上げている広告を厳選したもので、各広告にキャプション、業種、キャンペーン目的、クリック率、いいね数、動画が付いています。まとめて見ると、あるカテゴリでどんなフック、フォーマット、オファーが勝ち続けているかが見えてくるので、クリエイティブのリサーチ、競合のウォッチ、広告のブリーフ作成に役立ちます。
TikTok Creative Center Top Ads API の主な機能
- Creative Center自身のトップ広告リスト結果は、Creative Centerが高成果と位置づけている広告から選ばれ、TikTokの関連度順またはいいね数順に並びます。
- 広告ごとのCTR、いいね数、キャンペーンの文脈各広告には ctr と likes に加え、Creative Centerのラベルによる業種と目的が付きます。
- 数字だけでなく動画そのものmedia には広告動画のURLがサムネイル、幅、高さ、長さとともに入り、text にキャプションが入ります。
- キーワード、期間、件数の指定query でキーワードを絞り込み、time_range で7日・30日・180日をさかのぼり、results_limit で1回のリクエストにつき最大300件の広告を取得できます。
TikTok Creative Center Top Ads API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
query | 任意 | 広告を絞り込む任意のキーワードです(商品カテゴリなど)。 |
time_range | 任意 | さかのぼる期間です。7d、30d(デフォルト)、180d から指定します。 |
sort_by | 任意 | relevance はTikTok自身の順序(デフォルト)、likes はいいね数の多い順です。 |
results_limit | 任意 | 取得する広告の件数です。1〜300の範囲で指定し、デフォルトは20です。 |
TikTok Creative Center Top Ads API の使い方
トップ広告を絞り込み、結果をページごとに取得します。
- {"query": "skincare", "time_range": "30d", "sort_by": "likes"} を /v1/tiktok-creative-center/top-ads に 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-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"skincare","time_range":"30d","sort_by":"likes"}'
# Each item's id can be sent to TikTok Creative Center Ad Analysis.TikTok Creative Center Top Ads API の主なユースケース
- 商品カテゴリ別のスワイプファイル作り: 商品キーワードで検索し、上位の広告のキャプション、動画、duration_seconds を、デザイナーや編集者向けの参考セットとして残します。
- 旬のフックと長続きするフックの見分け: 1つのキーワードを 7d と 180d で実行します。両方の期間に出てくる広告は効き続けているフォーマットで、短い期間にしか出ない広告は、いま試されているものです。
- 目的ごとにCTRで候補を絞り込む: 大量に取得して目的別にグループ分けし、グループごとに ctr で順位づけして、詳しく見る価値のある広告を見つけます。
- フックとフォーマットの大規模なラベル付け: キャプション、動画ファイル、長さを自社のタグ付けパイプラインに渡して、あるカテゴリで支配的なフックの種類と長さを集計します。
TikTok Creative Center Top Ads API 活用のヒント
- ctr の比較は、同じ結果セットで目的が同じ広告どうしに限ってください。単位はドキュメントに記載がなく、結果に予算やオファーのデータも含まれないため、TikTok全体のCTR基準値ではなく、広告同士を比べるのに使います。
- sort_by は relevance と likes だけなので、results_limit を大きめにして取得し、ctr での並べ替えは自分のコードで行ってください。
- フィールドは慎重に読んでください。industry と objective は campaign_objective_video_view のようなCreative Centerのラベルコードで返り、ドキュメントのサンプルでは advertiser と、metrics のコメント数・シェア数・再生数は null です。
- 毎回の実行で広告の id を保存し、それをキーに重複を除いてください。同じ広告が、クエリや期間を変えると別の結果にも現れます。
- 絞り込んだ id だけを TikTok Creative Center Ad Analysis に送ると、1広告あたり1クレジットで、配信国と秒ごとのカーブが加わります。
関連API
TikTok Creative Center Top Ads API 以外に別の種類の公開TikTok Creative Centerデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Creative Center Ad Analysis API — トップ広告1件を、クリックスルーと視聴維持率のカーブで1秒ごとに分析します。
- TikTok Creative Center Trending Hashtags API — 国別のトレンドハッシュタグのランキングを、投稿数、再生数、人気度カーブとともに取得します。
- TikTok Creative Center Hashtag Insights API — トレンドハッシュタグ1つについて、人気度カーブ、上位の国、サンプル動画を詳しく調べます。
- TikTok Creative Center Top Videos API — 国別の成果の高い動画のチャートを、再生数とエンゲージメント率とともに取得します。
- TikTok Creator Marketplace API — Creator Marketplace のカードを、フォロワーの属性、再生数の中央値、最低料金とともに取得します。