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 またはポーリングで受け取ります。
soundcoreSponsored
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 です。
キーワードや広告主で検索
query は広告の本文に含まれる語を順序を問わず探し、searchType keyword_exact_phrase を指定すると完全一致のフレーズで探します。pageId は 1 つの広告主の広告を集めます。country で広告が掲載された国を選び、ALL ですべての国を検索し、limit で 1 回に最大 500 件を受け取ります。レスポンスの nextCursor を cursor として送ると、続きの広告を受け取ります。
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"pageId": "266556540473351",
"country": "US",
"limit": 500
}
}limit: 500広告 1〜500 件目38.1scursor: "eyJ2IjoxLCJoIj…"広告 501〜855 件目28.7s
2 回のレスポンスで広告 855 件、すべて 1 回ずつtotalCount: 855
広告主の名前からページ ID を探す
action advertisers は、名前が query と一致する Facebook ページを広告ライブラリの検索ボックスが提案する順に返し、ページごとに pageId、カテゴリ、いいね数、認証バッジ、Instagram アカウントを含みます。選んだ pageId を送ると、その広告主の広告を受け取ります。
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"action": "advertisers",
"query": "soundcore",
"country": "US"
}
}
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ステータス、形式、プラットフォーム、期間で絞り込む
activeStatus で掲載中、終了、すべての広告を選び、mediaType で画像、動画、ミームの広告を、publisherPlatforms で Facebook、Instagram、Audience Network、Messenger、WhatsApp、Threads の広告を選びます。contentLanguages と startDate、endDate で言語と掲載期間を絞り込み、sortBy でインプレッションの多い順または新しい順に並べます。
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"pageId": "266556540473351",
"country": "US",
"mediaType": "video",
"publisherPlatforms": [
"instagram"
],
"startDate": "2026-11-01"
}
}activeStatusall903active856inactive47
mediaTypememe761video98image0
publisherPlatformsfacebook856instagram856threads340audience_network202whatsapp176messenger0
このリクエスト98
AI が推薦する製品と、その広告主
ショッピングの質問を回答エンジンに送り、推薦された製品を名前のまま Meta 広告ライブラリで検索すると、どのブランドが AI の推薦製品に広告を出し、ほかにどの広告主がその名前で広告を出しているかを確かめられます。
Soundcore Liberty 5 Pro211 件広告主 2 社
soundcore210
Apple AirPods Pro 3464 件広告主 90 社
Cosmopolitan63
James Martin Jewelers55
BILL27
Technics EAH-AZ800 件
Nothing Ear (3)1 件広告主 1 社
Sony WF-1000XM51 件広告主 1 社
広告 30 件ごとに 0.5 クレジット
検索は受け取った広告 30 件ごとに 0.5 クレジットで、最低 0.5 クレジットです。既定のリクエスト(広告 30 件)は 0.5 クレジット、広告 500 件の検索は最大 8.5 クレジットです。広告主の検索は 0.5 クレジットです。課金は完了したリクエストにのみ適用されます。
料金を見る →| プラン | 1,000 回 |
|---|---|
| Basic | ≈ $1.25 |
| Max | ≈ $0.50 |
月間クレジットをすべて使った場合の換算料金です。





