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 或轮询获取。
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 列出一个广告主的广告。country 设定广告投放的国家,ALL 搜索所有国家,limit 一次最多返回 500 条广告。把响应中的 nextCursor 作为 cursor 发送,即可获取后续的广告。
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"pageId": "266556540473351",
"country": "US",
"limit": 500
}
}limit: 500第 1–500 条广告38.1秒cursor: "eyJ2IjoxLCJoIj…"第 501–855 条广告28.7秒
两次响应共 855 条广告,每条出现一次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 |
这是使用完月度套餐积分时的换算费用。





