关于 Facebook/Meta Ads Library Scraper API - Winning Ads, Scam Check
这款 Apify Actor 按关键词或广告主收集 Meta 广告资料库中的公开广告,并提供广告主发现和品牌冒用检查。适用于广告研究、客户开发和品牌监测,还会返回广告投放时长及版本数。
主要功能
- 01按关键词或广告主搜索广告
- 02列出关键词对应的广告主
- 03标记可能的品牌冒用广告
- 04返回投放时长和版本数
- 05提供落地页及媒体链接
适用场景
- 01查找竞品的长期投放广告
- 02整理广告创意研究素材
- 03筛选正在投放广告的潜在客户
- 04检查可能冒用品牌的广告
MCP 相关
可通过 Apify MCP 服务供 AI Agent 使用。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.apify.com/?tools=anshumanatrey/facebook-ads-library-apiclaude mcp add --transport http anshumanatrey-facebook-ads-library-api https://mcp.apify.com/?tools=anshumanatrey/facebook-ads-library-api{"mcpServers":{"anshumanatrey-facebook-ads-library-api":{"type":"http","url":"https://mcp.apify.com/?tools=anshumanatrey/facebook-ads-library-api"}}}在 Cursor 中打开{"servers":{"anshumanatrey-facebook-ads-library-api":{"type":"http","url":"https://mcp.apify.com/?tools=anshumanatrey/facebook-ads-library-api"}}}在 VS Code 中打开{"mcpServers":{"anshumanatrey-facebook-ads-library-api":{"type":"http","url":"https://mcp.apify.com/?tools=anshumanatrey/facebook-ads-library-api"}}}{"mcpServers":{"anshumanatrey-facebook-ads-library-api":{"serverUrl":"https://mcp.apify.com/?tools=anshumanatrey/facebook-ads-library-api"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://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.00005 | 5,853 |
| Facebook Ad Library Scraper,由 igolaizola 提供 | $0.75 | $0.0075 | 1,048 |
| Facebook Ads Library,由 automation-lab 提供 | $0.575 | $0.005 | 458 |
| Facebook Ads Library Scraper,由 memo23 提供 | $0.50 | $0.05 | 340 |
| Facebook Ads Library Scraper,由 brilliant_gum 提供 | $15.00 + 平台使用费 | $0.001 | 271 |
| 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 小时内完成。这是维护者直接提供的一对一服务,不会进入承包商队列。
最快的联系渠道(按响应速度排序):
- LinkedIn 私信 -> linkedin.com/in/anshumanatrey,活跃时段内通常不到 1 小时
- 在此 Actor 的代码仓库中提交 GitHub issue
- 通过 Apify Console 向
@anshumanatrey发送私信 - 通过 atrey.dev 联系 电子邮件
同一维护者的相关 Actor
| Actor | 用途 |
|---|---|
| google-trends-api-scraper | Google Trends 的随时间变化趋势、地区、相关查询和热门趋势,无需登录 |
| domain-history-contact-osint | 域名的前任所有者、电子邮件和历史记录:可与此处找到的落地页域名搭配使用 |
| netintel | IP 或域名情报:WHOIS、DNS、GeoIP、ASN、端口,用于调查相似的诈骗域名 |
| telegram-channel-scraper | 获取公开 Telegram 频道的帖子、媒体和按钮,无需登录 |
| theharvester-osint | 从公开来源获取域名的电子邮件、子域名和主机 |
| holehe-email-osint | 查询某个电子邮件地址注册了 120 多个网站中的哪些网站 |
文档
- Apify API:https://docs.apify.com/api/v2
- 使用 Apify 客户端通过 Python 或 JavaScript 运行,也可通过 n8n、Make 和 Zapier 的 Apify 集成运行。
- 源码:https://github.com/AnshumanAtrey/facebook-ads-library-api
最后更新
2026-09-25:版本 1.0。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。