facebook-ad-library/
company-ads

広告主のページIDを1つ指定してFacebook広告ライブラリの公開広告を取得し、クリエイティブのテキスト、メディア、ページ情報、配信の詳細、表示中の指標を正規化されたレコードとして返します。

Facebook Ad Library Company Ads API

広告主のページIDで指定
クリエイティブと配信の情報
公開広告レコード
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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つと任意のフィルターを送信し、非同期タスクを追跡して、正規化された広告レコードをカーソルページネーションで読み取ります。

  1. 数値の広告主ページIDを取得し、必要に応じて国、ステータス、メディア、言語、並び順、期間のフィルターを選びます。
  2. page_id と選択したフィルターを /v1/facebook-ad-library/company-ads に送信し、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-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 true

Facebook 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 のフィールドはパフォーマンスの評価ではなくグループ化に使用してください。

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、表示中のシグナルの各フィールドを返します。

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

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

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

Facebook Ad Library Company Ads APIは、数値の広告主ページID 1つについて公開広告を取得するAPIです。正規化されたクリエイティブ、メディア、広告主、配信、市場、CTA、表示中の指標、取得日時のフィールドを返します。

Facebook Ad Library Company Searchで会社名やブランド名を検索し、返された候補から正しい数値のページIDを選んでから、Company Adsに送信してください。

国、配信ステータス、メディアの種類、2文字の言語コード、開始日と終了日で絞り込めるほか、対応する2つの並び順から1つを選択できます。results_limit で保存する重複のない広告の最大件数を指定します。

選択したページに、国、ステータス、メディア、言語、期間のフィルターに一致する公開広告がない場合や、それ以上のソースページがない場合があります。成功して結果が空の場合でも、プレースホルダーの広告は作成されません。

返された広告レコード1件につき0.5 SocQクレジットです。結果が空の場合は結果の料金はかかりません。