Google Ad Library API
公開広告主の検索、企業ごとのクリエイティブの取得、URLによる既知の透明性センターのクリエイティブ1件の取得ができ、調査やレビューに活用できます。
利用できるGoogle Ad Library API
候補の検索にはAdvertiser Search、上限付きのクリエイティブセットの取得にはCompany Ads、正確な公開クリエイティブURL 1件の解決にはAd Detailsを使用します。
取得できるGoogle広告透明性データ
SocQは透明性センターで取得可能な公開フィールドを正規化し、取得元で利用できない値は null または空のまま保持します。
広告主の検索
クエリから、広告主の候補、Webサイト、ロゴ、地域、取得可能な広告数のフィールドを見つけます。
クリエイティブとリンク先のコンテキスト
取得可能なテキスト、広告主の参照、フォーマット、メディアアセット、ランディングページのリンク先を取得します。
公開されている配信のコンテキスト
取得可能な日付、国、Googleの掲載面、安全に正規化されたインプレッションの値を保持します。
SocQとGoogle広告のプロダクト
SocQは対応する公開透明性レコードを正規化します。認可済みのアカウントやキャンペーンの操作には、Google広告のプロダクトが適しています。
| 機能 | SocQ | Google広告のプロダクト |
|---|---|---|
| 主な用途 | 公開透明性レコードの検索と正規化 | 認可済みの広告アカウントとキャンペーンの管理 |
| 入力 | クエリ、企業の識別子とフィルター、または正確なクリエイティブURL | プロダクト固有のアカウント、キャンペーン、レポートの入力 |
| 認証 | SocQのAPIキー | プロダクト固有のGoogle認証情報と認可 |
| レスポンス形式 | 正規化された公開広告主と広告のレコード | プロダクト固有の独自レスポンス |
Google Ad Library APIの仕組み
3つのエンドポイントはすべて、SocQの送信、ポーリング、結果の読み取りという非同期ライフサイクルを使用します。
1. エンドポイントを選ぶ
Advertiser Searchにはクエリ、Company Adsにはドメインまたは広告主ID、Ad DetailsにはクリエイティブURLを1件送信します。
2. タスクを送信して追跡
リクエストをPOSTして task_id を保存し、処理が終わるまで /v1/tasks/{task_id} をポーリングします。
3. 正規化された結果を読み取る
data.results.items を処理します。Company Adsは指定した上限に従い、Ad Detailsは最大1件のアイテムを返します。
SocQのAPIキーで認証し、企業のドメインまたは広告主IDのいずれかを指定します。取得件数上限のデフォルトは40です。
curl -X POST "https://api.socq.ai/v1/google-ad-library/company-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain":"lululemon.com","results_limit":40}'
# Also available:
# POST /v1/google-ad-library/advertiser-search
# POST /v1/google-ad-library/ad
# Poll GET /v1/tasks/{task_id}Google Ad Library APIの主なユースケース
広告主の発掘
広告を取得する前に、ブランドやWebサイトのクエリを公開広告主の候補に解決します。
企業のクリエイティブ調査
トピック、地域、日付、掲載面、フォーマットのフィルターを任意で指定し、上限付きの公開クリエイティブセットを取得します。
選定クリエイティブの情報補完
既知のクリエイティブのレコードに、広告主、テキスト、メディア、リンク先、配信のフィールドを補完します。
制限事項と公開データポリシー
結果はその時点の公開ソースの表示状況によって異なり、非公開のGoogle広告アカウントのデータは提供しません。
- Advertiser Searchにはクエリが1つ必要で、地域を任意で指定できます。results_limit の入力はありません。
- Company Adsには domain または advertiser_id が必要で、results_limit は40〜2,000の範囲で40の倍数を指定できます。
- Ad Detailsには、パスに /creative/ を含む adstransparency.google.com のURLが1つ必要で、最大1件のアイテムを返します。
- 公開レコードは不完全な場合があり、非公開の予算、クリック数、コンバージョン、入札、オーディエンス、広告費用対効果は含まれません。
Google Ad Library APIに関するよくある質問
最初にどのエンドポイントを使えばよいですか?
ブランドやWebサイトしかわからない場合はAdvertiser Search、ドメインや広告主IDがある場合はCompany Ads、正確なクリエイティブURLがすでにある場合はAd Detailsを使用してください。
企業の広告を絞り込めますか?
はい。トピック、地域、期間、Googleの掲載面、フォーマット、上限付きの results_limit を任意で指定できます。
これらのAPIで非公開のキャンペーン成果にアクセスできますか?
いいえ。これらのAPIは公開透明性レコードを扱うもので、非公開のアカウントやキャンペーンの分析データは提供しません。
結果の料金はどのように計算されますか?
返されたレコードは1件あたり0.5 SocQクレジットです。結果が空の場合の基本料金は設定されていません。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
Google Maps API
公開スポットの検索、既知のMaps URLの正規化された詳細の取得、取得元に紐づくスポット情報と投稿者のコンテキストを含む公開クチコミの取得ができます。
Amazon API
対応するマーケットプレイスで公開Amazon商品を検索し、正規化された商品詳細、売れ筋ランキング、レビュー、セラーのプロフィール、クリエイターのストアフロントのレコードを取得できます。
Apple App Store API
既知のストアURLから、公開Apple App Storeのアプリ詳細、カテゴリランキング、レビューを、正規化されたアプリとレビューのレコードとして取得できます。
SEO API
Googleのオーガニック検索結果をリアルタイムで取得し、キーワードの需要と順位獲得の難易度を比較し、シードキーワードを拡張し、サイトの検索での可視性を支えるキーワードとページを明らかにし、検索意図を分類できるほか、Googleニュース・画像・サジェスト、Bing、YouTubeの結果も集められます。すべてのエンドポイントで、共通のSocQのAPIキー、非同期タスクフロー、正規化された結果形式を使用します。
Telegram API
t.meリンクから公開Telegramチャンネルを読み取ります。登録者数付きのチャンネル情報、閲覧数とリアクション付きの投稿、個別の投稿、ディスカッショングループのコメント、類似チャンネル、全履歴の検索に対応します。
Link in Bio API
クリエイターがInstagram、TikTok、YouTubeのプロフィール欄に置く1本のリンクを、表示名、紹介文、アイコン、掲載されている連絡先メール、連携SNS、各ボタンのタイトルとリンク先という構造化データに変えます。


