Facebook Ad Library Company Ads
Facebook広告ライブラリの広告主別広告は、クリエイティブのテキスト、メディア、ページ情報、配信日、配信中かどうかの状態、掲載プラットフォーム、国の情報、表示中の指標を含む公開の広告主レコードです。これらのレコードは、広告主のモニタリング、クリエイティブの比較、市場別の確認、取得時点に基づくレポートに活用できます。
Facebook Ad Library Company Ads API の主な機能
- 広告主のページ単位での取得数値の広告主ページIDを1つ指定することで、キーワード検索ではなく、選択した公開ページに紐づく広告だけを返します。
- 市場と配信のフィルターレコードを保存する前に、国、配信ステータス、メディアの種類、言語、期間、対応する並び順で取得対象を絞り込みます。
- クリエイティブ・メディア・リンク先のフィールド各広告について、取得可能なタイトル、本文、画像や動画、CTAの値、公開リンク先URL、表示形式を返します。
- 広告主と配信の情報公開されている場合、ページ情報、ページのいいね数、配信日、配信中かどうかの状態、掲載プラットフォーム、国、リーチ、通貨、広告費を保持します。
- 上限付きの重複のない広告レコード取得可能なソースページをたどり、重複するアーカイブIDやURLを除外して、results_limit または最後のページに達した時点で停止します。
Facebook Ad Library Company Ads API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
page_id | 必須 | 必須。数値のFacebook広告ライブラリ広告主ページIDです。ページIDがわからない場合は、先にCompany Searchを使用してください。1つのタスクで指定できるページIDは1つです。 |
results_limit | 任意 | 保存する重複のない広告の最大件数です。デフォルトは100で、20〜2,000の整数を指定できます。 |
country | 任意 | ALL または2文字の国コードを1つ指定します。デフォルトは ALL です。 |
status | 任意 | 広告の配信ステータスのフィルターです。ALL、ACTIVE、INACTIVE のいずれかを正確に指定してください。デフォルトは ACTIVE です。 |
media_type | 任意 | クリエイティブのメディアのフィルターです。ALL、IMAGE、VIDEO、MEME、IMAGE_AND_MEME、NONE のいずれかを正確に指定してください。デフォルトは ALL です。 |
language | 任意 | 任意。2文字の広告言語コードです。 |
sort_by | 任意 | 返される広告の並び順で、total_impressions または relevancy_monthly_grouped を指定します。デフォルトは total_impressions です。 |
start_date | 任意 | 任意。YYYY-MM-DD 形式の開始日です。end_date より後の日付は指定できません。 |
end_date | 任意 | 任意。YYYY-MM-DD 形式の終了日です。start_date より前の日付は指定できません。 |
Facebook Ad Library Company Ads API の使い方
広告主のページIDを1つと任意のフィルターを送信し、非同期タスクを追跡して、正規化された広告レコードをカーソルページネーションで読み取ります。
- 数値の広告主ページIDを取得し、必要に応じて国、ステータス、メディア、言語、並び順、期間のフィルターを選びます。
- page_id と選択したフィルターを /v1/facebook-ad-library/company-ads に送信し、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-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"page_id":"51212153078","results_limit":100,"country":"US","status":"ACTIVE","media_type":"ALL"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueFacebook Ad Library Company Ads API の主なユースケース
- 広告主の広告モニタリング: 既知の広告主ページについて、アーカイブID、クリエイティブのテキスト、メディア、配信中かどうかの状態、配信日、ソースURL、collected_at を追跡します。
- クリエイティブと形式の比較: ページから返された広告間で、テキスト、画像や動画、表示形式、CTA、リンク先、グループ化(collation)の情報を比較します。
- 市場で絞り込んだ広告の確認: 国、言語、ステータス、メディア、期間のフィルターを実行し、特定の市場や配信に関する問いごとに別々の広告セットを作成します。
- 公開指標のスナップショットレポート: 公開されている場合、ページ情報、ページのいいね数、リーチ、広告費、通貨、配信状態、collected_at を組み合わせてレポートします。
Facebook Ad Library Company Ads API 活用のヒント
- 最初は country を ALL にし、メディアと期間のフィルターも広めに設定したうえで、条件を1つずつ絞り込んでください。そうすることで、結果が空だった場合の原因を正しく判断できます。
- ページIDとフィルターの組み合わせを検証している間は最小値の20を results_limit に使用し、返される範囲がタスクの目的に合っていることを確認してから増やしてください。
- 1回のCompany Adsリクエストで指定できるページIDは1つのため、複数の広告主ページIDを持つブランドについては別々のタスクを送信してください。
- 繰り返し実行した結果は広告 id で重複を除外し、欠けているリーチ、広告費、メディア、日付は0ではなく取得不可として扱ってください。collation のフィールドはパフォーマンスの評価ではなくグループ化に使用してください。
関連API
Facebook Ad Library Company Ads API 以外に別の種類の公開Facebook Ad Libraryデータが必要な場合は、これらのAPIをご利用ください。
- Facebook Ad Library Search API — キーワードで公開広告を検索します。一致方法、広告、国、ステータス、メディア、並び順、日付、取得件数上限を指定できます。
- Facebook Ad Library Company Search API — 企業名またはページ名から広告主ページの候補を検索し、ページID、分類、画像、表示中のオーディエンス、連携するInstagramのシグナルを返します。
- Facebook Ad Library Ad API — 広告ライブラリの公開広告1件をURLから取得し、クリエイティブ、広告主、メディア、配信、CTA、表示中のシグナルの各フィールドを返します。