海外广告库查询 okdata
海外广告库查询:用 okdata 接口读Meta 广告库、Google 广告透明中心的公开数据,包括Meta 广告库搜索、Meta 广告详情、Meta 广告主的广告、Google 广告透明中心广告主搜索、Google 广告主的广告等,不用登录、不用 Cookie,按次付费。适用于看竞品在 Facebook、Instagram 上在投什么广告、查一个广告主在 Google 搜索、YouTube 上的广告、按关键词找在投广告,做投放素材调研。 Meta Ad Library and Google Ads Transparency Center public data for AI agents through the okdata API (remote MCP or HTTP), paid per call.
海外广告库查询(okdata)
用 okdata 的接口读Meta 广告库、Google 广告透明中心的公开数据:Facebook 和 Instagram 上在投的广告,按关键词或广告主查、广告主和他们在搜索、YouTube、展示广告上的广告。 不用登录Meta 广告库、Google 广告透明中心,也不用 Cookie,按次付费。
什么时候用
- 看竞品在 Facebook、Instagram 上在投什么广告
- 查一个广告主在 Google 搜索、YouTube 上的广告
- 按关键词找在投广告,做投放素材调研
能拿到的数据
目录版本 de11f23d71485342,价目表 84f29877acc83a88。价格单位是美元。请求到了数据源的调用,返回为空、查不到或出错也照常计费,按条计价的接口算一条;参数错误、余额不足这类还没请求数据源就被拦下的不扣费。
| 接口 | 能拿到什么 | 需要传 | 每次返回 | 价格 |
|---|---|---|---|---|
meta.ads.search | Meta 广告库搜索:按关键词搜 Meta 广告库(Facebook、Instagram、Messenger):广告主、文案、标题、图片和视频、落地页、投放位置和开始时间。可限定国家、图片或视频广告,以及在投或已停投。 | query | 一页约 30 条 | 每次 $0.004 |
meta.ads.get | Meta 广告详情:按广告库 ID 或链接取 Meta 广告库的一条广告:广告主、文案、图片和视频、落地页、投放平台、首次和最近投放日期,以及是否仍在投放。 | id 或 url | 一条 | 每次 $0.004 |
meta.advertisers.ads.list | Meta 广告主的广告:按 Facebook 主页 ID 或品牌名取某个广告主在 Meta 广告库里的广告:文案、素材、落地页、投放平台和日期。看竞品正在投什么,用这个。 | 不用传 | 一页约 30 条 | 每次 $0.004 |
google.advertisers.search | Google 广告透明中心广告主搜索:按名称在 Google 广告透明中心找广告主:广告主 ID、Google 验证过的名称、注册国家和广告数量估计。验证名称常是公司主体名,不一定是品牌名。 | query | 一页约 10 条 | 每次 $0.004 |
google.advertisers.ads.list | Google 广告主的广告:按广告主 ID 或品牌官网域名取 Google 广告透明中心里的广告(搜索、YouTube、展示、购物、地图、Play):格式、预览图、首次和最近展示时间。每页 40 条。 | 不用传 | 一页约 40 条 | 每次 $0.004 |
怎么调用
用 MCP(已接上 okdata MCP 服务时优先用):先用 describe 看一个接口的参数、返回字段和价格(免费),再用 call 调用,
capability 填接口 id,参数跟在旁边,例如 {"capability": "meta.ads.search", "query": "portable espresso", "max_price": "0.05", "idempotency_key": "<uuid>"}。
find 能用中文或英文描述找接口,read_more 取长结果的剩余部分,这两个也免费。
还没接上的话,远程 MCP 地址是 https://api.okdata.online/mcp,认证头是 Authorization: Bearer <key>,详见 okdata-setup 技能。
用 HTTP(没有 MCP 时):路径是接口 id 把点换成斜杠、放在 /v1 下面,参数放在查询串里,key 从环境变量读,不要贴进对话:
curl -sG "https://api.okdata.online/v1/meta/ads/search" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
--data-urlencode 'query=portable espresso'
每个返回都带 code。"ok" 时数据在 data.items(列表,翻页看 page.next_cursor)或 data.item 里,
meta.billing.amount 是这次花了多少钱。其他 code 都是出错,会说明 charged 和 retry,扣了费还会带 amount。
not_found、upstream_failed、upstream_busy、timeout 说明请求已经到了数据源,照常计费,再调一次就是一次新的付费调用:
返回为空或 not_found 的不要重试,数据源出错最多再试一次。invalid_params 不扣费,改好参数再调就行;
rate_limited 也不扣费,等 retry_after_seconds 再试。Idempotency-Key 每次调用用新的,
只有没收到返回、要原样重发同一个请求时才沿用原来那个。
用法建议
- 先用搜索类接口找到内容或账号,再查详情、评论或作品列表。搜索类接口拿到的结果里带着后续接口要用的 id。
- 列表接口一次返回一页。要更多就带上
page.next_cursor再调一次,在 MCP 里也可以用read_more。 - 调用前先算一下要调几次、大概多少钱,告诉用户再动手。给
call设max_price:这次可能花得比它多时,调用会被拒绝,不扣钱。 - 只读公开数据:不发帖、不点赞、不评论、不私信。
- 还没有 key:到 https://okdata.online/zh/signup/?src=skill-okdata-ad-library 注册,在控制台创建 key,设成环境变量
OKDATA_API_KEY。不要让用户把 key 贴进对话。
相关技能
okdata-setup:接入 MCP、保存 key、查价格和余额、排查报错okdata-comments:跨平台读评论,做口碑分析okdata-competitors:竞品账号监控和对比okdata-creators:按领域找达人、筛博主okdata-trends:各平台热搜热榜okdata-content-research:爆款内容调研
Related skills
- Downloads
- Security audit
- Pass
- Last updated
- 2d ago
- Current version
- v0.1.1
- License
- MIT-0
