google-ad-library/
advertiser-search

検索語と任意の地域から公開Google広告透明性センターの広告主候補を探し、正規化された広告主情報、ウェブサイト、ロゴ、地域、取得可能な広告数フィールドを返します。

Google Ad Library Advertiser Search API

広告主候補
任意の地域指定
安定した識別フィールド
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Google Ad Library Advertiser Search

Google広告透明性センターでは、ブランド、組織、ウェブサイトの検索語に対して、地域別の法人や似た名前の団体を含む複数の広告主レコードが表示されることがあります。ID、名前、ウェブサイト、ロゴ、地域、取得可能な広告数を確認することで、クリエイティブを収集する前に正しい公開広告主レコードを選べます。

Google Ad Library Advertiser Search API の主な機能

  • 名前による広告主の発見空でないブランド名、組織名、広告主名、またはウェブサイトの語句を1つ指定して検索し、広告クリエイティブではなく正規化された広告主候補を受け取ります。
  • 任意の地域指定US などの region を渡して上流の検索に地域の文脈を与えます。region は広告の配信地域とは区別して扱われます。
  • 候補の識別フィールド公開広告主ID、名前、URL、ウェブサイト、ロゴ、地域、取得元が報告する広告数(取得できた場合)を、推測による補完なしで比較できます。
  • 単一レスポンスの完全保存上流の1回の検索レスポンスで返された、使用可能な広告主をすべて保存します。呼び出し側が指定する結果件数の上限や、プロバイダーのページネーションによる繰り返し取得は行いません。

Google Ad Library Advertiser Search API のパラメータ

パラメータ必須説明
query必須必須。空でない広告主名、ブランド名、組織名、またはウェブサイトの検索語です。一致の方法は取得元に依存し、完全一致・前方一致・あいまい一致のいずれも保証されません。
region任意任意。US などの空でない地域文字列で、地理的な検索条件として渡されます。広告主の広告が実際にどこで配信されたかを示すものではありません。

Google Ad Library Advertiser Search API の使い方

検索語を送信して非同期タスクを追跡し、正規化された各広告主候補を確認してから、その識別情報を以降の調査に使います。

  1. 具体的な広告主名、ブランド名、組織名、またはウェブサイトの語句を選び、必要に応じて US などの region を追加します。
  2. query と任意の region を /v1/google-ad-library/advertiser-search に POST し、task_id を保存します。
  3. タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、広告主IDを選ぶ前に、名前の類似性だけでなく複数の情報で候補を確認します。
curl -X POST "https://api.socq.ai/v1/google-ad-library/advertiser-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Nike","region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Review data.results.items as advertiser candidates

Google Ad Library Advertiser Search API の主なユースケース

  • ブランドから広告主IDを特定: 名前やウェブサイトの語句から候補リストを作成し、別途行う公開広告一覧のリクエストに使う広告主IDを選びます。
  • 地域別・法人別の区別: 似たレコードが複数あり、子会社、販売代理店、無関係の組織である可能性がある場合に、名前、地域、ウェブサイト、公開広告主ページを比較します。
  • 確認待ちリストの作成: 候補の識別情報と取得タイムスタンプを保存し、名前の類似性だけで所有関係を断定せずに手動で確認できるようにします。

Google Ad Library Advertiser Search API 活用のヒント

  • 具体的な正式名称、ブランド名、またはドメインに近い語句を使用してください。広い語句ではあいまいな候補が返ることがあり、一致ルールも保証されません。
  • region は検索条件として扱い、その広告主のすべての広告がその地域で配信された証拠とはみなさないでください。
  • レコードを統合したりクリエイティブを収集したりする前に、ID、名前、ウェブサイト、地域、公開広告主ページで候補を確認してください。
  • results_limit は送信しないでください。この処理は上流の1回のレスポンスで返された使用可能な広告主の配列を保存するもので、取得元のページネーションは行いません。

Google Ad Library Advertiser Search API 以外に別の種類の公開Google Ad Libraryデータが必要な場合は、これらのAPIをご利用ください。

  • Google Ad Library Ad API — Transparency Centerの既知の公開クリエイティブ1件をURLから取得し、広告主、広告文、メディア、配信、地域、フォーマット、遷移先、インプレッションの各フィールドを返します。
  • Google Ad Library Company Ads API — 企業ドメインまたは広告主IDから、Transparency Centerの公開クリエイティブを取得します。トピック、地域、日付、掲載面、フォーマット、取得件数上限を指定できます。

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

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

Google Ad Library Advertiser Search API — よくある質問

Google Ad Library Advertiser Search APIは、検索語と任意の地域から公開Google広告透明性センターの広告主候補を見つけるためのプログラムインターフェースです。広告クリエイティブではなく、正規化された広告主情報と、取得元に依存するウェブサイト、ロゴ、地域、広告数の各フィールドを返します。

返されるのは広告主候補のみです。公開クリエイティブを一覧取得するには、確認済みの広告主IDまたはドメインを別の company-ads 処理で使用してください。

region は広告主検索に渡される地理的な条件です。候補の絞り込みに役立つことはありますが、確実な完全一致フィルターではなく、広告の配信地域を示す証拠でもありません。

いいえ。結果は、取得時点で上流の1回の検索レスポンスが返した使用可能な広告主の配列すべてです。SocQによるページネーションの繰り返しや、呼び出し側が指定する件数上限はありません。

保存された広告主レコード1件につき0.5 SocQクレジットです。見積もりは100件を想定しており、超過も許容されます。成功して結果が0件だった場合は、設定されている基本料金0クレジットのみがかかります。