tiktok-creative-center/
top-ads

TikTok Creative Centerで成果の高いトップ広告を、キーワード、7日・30日・180日の期間、並び順を指定して取得できます。キャプション、CTR、いいね数、目的、業種、広告動画が付きます。

TikTok Creative Center Top Ads API

成果の高い広告
広告ごとのCTR
広告動画ファイル
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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 の使い方

トップ広告を絞り込み、結果をページごとに取得します。

  1. {"query": "skincare", "time_range": "30d", "sort_by": "likes"} を /v1/tiktok-creative-center/top-ads に 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-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クレジットで、配信国と秒ごとのカーブが加わります。

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

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

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

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

TikTok Creative Center Top Ads APIは、TikTok Creative Centerに掲載されている成果の高い広告を、キーワード、期間、並び順で絞り込んで収集するためのプログラムインターフェースです。各広告のキャプション、業種、目的、クリック率、いいね数、動画を返します。

いいえ。Top Adsは成果の高い広告を厳選し、CTRといいね数とともに見せるリストです。TikTok Ad Libraryは配信された広告の透明性のためのアーカイブで、広告主やキーワードで検索しますが、CTRはわかりません。

いいえ。Top Adsに載るのは、広告主がCreative Centerへの表示を許可した広告だけなので、成果の高い広告のサンプルであって、完全な記録ではありません。広告主単位で調べるには、TikTok Ad Libraryのエンドポイントを使ってください。

このエンドポイントでは絞り込めません。指定できるのは query と time_range です。業種と目的は広告ごとに返るので、リクエスト後に絞り込み、広告の配信国は TikTok Creative Center Ad Analysis で確認してください。

sort_by に指定できるのは relevance か likes だけです。最大300件を取得して、返ってきた ctr で自分で並べ替えてください。

返された広告1件につき0.5クレジットなので、300件で150クレジットです。広告が1件も返らないリクエストは課金されません。

各広告の media に動画URL、サムネイル、サイズ、長さが入っているので、ファイルを取得できます。動画の権利は広告主にあるため、再公開ではなく、リサーチや参考としての利用にとどめてください。