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つ用意します。
- query を /v1/facebook-ad-library/company-search に POST し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
- 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 trueFacebook 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の情報、フォロワー数、認証の値、画像、削除済みページかどうかの状態は任意の指標として扱い、フィールドがなくても候補を除外せずに処理してください。
関連API
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、表示中のシグナルの各フィールドを返します。