TikTok Ad Library API
クエリで対応する公開TikTok広告レコードを見つけたり、既知の広告URLを正規化されたフィールドに変換したりでき、調査、レビュー、アーカイブに活用できます。
利用できるTikTok Ad Library API
広告主名やキーワードで公開広告レコードを検索するにはSearch、条件を満たす既知の公開広告URLを1件解決するにはAd Detailsを使用します。
取得できる公開広告データ
返されるフィールドは、対応する各レコードで現在公開されている情報を反映します。取得元で利用できない値は null または空のままです。
広告と広告主の基本情報
公開広告ID、取得可能なレコードURL、広告主名、広告主の参照、固定のリソースの種類を取得します。
クリエイティブとリンク先
取得可能な広告コピー、フォーマット、メディア参照、公開ランディングページのURLを確認できます。
表示中の配信コンテキスト
公開されている場合、対応する表示日、公開日時、国、プラットフォーム、オーディエンス、インプレッションの情報を読み取ります。
取得時のコンテキスト
正規化された取得元と取得日時のフィールドを保持し、レビューキュー、カタログ、調査用データセットに活用できます。
SocQとTikTokの広告プロダクト
SocQは、対応する公開透明性レコードを読み取り専用で取得します。TikTok自身のプロダクトは、公開ライブラリへのアクセスから認可済みキャンペーンの管理まで、異なる目的に対応しています。
| 機能 | SocQ | TikTokの広告プロダクト |
|---|---|---|
| 主な用途 | 対応する公開広告レコードの検索と正規化 | プロダクトに応じて、公開透明性または認可済みキャンペーンの操作 |
| 入力 | 広告主名またはキーワード1件、あるいは既知の広告URL 1件 | 該当するTikTokの画面によって設定項目が異なる |
| 非公開のキャンペーンデータ | 利用不可 | 該当するアカウント、プロダクト、承認、権限が必要 |
| 操作 | 読み取り専用の公開データワークフロー | Ads Managerで認可済みキャンペーンの操作に対応 |
| レスポンス形式 | 安定したSocQの広告レコード | プロダクト固有の独自画面またはレスポンス |
TikTok Ad Library APIの仕組み
どちらのエンドポイントも、送信、ポーリング、読み取りという非同期ライフサイクルを使用します。Searchは取得元の複数ページを取得する場合があり、Ad Detailsは最大1件のレコードを返します。
1. エンドポイントを選ぶ
Searchには広告主名またはキーワードを1件、Ad Detailsには条件を満たす公開TikTok広告URLを1件送信します。
2. タスクをポーリング
返された task_id を使い、処理が成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
3. 正規化されたレコードを読み取る
data.results.items と、あればタスク結果のカーソルを使用します。詳細リクエストは0件または1件の広告を返します。
SocQのAPIキーで認証します。Searchのデフォルトは12件です。Ad Detailsにはページネーションや results_limit はありません。
curl -X POST "https://api.socq.ai/v1/tiktok-ad-library/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Anysphere","results_limit":12}'
# Or resolve one known ad URL:
# POST /v1/tiktok-ad-library/ad
# {"url":"https://library.tiktok.com/ads/detail/?id=1871655924410641"}
# Poll GET /v1/tasks/{task_id}TikTok Ad Library APIの主なユースケース
ブランドのモニタリング
既知の広告主名に一致する取得可能な公開広告について、定期的なレビュー用セットを作成します。
クリエイティブのレビュー
選んだ広告を解決し、対応する公開コピー、広告主、フォーマット、メディア、リンク先のフィールドを確認します。
透明性情報のアーカイブ
正規化された公開広告レコードを、表示日と取得時のコンテキストとともに保存します。
調査データの補完
検索結果でレコードを特定し、既知の公開広告URLを安定した詳細フィールドに変換します。
制限事項と公開データポリシー
公開広告レコードは、取得元の表示状況、対象条件、地域ごとの提供状況、公開までの遅延、保持期間、該当するTikTokの画面で公開されているフィールドによって異なります。
- 検索結果に含まれないことは、その広告主が一度も広告を出稿していないことの証明にはなりません。また、利用できないURLでは詳細の結果が返らない場合があります。
- Searchには、国、日付、セクション、言語、業種、目的、補完、並び順の設定はありません。
- 公開されている日付、オーディエンス、インプレッションの値は、非公開の費用、コンバージョン、アトリビューション、広告費用対効果のレポートではありません。
- メディア参照は一時的または取得元の管理下にある場合があり、取得元に依存するすべてのフィールドは null または空になることがあります。
TikTok Ad Library APIに関するよくある質問
SocQはTikTok Ads Managerですか?
いいえ。SocQは対応する公開透明性レコードを検索して正規化するサービスで、アカウント、キャンペーン、予算、ターゲティング、クリエイティブの管理は行いません。
何を送信できますか?
Searchは広告主名またはキーワードを1件受け付けます。Ad Detailsは、条件を満たす既知の公開TikTok広告URLを1件受け付けます。
すべての結果に完全な広告の詳細が含まれますか?
いいえ。Searchは通常概要を返し、詳細の照会ではレコードが返らない場合があります。また、取得元に依存するすべてのフィールドは null または空になることがあります。
料金はどのように計算されますか?
返されたレコードは1件あたり0.5 SocQクレジットで、基本料金はありません。Searchのデフォルトは12件、Ad Detailsは最大1件を返します。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
YouTube API
対応する公開YouTubeのチャンネルプロフィール、動画の詳細、チャンネルの動画、コメント、ショート、キーワード・ハッシュタグの検索結果、取得可能な文字起こしを、正規化された1つの非同期ワークフローで取得できます。
Facebook API
公開Facebookページのプロフィール、投稿、グループ投稿、コメント、キーワードに一致するイベント、取得可能な動画の文字起こしを取得できます。アカウント情報、コンテンツ、取得元、形式、場所、メディア、リアクション、参加状況、エンゲージメントのフィールドは正規化されています。
X API
公開プロフィール、フォロワー・フォロー中の関係、ポスト、返信、引用、リツイートしたユーザー、検索結果、現在のトレンドを取得できます。一貫した形式の結果を調査やモニタリングに活用できます。
LinkedIn API
既知のURLから、公開LinkedInのプロフィール、企業、投稿、求人のデータを取得できます。アカウント情報、職歴、企業、コンテンツ、エンゲージメント、求人のフィールドは正規化されています。
Reddit API
既知のURLから公開Redditの投稿とコメントを取得したり、サブレディットの新着・トップ・人気の投稿を閲覧したり、キーワードと公開期間で議論を検索したりできます。
Pinterest API
公開Pinterestプロフィールのデータ取得、既知のピンの解決、指定したプロフィールのピンの取得、キーワード検索ができ、クリエイター、コンテンツ、ビジュアルトレンドの調査に活用できます。

