mcpField
F
Facebook/Meta Ads Library Scraper API - Winning Ads, Scam Check

Facebook/Meta Ads Library Scraper API - Winning Ads, Scam Check

远程服务
apify.com商业与营销04 周前更新

关于 Facebook/Meta Ads Library Scraper API - Winning Ads, Scam Check

这款 Apify Actor 按关键词或广告主收集 Meta 广告资料库中的公开广告,并提供广告主发现和品牌冒用检查。适用于广告研究、客户开发和品牌监测,还会返回广告投放时长及版本数。

主要功能

  1. 01按关键词或广告主搜索广告
  2. 02列出关键词对应的广告主
  3. 03标记可能的品牌冒用广告
  4. 04返回投放时长和版本数
  5. 05提供落地页及媒体链接

适用场景

  1. 01查找竞品的长期投放广告
  2. 02整理广告创意研究素材
  3. 03筛选正在投放广告的潜在客户
  4. 04检查可能冒用品牌的广告

MCP 相关

可通过 Apify MCP 服务供 AI Agent 使用。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://mcp.apify.com/?tools=anshumanatrey/facebook-ads-library-api
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址
Streamable HTTPhttps://mcp.apify.com/?tools=anshumanatrey/facebook-ads-library-api需要授权

工具

详细介绍

Facebook/Meta 广告资料库采集 API——爆款广告与诈骗检测

无需登录、无需 Cookie,也无需 Meta API 令牌,即可采集 Facebook 广告资料库(Meta 现称为 Meta 广告资料库,其中包含 Facebook、Instagram、Messenger、Threads 和 Audience Network 上的广告)。输入关键词或粘贴 Facebook 公共主页,即可将所有匹配的广告逐行获取:广告主、广告已投放天数、广告版本数量、文案、标题和按钮、落地页及其域名、图片和视频链接、投放平台,以及 Meta 发布的覆盖人数、花费和欧盟受众数据。此外,还提供广告主列表(当前针对关键词投放广告的商家,每家一行)和品牌诈骗检测(来自非品牌官方主页、使用品牌名称的广告)。每 1,000 条广告收费 0.70 美元,无启动费用。可通过 Apify 控制台、API、Python、JavaScript、n8n、Make、Zapier 或 Apify MCP 服务中的 AI Agent 使用。

它有什么功能?

它会读取公开的 Meta 广告资料库,也就是 facebook.com/ads/library 上的资料库,并返回原本需要你手动复制的内容。你可以输入任意数量的关键词或广告主:

  • 关键词广告(ads):返回与关键词匹配的所有广告,可按国家/地区筛选,也可搜索全球范围。
  • 广告主广告(pages):返回你列出的 Facebook 公共主页的所有广告,可通过链接、主页 ID 或名称查找。
  • 广告主列表(advertisers):列出当前针对关键词投放广告的商家,包括广告数量、投放时间最长的广告,以及广告引流到的网站。
  • 品牌诈骗检测(impersonation):列出提及某个品牌但来自其他主页的广告,并为每条广告标注风险等级和相关信号(相似的主页名称、相似的落地页域名、来自小型主页的新广告)。

为什么人们会使用广告资料库数据?

答案:了解别人的广告中哪些内容已经奏效。 Meta 会展示所有正在投放的广告,但不会展示成效,因此最佳的免费参考信号就是投放时长:一条广告投放 30 到 90 天,几乎总能收回成本,因为没有人会一直为亏钱的广告付费。

  • 媒介投放人员和 DTC 品牌可以找到竞争对手长期投放的广告,借鉴其吸引点、优惠和形式,而不必从零开始付费测试。daysRunning 和 versions 字段正是为此提供的:同一广告有多个在线版本,说明正在进行 A/B 测试,而留存下来的就是胜出版本。
  • 创意策略师和代理机构可以每周跟踪 10 到 20 个品牌并整理广告素材库;落地页域名还会展示每条广告背后的转化漏斗。
  • 开拓客户的代理机构可以使用广告主列表:当前正在投放广告的商家有预算,因此是潜在的优质客户。
  • 电商和代发货商家可以发现通过大量长期投放广告推广的产品。
  • 开发者可以构建广告监测工具、n8n 和 Make 工作流(先采集广告,再让 GPT 或 Gemini 提取吸引点并撰写新版本),以及基于此构建 AI Agent 工具,而无需维护采集器。
  • 品牌保护和安全团队可以运行品牌诈骗检测。Meta 自己估计每天会展示约 150 亿条诈骗广告,并于 2026 年 3 月扩展了品牌冒充检测功能;此工具可找出使用你品牌名称的广告。

它与其他 Facebook Ads Library 抓取工具有何不同?

  • 比最常用的两款 Facebook/Meta Ads Library 抓取工具更便宜:每 1,000 条广告收费 $0.70,而 Apify 自家的工具收费 $5.80,curious_coder 收费 $0.75,另加启动费(两者合计约占该类别用户的 70%)。没有启动费,小规模运行也最便宜:少于 40 条广告时比 automation-lab 便宜,少于 250 条时比 memo23 便宜。大规模运行时,这两款工具和 jmlp 的单条广告费用更低;下表列出了所有价格。
  • 内置热门广告信号:每条广告都会计算 daysRunning,versions 是 Meta 自己统计的广告变体数量,而**最短投放天数(minDaysRunning)**可筛选出长期投放的广告。
  • 每条广告都包含落地页域名,便于按广告引导用户访问的网站对广告分组。
  • 广告主列表和品牌诈骗检查由同一个 actor 提供,收费方式相同。
  • 任何人都能轻松使用:输入关键词并点击 Start 即可;支持国家名称(India、USA、UK),用逗号分隔关键词,也能识别粘贴的 Ad Library 链接或 Facebook 公共主页链接。
  • 无需设置代理:Meta 会屏蔽云端和数据中心 IP(在我们 2026-09-25 的测试中,两者返回的广告数均为 0),因此每次搜索都通过 Apify 的住宅代理运行,费用已包含在价格中。
  • 只为已保存的行付费,并且达到支出上限后,运行会在批次之间正常停止。

抓取 Facebook Ads Library 要多少钱?

每条广告 $0.0007(每 1,000 条 $0.70);广告主列表每个广告主收费 $0.008,品牌诈骗检查每条广告收费 $0.002(该检查会先读取品牌自己的页面,以了解其真实网站)。无启动费、无月费,平台使用费和住宅代理费均已包含。

运行计费数量价格
示例输入(“running shoes”的 20 条广告)20 条广告$0.014
一个关键词的 100 条广告100 条广告$0.07
10 个关键词共 1,000 条广告1,000 条广告$0.70
从 200 条广告中找到 60 个广告主的广告主列表60 个广告主$0.48
品牌诈骗检查从其他公共主页中找到 40 条广告40 条诈骗检查广告$0.08
Meta 没有匹配广告的搜索0$0.00

Apify 免费套餐包含 $5 的月度额度,约可抓取 7,000 条广告。

与其他 Facebook Ads Library 抓取工具相比,价格如何?

截至 2026-09-25,过去 30 天内用户数达到 250 或更多的 Facebook Ads Library actor,按用户数排序,价格为 Apify 免费套餐下的价格。

抓取工具每 1,000 条广告的价格启动费近 30 天用户数
本 actor$0.70无新推出
Facebook Ads Library Scraper,由 apify 提供$5.80无6,040
Facebook Ads Library Scraper,由 curious_coder 提供$0.75$0.000055,853
Facebook Ad Library Scraper,由 igolaizola 提供$0.75$0.00751,048
Facebook Ads Library,由 automation-lab 提供$0.575$0.005458
Facebook Ads Library Scraper,由 memo23 提供$0.50$0.05340
Facebook Ads Library Scraper,由 brilliant_gum 提供$15.00 + 平台使用费$0.001271
Meta Ad Scraper,由 whoareyouanas 提供$10.00无256
Meta Ad Library Scraper,由 jmlp 提供$0.15 + 平台使用费无254

其中一些工具在 Apify 付费套餐中会提供折扣,部分工具还会额外收取平台使用费;大规模运行时,automation-lab、memo23 和 jmlp 的单条广告费用更低。如果要抓取大量数据,请根据你自己的套餐进行比较。

它接受哪些输入?

每个字段都有一个普通名称,后面括号中是对应的 JSON 键。只有 Keywords 是必填项。

字段(JSON 键)必填作用
报告类型(mode)否ads(默认)、pages、advertisers 或 impersonation(品牌诈骗检查)
关键词(searchTerms)是,pages 除外每行一个;同一行中的 a, b 表示两个关键词;粘贴 Ad Library 搜索链接也可使用。进行诈骗检查时,填写品牌
广告主(pages)使用 pages 时必填Facebook 公共主页链接、主页 ID 或名称,例如 https://www.facebook.com/nike 或 Gymshark
国家/地区(country)否ALL(全球,默认)、名称(如 India)或代码(如 IN)
每次搜索的广告数(maxAds)否每个关键词或广告主最多保存的广告数,默认值为 100
广告状态(status)否active(默认)、inactive 或 all
广告类别(adType)否all(默认)、political、housing、employment、credit
媒体类型(mediaType)否all、image、video、meme、none
最短投放天数(minDaysRunning)否仅保留投放时间至少达到此天数的广告
精确短语(exactPhrase)否将关键词作为一个短语进行匹配
合并版本(groupVersions)否每组广告版本只显示一行
排序方式(sortBy)否impressions(曝光量最高的排在前面,默认)或 relevance
官方主页(officialPages)否进行诈骗检查时,填写品牌自己的主页;留空时,会使用名称与品牌完全一致的主页,并在运行摘要中列出
{ "searchTerms": ["running shoes"], "country": "US", "minDaysRunning": 30, "maxAds": 200 }

输出是什么样的?

每条广告占一行(广告主列表中则每个广告主占一行)。始终包含所有键;Meta 没有对应内容时,值为空。以下是缩短后的广告行示例:

{
  "adId": "866569929827744",
  "adLibraryUrl": "https://www.facebook.com/ads/library/?id=866569929827744",
  "pageName": "Example Brand",
  "pageId": "1234567890",
  "pageLikes": 48210,
  "isActive": true,
  "startDate": "2026-06-01T12:30:00",
  "daysRunning": 116,
  "versions": 3,
  "platforms": ["FACEBOOK", "INSTAGRAM", "THREADS"],
  "adText": "Our best-selling trainer is back in stock...",
  "headline": "Free shipping this week",
  "callToAction": "Shop now",
  "landingUrl": "https://www.example.com/sale",
  "landingDomain": "example.com",
  "imageUrls": ["https://scontent.xx.fbcdn.net/..."],
  "videoUrls": [],
  "spend": null,
  "ageGender": [],
  "impersonation": null
}

品牌诈骗检查的行会额外包含 impersonation:{"brand": "Nike", "risk": "high", "signals": ["page name uses the brand but it is not an official page", "sends people to nike-outlet-sale.shop, a look-alike site, not an official domain"]}。这些信号供你审查,并非最终判定:Foot Locker 等转售商也会使用品牌名称,因此检查结果可能是低风险。

运行摘要就是 OUTPUT 记录:包含状态、关于我们对你输入所做任何修改的说明、每次搜索对应的一条记录(注明读取和保存的广告数量),以及计费事件。

运行速度如何?

在我们于 2026-09-25 在 Apify 上进行的测试中(256 MB,峰值 57-70 MB):读取 20 条广告耗时 16 s;单个关键词读取 200 条广告耗时 106 s;读取 3 个关键词、每个关键词 50 条广告耗时 49 s(它们同时运行,各自使用独立的住宅 IP);读取 2 个广告主的 60 条广告耗时 48 s;从 100 条广告中获取 86 家企业的广告主列表耗时 66 s。没有任何一次运行受到速率限制。

常见问题

问:Facebook 广告资料库和 Meta 广告资料库是同一个吗? 是的。它们是 facebook.com/ads/library 上的同一个公开资料库;Meta 现在将其称为 Meta 广告资料库,涵盖 Facebook、Instagram、Messenger、Threads 和 Audience Network 上的广告。此 Actor 会读取这些平台上的所有广告。

问:我需要 Facebook 账户、Cookie 或 Meta API 令牌吗? 不需要。它读取公开广告资料库的方式,与未登录访客看到的内容相同。

问:我能看到广告花费了多少钱或触达了多少人吗? 对于政治和议题广告,可以:Meta 会公布花费和展示次数的范围。对于在欧盟投放的广告,Meta 会按年龄、性别和地区公布触达人数。对于其他广告,Meta 不会显示任何数字,因此 daysRunning 和 versions 很重要。

问:如何找到效果出色的广告? 将最短投放天数(minDaysRunning)设为 30 天或以上。持续投放数周的广告都在带来收益,而 versions 会显示正在测试的多个变体。

问:这是 Meta 官方广告资料库 API 吗? 不是。官方 API 需要开发者账户和身份验证,且仅涵盖政治和议题广告,以及在欧盟展示的广告。此 Actor 涵盖公开广告资料库中展示的所有广告。

问:我可以每周监控竞争对手吗? 可以。将输入保存为 Apify 任务并设置计划;将广告状态(status)设为 active,并将排序方式(sortBy)设为 impressions,即可优先查看重要广告。

问:为什么我需要住宅代理? 你无需自行设置。Meta 会将云端和数据中心 IP 的广告请求速率限制为零,因此此 Actor 会为你使用 Apify 的住宅代理,价格中已包含代理费用。

问:它会下载图片和视频吗? 不会。它会返回 Meta 自己的图片和视频链接;如果需要副本,请自行下载。

问:品牌诈骗检查会查找什么? 名称中使用了该品牌但并非官方页面的页面、将用户引导至仿冒域名的广告,以及来自小型页面的新广告。它会跳过通过名称找到或由你提供的品牌自有页面。

限制

  • Meta 仅对政治和议题广告显示花费和展示次数,仅对在欧盟投放的广告显示受众细分数据。
  • Meta 的广告搜索结果中不包含页面是否经过验证的信息,因此此 Actor 不会对此进行推测。
  • 关键词搜索遵循 Meta 自身的匹配方式,可能会返回关联较弱的广告;启用精确短语(exactPhrase)可获得更精确的匹配结果。
  • 大规模搜索需要时间:每个关键词每分钟约 110 条广告(在 Apify 上 106 秒可获取 200 条);多个关键词会同时运行。

关于维护者(优先响应时间为 1-2 小时)

由 Anshuman Atrey(@AnshumanAtrey)开发并维护。

  • 紫队安全研究员,5 次黑客马拉松获胜者
  • Walrus Securitas(AI 网络安全 SaaS)和 The Drone Syndicate(自主防御无人机)的联合创始人
  • Apify Store 上 OSINT 和数据 Actor 产品组合的作者:已发布 18 个 Actor,涵盖电子邮件、电话、用户名、IP 和域名、网络、密钥、社交媒体、LinkedIn、域名历史、Telegram、Google Trends、Meta 广告和印度金融科技数据
1-2 小时内交付的定制功能请求(优先处理)

如果你需要此 Actor 尚不具备的字段、筛选条件或输出格式,维护者会直接将其添加到此 Actor 中。活跃时段内的优先请求通常会在 1-2 小时内完成,夜间则会在 24 小时内完成。这是维护者直接提供的一对一服务,不会进入承包商队列。

最快的联系渠道(按响应速度排序):

  1. LinkedIn 私信 -> linkedin.com/in/anshumanatrey,活跃时段内通常不到 1 小时
  2. 在此 Actor 的代码仓库中提交 GitHub issue
  3. 通过 Apify Console 向 @anshumanatrey 发送私信
  4. 通过 atrey.dev 联系 电子邮件

同一维护者的相关 Actor

Actor用途
google-trends-api-scraperGoogle Trends 的随时间变化趋势、地区、相关查询和热门趋势,无需登录
domain-history-contact-osint域名的前任所有者、电子邮件和历史记录:可与此处找到的落地页域名搭配使用
netintelIP 或域名情报:WHOIS、DNS、GeoIP、ASN、端口,用于调查相似的诈骗域名
telegram-channel-scraper获取公开 Telegram 频道的帖子、媒体和按钮,无需登录
theharvester-osint从公开来源获取域名的电子邮件、子域名和主机
holehe-email-osint查询某个电子邮件地址注册了 120 多个网站中的哪些网站

文档

最后更新

2026-09-25:版本 1.0。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。