facebook-ad-library/
company-search

会社名やページ名でFacebook広告ライブラリの公開広告主ページを検索し、ページID、カテゴリ、画像、Instagramのオーディエンス指標を正規化されたレコードで返します。

Facebook Ad Library Company Search API

会社名・ページ名で検索
広告主ページの候補
ページとInstagramの指標
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Facebook Ad Library Company Search

Facebook広告ライブラリの広告主候補は、ページID、名前、カテゴリ、国、画像、認証の値、連携しているInstagramの情報で識別される広告主のFacebookページです。これらの識別情報とオーディエンス指標は、広告を調査する前の広告主の特定、同名ページの比較、確認しやすいページ選定に活用できます。

Facebook Ad Library Company Search API の主な機能

  • 会社名・ページ名での検索空でない会社名、ブランド名、ページ名のクエリを1つ送信すると、その検索で返されたすべての広告主ページ候補を受け取れます。
  • ページ情報と分類公開されている場合、ページID、名前、導出された公開URL、カテゴリ、国、エンティティの種類、認証の値、画像、削除済みページかどうかの状態を返します。
  • 表示中のページとInstagramの指標取得可能なFacebookのいいね数に加え、連携しているInstagramのユーザー名、フォロワー数、認証状態を正規化された候補レコードに保持します。

Facebook Ad Library Company Search API のパラメータ

パラメータ必須説明
query必須必須。広告主ページの候補を探すための、空でない会社名、ブランド名、または公開ページ名です。

Facebook Ad Library Company Search API の使い方

会社名またはページ名のクエリを1つ送信し、非同期タスクを追跡して、正規化された広告主ページ候補を確認します。

  1. 空でない会社名、ブランド名、または公開ページ名のクエリを1つ用意します。
  2. query を /v1/facebook-ad-library/company-search に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間は next_cursor を指定して続きを取得します。
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/company-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Example Sports"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Facebook Ad Library Company Search API の主なユースケース

  • 広告主ページIDの特定: 候補のページID、名前、URL、カテゴリ、国を使って、ページ単位のCompany Adsリクエストに必要なIDを選びます。
  • 同名ページ・地域別ページの比較: 似た広告主名の間で、カテゴリ、国、エンティティの種類、画像、認証の値、連携しているInstagramの情報を比較します。
  • 確認しやすい広告主の選択機能: ページ情報、表示中のオーディエンス指標、元のクエリ、取得日時を保存し、広告主の選択UIや調査用インデックスの裏側で活用します。

Facebook Ad Library Company Search API 活用のヒント

  • query のみを送信してください。Company Searchは results_limit や、広告のステータス、国、メディア、期間のフィルターを受け付けません。
  • よく知られた名前を持つ候補が複数ある場合は、最初の結果を選ぶのではなく、ページID、URL、カテゴリ、国、画像、認証、連携しているInstagramの情報を比較してください。
  • タスク結果のページネーションで保存済みの広告主候補を見落とさないよう、has_more が false になるまで next_cursor をたどってください。
  • Instagramの情報、フォロワー数、認証の値、画像、削除済みページかどうかの状態は任意の指標として扱い、フィールドがなくても候補を除外せずに処理してください。

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

  • Facebook Ad Library Search API — キーワードで公開広告を検索します。一致方法、広告、国、ステータス、メディア、並び順、日付、取得件数上限を指定できます。
  • Facebook Ad Library Company Ads API — 広告主のページID 1件について公開広告を取得し、クリエイティブ、配信、市場、メディア、CTA、表示中のシグナルの各フィールドを返します。
  • Facebook Ad Library Ad API — 広告ライブラリの公開広告1件をURLから取得し、クリエイティブ、広告主、メディア、配信、CTA、表示中のシグナルの各フィールドを返します。

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

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

Facebook Ad Library Company Search API — よくある質問

Facebook Ad Library Company Search APIは、空でない会社名またはページ名のクエリから、公開されている広告主ページの候補を検索するAPIです。ページID、識別情報と分類のフィールド、画像、表示中のオーディエンス指標、連携しているInstagramの情報を返します。

このエンドポイントは、必須の空でない query 文字列を1つ受け付けます。results_limit や、広告の国、ステータス、メディア、言語、並び順、期間のフィルターは受け付けません。

返しません。返すのは広告主ページの候補と、Company Adsで使用する数値のページIDであり、広告のクリエイティブや配信のレコードではありません。

ページID、名前、URL、カテゴリ、国、エンティティの種類、画像、認証の値、連携しているInstagramの情報を比較してください。よく知られた名前であるというだけでは、その候補が目的の広告主であるとは判断できません。

広告主の検索は results_limit を受け付けず、クエリに対して返された重複のないページIDをすべて保存します。ただし、完了したタスクでは next_cursor と has_more を使って保存済みのレコードをページ送りできます。

items 配列が空の場合、そのクエリでは公開ページの候補が返されなかったことを意味します。名称の違いや公開ソースの状況によって結果が空になることもあるため、その会社に広告がないことの証明にはなりません。

返された広告主候補1件につき0.5 SocQクレジットです。リクエストの見積もりには10件の候補が使われ、現在の料金設定では結果が空の場合は結果の料金はかかりません。