API一覧に戻る
独立系のFacebook広告ライブラリデータ

Facebook Ad Library API

キーワードによる公開Facebook広告の検索、広告主ページの検索、ページIDごとの広告の取得、既知の広告1件の取得ができます。クリエイティブ、メディア、配信、CTA、リンク先のフィールドは正規化されています。

利用できるFacebook Ad Library API

キーワードによる広告の検索にはSearch、ページIDの検索にはCompany Search、そのページの広告の取得にはCompany Ads、既知の公開広告1件の取得にはAd Detailsを使用します。

取得できるFacebook広告ライブラリのデータ

SocQは正規化された公開広告と広告主のレコードを返し、クリエイティブの調査、競合のモニタリング、キャンペーン分析、広告データセットに活用できるようにします。

広告の検索結果

キーワードまたは完全一致のフレーズで公開広告を検索できます。国、ステータス、メディア、広告の種類、日付、並び順、取得件数上限のフィルターを任意で指定できます。

広告主ページのレコード

ページID、名称、URL、カテゴリ、国、画像、認証の値、表示中のページのいいね数、リンクされたInstagramのコンテキストを取得します。

ページごとの広告コレクション

数値の広告主ページID 1件について、重複のない公開広告を上限付きで取得します。配信状況とメディアのフィルターを任意で指定できます。

クリエイティブのテキストとメディア

取得可能な広告タイトル、本文、リンクの説明、表示フォーマット、重複を除いた公開画像や動画の参照を取得します。

配信と市場のコンテキスト

取得可能な開始・終了日時、配信中のステータス、掲載プラットフォーム、国、リーチ、通貨、費用、ページのいいねのシグナルを保持します。

CTAとリンク先

公開されている場合、表示中のCTAのテキストと種類、公開リンク先URL、広告ライブラリのURL、広告主の情報、取得日時を取得します。

SocQ vs Meta Ad Library API

SocQは、すぐに使える公開広告の取得ワークフローを提供します。Metaの広告透明性アーカイブに直接アクセスする場合は、MetaのAd Library APIが公式の選択肢です。

機能SocQMeta Ad Library API
主な用途公開広告の検索と、広告主や広告の詳細の取得Metaの公式広告透明性アーカイブへのクエリ
認証SocQのAPIキーのみ。顧客のFacebook OAuthは不要Metaアプリ、アクセストークン、Ad Libraryへのアクセス権
入力の起点キーワード、企業名、ページID、公開広告ライブラリのURL公式アーカイブのクエリパラメータとMetaの識別子
広告の作成・管理非対応非対応。Meta Marketing APIを使用
レスポンス形式正規化されたSocQレコードMeta Graph API独自のオブジェクト

Facebook Ad Library APIの仕組み

4つのAPIはすべて、共通の非同期タスクとページネーション付きの結果取得ワークフローを使用します。

  1. 1. APIと入力を選ぶ

    必要なレコードに応じて、キーワード、企業名、数値のページID、または公開 /ads/library のURLから始めます。

  2. 2. タスクを送信して追跡

    対応するPOSTリクエストを送信し、返された task_id を保存して、処理が終わるまで /v1/tasks/{task_id} をポーリングします。

  3. 3. 正規化された結果を読み取る

    data.results.items を処理し、has_more が true の間は next_cursor をたどります。

キーワードで公開広告を検索

SocQのAPIキーで認証し、Searchエンドポイントにキーワードを送信します。ほかのAd Library APIも同じタスクフローで利用できます。

curl -X POST "https://api.socq.ai/v1/facebook-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"running shoes","results_limit":100,"status":"ACTIVE"}'

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

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

競合広告のモニタリング

選んだ広告主ページの公開広告を追跡し、クリエイティブ、メディア、配信ステータス、市場、CTA、リンク先の変化を比較します。

クリエイティブとメッセージの調査

商品、カテゴリ、ブランドの用語で検索し、公開されている広告コピー、フォーマット、メディア、CTA、ランディングページのリンク先を確認します。

広告主の発掘

企業名やブランド名を公開ページIDとアカウント情報のフィールドに解決し、そのページに絞った広告セットを取得します。

広告データセット

正規化された広告ID、広告主のレコード、クリエイティブのフィールド、配信のコンテキスト、取得元URL、collected_at のタイムスタンプを保存し、分析に活用します。

制限事項と公開データポリシー

Facebook広告ライブラリの結果は、特定時点の公開レコードです。これらのAPIは広告アカウントの管理や、非公開のキャンペーン成果データの提供は行いません。

  • Searchには空でないクエリが1つ必要です。results_limit のデフォルトは100で、20〜2,000の整数を指定できます。
  • Company Searchは企業名またはページ名のクエリを1つ受け付け、results_limit は受け付けません。似た名前のページ候補が複数返る場合があります。
  • Company Adsには数値のページIDが1つ必要です。results_limit は20〜2,000を指定でき、フィルターによって返されるレコード数が減る場合があります。
  • Ad Detailsは、数値の id を含む公開 facebook.com/ads/library のURLを1つ受け付け、正規化された広告レコードを最大1件返します。
  • 広告、ページ、またはフィルター後の結果セットが公開ソースで利用できない場合、完了したタスクでもレコードが返らないことがあります。
  • リーチ、費用、通貨、メディア、日付、CTA、リンク先、広告主のフィールドは欠ける場合があり、0と解釈しないでください。

Facebook Ad Library APIに関するよくある質問

Facebook Ad Library APIとは何ですか?

Facebook Ad Library APIは、公開広告の検索、広告主ページの検索、ページごとの広告の取得、既知の公開広告の詳細取得ができるSocQのエンドポイント群です。

どのFacebook Ad Library APIを使えばよいですか?

キーワードによる検索にはSearch、ページIDの検索にはCompany Search、そのIDの広告の取得にはCompany Ads、既知の公開広告ライブラリのURL 1件にはAd Detailsを使用してください。

どのような検索やフィルターができますか?

Searchは、キーワードまたは完全一致のフレーズに加え、国、ステータス、メディア、広告の種類、日付、並び順、取得件数上限のフィルターを任意で受け付けます。Company Adsは、ページごとの配信状況とメディアのフィルターに対応しています。

どのような公開広告データが返されますか?

結果には、広告と広告主の情報、クリエイティブのテキスト、画像や動画、配信日、配信中のステータス、掲載プラットフォーム、国、CTA、リンク先、表示中の公開シグナルが含まれる場合があります。

完了したリクエストで結果が返らないのはなぜですか?

公開ソースに送信した入力と一致するものがない、フィルターによってすべてのレコードが除外された、または指定した広告やページがすでに公開されていない、といった理由が考えられます。

FacebookのソーシャルデータAPIやMarketplace APIと同じものですか?

いいえ。Facebook Ad Libraryのエンドポイントは、SocQのFacebookページ・投稿・コメントのAPIや、Facebook Marketplaceの出品APIとは別のものです。

Facebook Ad Libraryの結果の料金はどのように計算されますか?

Searchの広告、Company Searchの候補、Company Adsのレコードは、返された結果1件あたり0.5クレジットです。Ad Detailsは返された結果1件あたり0.6クレジットで、結果が空の場合、結果に対する料金は発生しません。

さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。

X API

公開プロフィール、フォロワー・フォロー中の関係、ポスト、返信、引用、リツイートしたユーザー、検索結果、現在のトレンドを取得できます。一貫した形式の結果を調査やモニタリングに活用できます。

LinkedIn API

既知のURLから、公開LinkedInのプロフィール、企業、投稿、求人のデータを取得できます。アカウント情報、職歴、企業、コンテンツ、エンゲージメント、求人のフィールドは正規化されています。

Reddit API

既知のURLから公開Redditの投稿とコメントを取得したり、サブレディットの新着・トップ・人気の投稿を閲覧したり、キーワードと公開期間で議論を検索したりできます。

Pinterest API

公開Pinterestプロフィールのデータ取得、既知のピンの解決、指定したプロフィールのピンの取得、キーワード検索ができ、クリエイター、コンテンツ、ビジュアルトレンドの調査に活用できます。

Threads API

公開Threadsプロフィールの取得、既知の投稿の解決、指定したプロフィールの投稿の取得ができます。アカウント情報、コンテンツ、メディア、エンゲージメント、タイムスタンプのフィールドは正規化されています。

Bluesky API

公開Blueskyプロフィールの取得、既知の投稿URLの解決、アカウントの投稿の1ページ分の取得ができます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントのフィールドは正規化されています。