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が公式の選択肢です。
| 機能 | SocQ | Meta 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. APIと入力を選ぶ
必要なレコードに応じて、キーワード、企業名、数値のページID、または公開 /ads/library のURLから始めます。
2. タスクを送信して追跡
対応するPOSTリクエストを送信し、返された task_id を保存して、処理が終わるまで /v1/tasks/{task_id} をポーリングします。
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 trueFacebook 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ページ分の取得ができます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントのフィールドは正規化されています。



