本文へスキップ

Meta 広告ライブラリ API: Facebook と Instagram の広告を JSON で

キーワードや広告主で Meta 広告ライブラリを検索し、Facebook、Instagram、Messenger、WhatsApp、Threads に掲載中の広告を 1 つの非同期 API から JSON で受け取ります。広告ごとに本文、画像と動画、ランディングページ、行動を促すボタン、掲載開始日、掲載プラットフォームが含まれます。

2026年11月20日 に実行した Meta 広告ライブラリの検索を、返ってきた広告で描いています。

広告主が Meta に出している広告をすべて

taskType ADS に payload.platform meta_ad_library を送り、pageId に広告主の Facebook ページ ID を、または query にキーワードを入れます。広告ごとにライブラリ ID、掲載開始日、掲載プラットフォーム、同じクリエイティブを使う広告の数、本文、画像または動画、ランディングページ、行動を促すボタンが返り、条件に合う広告の総数も届きます。結果は Webhook またはポーリングで受け取ります。

Active
Library ID: 2033461067351971
Started running on Nov 14, 2026
Platforms
This ad has multiple versions
5 ads use this creative and text
See summary details
soundcoreSponsored
🎧Anker soundcore AeroClip 2 — the world's clearest open-ear clip-on earbuds. Now $143.99 + free earrings.
libraryId2033461067351971
Meta 広告ライブラリでの広告 ID です。libraryUrl でライブラリのページを開けます。
startDateisActive2026-11-14 · true
広告の配信開始日と、現在配信中かどうかです。
platformsFACEBOOK, INSTAGRAM
広告を表示する Meta のアプリです。
versionsformat5 · DCO
同じクリエイティブとテキストを使う広告の数です。DCO は Meta がカードを組み合わせて作る広告です。
pageNamepageLikeCountsoundcore · 147919
広告主のページと「いいね!」の数です。pageId でその広告主の他の広告を検索できます。
body🎧Anker soundcore AeroClip 2 — the world's clearest open-ear clip-on earbuds. Now $143.99 + free earrings.
画像の上に表示される広告テキストです。
cards2
カードごとの画像または動画、テキスト、リンクです。ライブラリには最初のカードが表示されます。
titlectaTextlinkUrlAeroClip 2 Open-Ear · Shop now
画像の下のリンク欄のタイトル、説明、ボタン、linkUrl です。
2026年11月20日 に ADS で soundcore のページの米国の広告を検索し、最初に返った広告をライブラリのカードとして描いています。
ステップ 1

キーワードや広告主で検索

query は広告の本文に含まれる語を順序を問わず探し、searchType keyword_exact_phrase を指定すると完全一致のフレーズで探します。pageId は 1 つの広告主の広告を集めます。country で広告が掲載された国を選び、ALL ですべての国を検索し、limit で 1 回に最大 500 件を受け取ります。レスポンスの nextCursor を cursor として送ると、続きの広告を受け取ります。

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "pageId": "266556540473351",
    "country": "US",
    "limit": 500
  }
}
  1. limit: 500広告 1〜500 件目38.1s
  2. cursor: "eyJ2IjoxLCJoIj…"広告 501〜855 件目28.7s

2 回のレスポンスで広告 855 件、すべて 1 回ずつtotalCount: 855

2026年11月20日 に soundcore のページの米国の広告を ADS で 2 回検索しました。2 回目は 1 回目の nextCursor を cursor として送っています。
ステップ 2

広告主の名前からページ ID を探す

action advertisers は、名前が query と一致する Facebook ページを広告ライブラリの検索ボックスが提案する順に返し、ページごとに pageId、カテゴリ、いいね数、認証バッジ、Instagram アカウントを含みます。選んだ pageId を送ると、その広告主の広告を受け取ります。

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "action": "advertisers",
    "query": "soundcore",
    "country": "US"
  }
}
USsoundcore
"soundcore"Search this exact phrase
Advertisers
soundcore@soundcoreaudio · 148K follow this · Electronics@soundcoreaudio · 154K followers266556540473351
AnkerSoundcoreuk@ankersoundcoreUK · 1.8K follow this · Information Technology Company328639343660125
Anker soundcore Polska@AnkersoundcorePL · 1.4K follow this · Electronics@anker_soundcore_polska · 2.9K followers613865685153030
soundcore Deutschland1.2K follow this · Music & Audio@soundcore_de · 17.8K followers265641373306592
2026年11月20日 に米国で「soundcore」を指定して実行した advertisers アクションです。返ったページ 15 件のうち最初の 4 件を、ライブラリの検索ボックスが候補に出す順に pageId とともに描いています。
ステップ 3

ステータス、形式、プラットフォーム、期間で絞り込む

activeStatus で掲載中、終了、すべての広告を選び、mediaType で画像、動画、ミームの広告を、publisherPlatforms で Facebook、Instagram、Audience Network、Messenger、WhatsApp、Threads の広告を選びます。contentLanguages と startDate、endDate で言語と掲載期間を絞り込み、sortBy でインプレッションの多い順または新しい順に並べます。

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "pageId": "266556540473351",
    "country": "US",
    "mediaType": "video",
    "publisherPlatforms": [
      "instagram"
    ],
    "startDate": "2026-11-01"
  }
}
activeStatus
  • all903
  • active856
  • inactive47
mediaType
  • meme761
  • video98
  • image0
publisherPlatforms
  • facebook856
  • instagram856
  • threads340
  • audience_network202
  • whatsapp176
  • messenger0

このリクエスト98

2026年11月20日 に soundcore のページの米国の広告にフィルターを 1 つずつかけたときのライブラリの件数です。mediaType と publisherPlatforms は配信中の広告を数えています。

AI が推薦する製品と、その広告主

ショッピングの質問を回答エンジンに送り、推薦された製品を名前のまま Meta 広告ライブラリで検索すると、どのブランドが AI の推薦製品に広告を出し、ほかにどの広告主がその名前で広告を出しているかを確かめられます。

ChatGPT のおすすめ · “What are the best wireless earbuds under $200?”製品名を含む Meta の配信中広告(米国)
  1. Soundcore Liberty 5 Pro211 件広告主 2 社soundcore210
  2. Apple AirPods Pro 3464 件広告主 90 社Cosmopolitan63James Martin Jewelers55BILL27
  3. Technics EAH-AZ800 件
  4. Nothing Ear (3)1 件広告主 1 社
  5. Sony WF-1000XM51 件広告主 1 社
ChatGPT が 2026年11月19日 に推奨した製品です。2026年11月20日 に ADS で米国の配信中広告を製品名どおりに検索しました。バーは検索ごとに返った広告の数で、広告主のうちブランドは名前を記しています。

広告 30 件ごとに 0.5 クレジット

検索は受け取った広告 30 件ごとに 0.5 クレジットで、最低 0.5 クレジットです。既定のリクエスト(広告 30 件)は 0.5 クレジット、広告 500 件の検索は最大 8.5 クレジットです。広告主の検索は 0.5 クレジットです。課金は完了したリクエストにのみ適用されます。

料金を見る →
プラン別リクエスト料金
プラン1,000 回
Basic≈ $1.25
Max≈ $0.50

月間クレジットをすべて使った場合の換算料金です。

関連機能

無料クレジット500で始める

Playgroundで最初のタスクを実行するか、APIキーですぐに呼び出せます。