Facebook広告ライブラリAPIの使い方

「Facebook広告ライブラリAPI」と称するFacebook/Meta広告ライブラリAPIは、Facebook、Instagram、その他Meta所有のプラットフォーム（例：WhatsappやThreads）に掲載された広告へのアクセスを開発者に提供する、公開されているインターフェースです。このAPIを通じて、キーワード、ページID、国、または広告タイプで広告を検索し、広告クリエイティブ、費用範囲、インプレッション、パブリッシャープラットフォームなどのメタデータを取得できます。

このAPIは、透明性に関する研究、マーケティング監査、競合分析、広告クリエイティブ分析、またはソーシャルメディア広告データに関するツール構築に特に役立ちます。アクティブな広告を監視したい場合でも、政治広告や社会問題広告（SIEP広告）を研究したい場合でも、マーケティング戦略を分析したい場合でも、Facebook広告ライブラリAPIは広告データへの強力な扉を提供します。

💡

美しいAPIドキュメントを生成する優れたAPIテストツールをお探しですか？

最大限の生産性で開発チームが連携できる、統合されたオールインワンプラットフォームをお探しですか？

Apidogはあなたのすべての要求に応え、Postmanをはるかに手頃な価格で置き換えます！

ボタン

Facebook広告ライブラリAPIを使用する理由と、それができること

Facebook広告ライブラリAPIの主な機能の一部：

キーワード、ページID、国、広告タイプによる検索 — 広告の内容、掲載者、掲載場所、キャンペーンの種類によって広告を絞り込むことができます。
ステータスでフィルター：アクティブ/非アクティブ、費用範囲、インプレッション — 現在表示されている広告、または特定の費用しきい値を超える/下回る広告のみを対象としたい場合に役立ちます。
広告メタデータの取得 — page_name、ad_snapshot_url、spend、impressions、publisher_platforms（Facebook/Instagram）などのフィールドを含みます。
長期的かつ広範なデータカバレッジのサポート — 例えば、SIEP広告はグローバルに、一般広告は多くの地域で（2025年時点のMetaの地域ポリシーに従う）。
公開データへの無料アクセス — 適切なアクセス設定があれば、公開広告データの取得に初期費用はかかりません。

要するに、このAPIは、広告データを大規模に探索・収集するための、構造化されたプログラム可能な方法を提供します。

ステップバイステップガイド：Facebook広告ライブラリAPIの始め方

ステップ1：Facebook/Metaアカウントと本人確認を行う

Facebookアカウント（個人用またはビジネス用）にログインまたは作成します。
アカウントが認証されていることを確認してください（MetaはAPIアクセスに本人確認を要求する場合があります）。(アカウント認証)
このステップは、アプリを介して広告ライブラリデータへのアクセスを要求する予定がある場合に特に重要です。

ステップ2：Meta開発者アプリを登録する

Meta for Developersにアクセスし、「スタート」をクリックしてプラットフォームにログインします。(リンクはこちら)

新しいアプリを作成：「広告」ではない場合は「その他」または一般的なタイプを選択します。

マーケティングAPI / 広告ライブラリへのアクセスが必要であることを選択します。

最初、アプリは開発モードになります。これは基本的なテストと小規模な利用には十分です。

ステップ3：アクセストークンを生成する

Graph API ExplorerまたはMetaのツールを使用して、ユーザーアクセストークンを生成します。
トークンが必要な権限（例：ads_read、Metaの要件によってはads_archiveなど）を持っていることを確認します。(Facebook for Developers)

注：アクセストークンは期限切れになります。使用状況に応じて、トークンを延長したり、有効期間の長いトークンを生成したりする必要がある場合があります。

ステップ4：最初のAPI呼び出しを行う

/ads_archiveエンドポイント（広告ライブラリAPIのルート）をクエリできます。最新のAPIバージョン（例：v23.0以降）を使用してください。(Facebook for Developers)

例：curlを使用する場合

curl -G \
  -d "search_terms=skincare" \
  -d "ad_reached_countries=['US']" \
  -d "ad_active_status=ACTIVE" \
  -d "fields=page_name,ad_snapshot_url,spend,impressions,publisher_platforms" \
  -d "access_token=YOUR_ACCESS_TOKEN" \
  "https://graph.facebook.com/v23.0/ads_archive"

例：JavaScript (fetch)を使用する場合

const response = await fetch(
  `https://graph.facebook.com/v23.0/ads_archive?` +
  `search_terms=skincare&ad_reached_countries=['US']&ad_active_status=ACTIVE` +
  `&fields=page_name,spend,impressions,publisher_platforms` +
  `&access_token=YOUR_ACCESS_TOKEN`
);
const data = await response.json();
console.log(data);

JSONレスポンスには、page_name、ad_snapshot_url、費用範囲、インプレッション範囲、パブリッシャープラットフォームなどのメタデータを含む広告オブジェクトの配列が含まれます。さらに多くのフィールドが含まれる場合もあります。

ステップ5：ページネーションと大量の結果の処理

広告ライブラリは多くの結果を返す可能性があるため、APIはページネーションを使用します。後続のページをループで処理する準備をし、レスポンスでpagingまたはカーソルトークンを確認して、それに応じて反復処理を行ってください。開発者は、大量の結果セットを集約するためにコード内でループを構築することがよくあります。

ステップ6：ユースケース — このデータで何ができるか？

一般的なユースケースを以下に示します。

競合分析 — 競合他社のFacebookページ（ページID経由）から広告を取得し、クリエイティブ、費用見積もり、またはターゲティングリーチを調査します。
トレンド監視と研究 — キーワード、地域、メディアタイプ、または広告タイプ（例：政治、住宅、社会問題）によって、どのような広告がアクティブであるかを追跡します。
マーケティングインテリジェンスダッシュボード — データ（費用範囲、インプレッション、広告頻度）を集計し、時間経過や地域全体で可視化します。
広告クリエイティブ分析/インスピレーション — 製品のインスピレーションやコンプライアンス監査のために、広告クリエイティブ（画像/動画URL）を取得してアーカイブします。
学術/透明性に関する研究 — 政治広告、社会問題キャンペーン、または市場トレンドに関する研究に広告データを使用します。

これらのユースケースは、構造化されたプログラム可能な方法で広告データにアクセスすることの価値を強調しています。

ApidogでFacebook広告ライブラリAPIをテストする

Facebook広告ライブラリAPIのテスト環境としてApidogを使用しましょう。ApidogでAPIのテストを開始する方法は以下の通りです。

1. Apidogで新しいAPIエンドポイントを作成します：メソッドをGETに、URLをhttps://graph.facebook.com/v23.0/ads_archiveに設定します。

2. クエリパラメータの下に、search_terms、ad_reached_countries、fields、access_tokenなどのパラメータを追加します。

3. 「送信」をクリックすると、Apidogがデータをフェッチし、JSONレスポンスを構造化された形式で表示します。

4. 複数のパラメータの組み合わせを試したり、ページネーションをテストしたり、ドキュメントや分析のために応答例を保存したりすることができます。

このアプローチは、広告データの迅速な探索、検索クエリのテスト、および完全なコードを書かずに統合を構築する場合に特に役立ちます。

ボタン

よくある質問

Q1. Facebook広告ライブラリAPIを使用するために特別な広告アカウントやビジネスアカウントが必要ですか？
いいえ、通常は認証済みのMetaアカウントで十分です。ただし、Meta開発者アプリを登録し、適切な権限（例：ads_read、ads_archive）を持つアクセストークンを取得する必要があります。一部のユーザーは、完全なアクセスを得るために本人確認を完了する必要があります。

Q2. 政治広告や社会問題広告だけでなく、あらゆる広告のデータを取得できますか？
はい、APIは一般広告（SIEPだけでなく）をサポートしています。地域や広告の利用可能性に応じて、ad_type=allを使用するか、フィルタを省略することができます。

Q3. 1回のリクエストでいくつの広告を取得できますか？
デフォルトでは、APIはリクエストごとに限られた数の広告（ページネーション）を返します。さらに取得するには、レスポンスで提供されるページングカーソルを使用してページを反復処理する必要があります。

Q4. API経由で広告クリエイティブ（画像、動画）にアクセスできますか？
広告クリエイティブのプレビューにリンクするad_snapshot_urlまたは同様のフィールドを取得できます。ただし、Metaは常に直接メディアファイルを提供するわけではないため、実際の画像や動画を取得するには追加の手順が必要になる場合があります。

Q5. データ取得を自動化し、トークンの有効期限切れの問題を回避する方法はありますか？
はい、Meta開発者ツールで有効期間の長いトークンを生成するか、トークンを定期的に更新するバックエンドシステムをセットアップできます。大規模なデータ取得の場合、トークン管理とページネーションループを組み合わせるのが一般的です。トークンは常に安全に保管してください。

結論

Facebook（Meta）広告ライブラリAPIは、広告データへの強力で構造化されたゲートウェイを提供し、開発者、マーケター、研究者、アナリストがMetaのプラットフォーム全体で広告キャンペーンをプログラム的に検索、収集、分析できるようにします。これを使用することで、ダッシュボードを構築したり、競合分析を実行したり、透明性に関する研究を行ったり、大規模に広告クリエイティブを集約したりすることができます。

Meta開発者アプリをセットアップし、適切なアクセストークンを取得し、/ads_archiveエンドポイントにリクエストを行うことで（Apidogのようなツールを介してテストすることも可能）、豊富な広告ライブラリデータを活用できます。制限（権限、レート制限、ページネーション、メディア取得）はありますが、その利点は労力を上回ることがよくあります。

Facebook/Metaから公開広告データが必要な人にとって、広告ライブラリAPIは貴重で公式かつ柔軟な選択肢です。

💡

ボタン