跳到正文

Meta 广告资料库 API:以 JSON 获取 Facebook 和 Instagram 广告

按关键词或广告主搜索 Meta 广告资料库,通过一个异步 API 以 JSON 获取正在 Facebook、Instagram、Messenger、WhatsApp 和 Threads 上投放的广告,每条广告都包含文案、图片和视频、落地页、行动号召按钮、开始投放日期和投放平台。

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 列出一个广告主的广告。country 设定广告投放的国家,ALL 搜索所有国家,limit 一次最多返回 500 条广告。把响应中的 nextCursor 作为 cursor 发送,即可获取后续的广告。

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "pageId": "266556540473351",
    "country": "US",
    "limit": 500
  }
}
  1. limit: 500第 1–500 条广告38.1秒
  2. cursor: "eyJ2IjoxLCJoIj…"第 501–855 条广告28.7秒

两次响应共 855 条广告,每条出现一次totalCount: 855

2026年11月20日 用 ADS 两次搜索 soundcore 主页在美国的广告,第二次把第一次的 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 主页在美国的广告逐一应用筛选条件时资料库给出的数量。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。