postdata

Meta 广告库与 Google 广告透明度 API

PostToData 为 Meta 广告库和 Google 广告透明度提供只读搜索与素材详情接口。Meta 按公司或品牌名称查找，Google 按 nike.com 这样的公司域名查找；返回的是可用的公开广告素材证据，不是私有广告账户的投放效果。

文档核对: 2026-11-13 · 作者 PostToData

两个广告库需要不同输入

Meta 搜索使用公司或品牌名称，查询可用的公开在投广告。Google 搜索使用公司域名，不接受任意关键词或完整 URL。不能把同一个输入原样交给两个接口。

这两组接口目前按来源默认顺序返回第一页，不支持游标翻页或自定义排序。结果很少或为空，并不能证明该广告主没有投放。

公开素材研究不等于投放效果分析

可查看素材文字、来源链接及来源提供的广告主 ID、素材 ID、格式和首次/最后展示日期。只有来源明确给出时，才返回是否在投标记。

不能从公开素材推算真实花费、转化、定向、ROAS 或投资回报。PostToData 不会访问你的私有 Meta 或 Google 广告账户，也不是官方营销或广告管理 API。

区分广告库、Facebook 帖子和 Pinterest 图钉

Facebook 公开帖子与 Pinterest 图钉属于另外的平台接口。Facebook 视频搜索不是 Meta 广告搜索，Pinterest 图钉也不能作为广告花费的证据；请按任务选择对应文档。

先做一次广告库搜索，保留原始链接和采集时间，只对相关素材另外批准详情查询。广告研究工作流会先展示调用计划及价格；配套 AI Skill 明确要求不编造投放效果指标。

当前价格与真实接口

操作每次成功调用1,000 次成功调用
Meta Ad Library · 搜索广告$0.006$6.00
Google Ads Transparency · 搜索广告$0.006$6.00
Meta Ad Library · 广告详情$0.006$6.00
Google Ads Transparency · 广告详情$0.006$6.00

1,000 次是标价乘以调用次数，不是 1,000 条数据，也不是充值套餐。以下仅预览第一项操作的价格，不访问数据上游、不扣额度。正式获取数据时移除 dry_run=1 并使用 Authorization: Bearer API_KEY；保留 max_price_usd 防止价格超过批准值。

免费价格预览
curl --get "https://posttodata.com/v1/meta_ads/search" \
  --data-urlencode 'query=Nike' \
  --data-urlencode 'limit=5' \
  --data-urlencode 'max_price_usd=0.006' \
  --data-urlencode 'dry_run=1'

费用上限只限制当前一次调用，不是整个任务的共享预算。逐项批准调用数量，遇到 402、412 或 429 时停止，不能自动提价或更换账号重试。

prices.json充值和试用规则打开对应工作流MCP 连接方式

常见问题

能按商品关键词搜索 Google 广告吗？

本接入不支持。必须提供公司域名，例如 nike.com。若任务需要其他筛选条件，应评估 Meta 的公司名称搜索或其他数据来源。

能获取全部历史广告或者测算 ROI 吗？

不能。当前支持有限的第一页公开搜索与单条素材详情，不承诺完整历史档案，也不返回转化和 ROI。

相关指南