Meta 广告库 API
5 个接口读 Meta 广告库：广告库、广告主。一次 $0.0020 起。不用登录 Meta 广告库，不用 Cookie；失败不收费。
调一次，拿回来的样子
录下来的真实返回，字段已经整理好，直接给 AI 或表格用。2026-10-12 21:45 UTC 录下的真实返回，这里是前 3 行。
在 Playground 里跑一次 · $0.0020{
"code": "ok",
"request_id": "f8a22e1e-fee2-4b69-9e5c-446621ff8b56",
"data": {
"item": {
"id": "1058286942402074",
"url": "https://www.facebook.com/ads/library/?id=1058286942402074",
"format": "image",
"title": "Start weekend hiking with the kit made for beginners",
"text": "Start weekend hiking with the kit made for beginners",
"landing_url": "https://www.pineandoak-home.com/fall?utm_source=meta",
"advertiser": {
"id": "124244511652870",
"name": "Pine & Oak Home",
"url": "https://www.facebook.com/profile.php?id=124244511652870",
"avatar_url": "https://scontent.xx.fbcdn.net/v/t39.30808-1/419991773_116184846204048_n.jpg"
},
"images": [
"https://scontent.xx.fbcdn.net/v/t39.35426-6/433783216_111510700877970_n.jpg",
"https://scontent.xx.fbcdn.net/v/t39.35426-6/464959343_128562597021179_n.jpg",
// … 另有 4 条
],
"first_shown_at": "2025-04-07T07:00:00.000Z",
"last_shown_at": "2026-10-12T07:00:00.000Z"
}
},
"warnings": [],
"meta": {
"capability": "meta.ads.get",
"result_status": "complete",
"fetched_at": "2026-10-12T21:45:40.000Z",
"cached": false,
"replayed": false,
"unavailable": {},
"billing": {
"amount": "0.002",
"currency": "USD",
"balance_after": "9.998"
}
}
}取自 2026-10-12 21:45 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。
能拿到什么
每一行是一个接口：返回什么，一次多少钱。
大家拿它做什么
你的 AI 现在就能用 Meta 广告库数据跑的现成任务。每个任务是几次调用，带花费上限。
在 Claude、Cursor 里直接问 Meta 广告库
加上 DataXAPI 的 MCP，AI 会自己找到合适的 Meta 广告库接口去调，回答里带原始链接。花多少钱按调了哪些接口算。
https://api.dataxapi.com/mcp三步开始
这里演示的是 Meta 广告详情。Meta 广告库的其他接口都是同样的调法，返回同样的格式。
拿一把 Key
用邮箱验证码或 Google 登录。可免费试用，不用绑卡。
自己调，或者让你的 AI 调
代码里一次 GET。或者把下面这段话带着你的 Key 贴给你的 agent：它自己接好，然后能自己找到并调用这些接口。
每次读到的都是同一种格式
数据在 data.items（单个对象在 data.item），下一页在 page.next_cursor，扣了多少在 meta.billing.amount。失败不扣费。
curl -G "https://api.dataxapi.com/v1/meta/ads/get" \ --data-urlencode "id=1466307095509411" \ -H "Authorization: Bearer $DATAXAPI_API_KEY"
from dataxapi import DataXAPI dx = DataXAPI() # reads DATAXAPI_API_KEY result = dx.meta.ads.get(id="1466307095509411") print(result["data"]["item"])
import { DataXAPI } from "@dataxapi/sdk";
const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.meta.ads.get({ id: "1466307095509411" });
console.log(result.data.item);dataxapi call meta.ads.get id=1466307095509411
{
"mcpServers": {
"dataxapi": {
"type": "http",
"url": "https://api.dataxapi.com/mcp",
"headers": {
"Authorization": "Bearer ${DATAXAPI_API_KEY}"
}
}
}
}把这段加进你的 MCP 客户端，然后让你的 AI 调用 meta.ads.get。
边界情况
Meta 广告库这些接口在边界上怎么表现，以及调用结果不对时先看哪里。
- 每页条数
- 列表每页 15 到 30 条，各接口不同。3 个列表里有 2 个能翻页：把
page.next_cursor作为cursor传回，每一页是一次单独的调用。其余只有一页。 - 给不了的字段
- 5 个接口里有 2 个填不满它返回的对象。每个接口的页面列出了给不了哪些，每次返回也在
meta.unavailable里再写一遍：缺的字段不会被悄悄写成 0。 - 对象不存在时读起来像空结果
- Meta 广告主的广告：对象不存在和对象下面没有东西分不出来，所以返回空结果而不是 404，并按空结果计费。
- 预览结构
- 有 4 个接口返回的是预览结构，字段还可能调整；其余返回统一的结构，所有平台都一样。
- 只有在投的广告
- 广告搜索和广告主的广告，返回的都是现在正在投放的。
- 广告主编号就是主页编号
- 广告主就是一个 Facebook 主页：先用广告主搜索按名称查到编号，再用这个编号取它的广告。
- 广告库编号或链接
- 单条广告用广告库编号（Library ID），或者链接 facebook.com/ads/library/?id=编号。
- 空结果不等于不存在
- 不存在的广告主和现在没在投广告的广告主，都返回空列表，按空结果计费。
- 不是每条广告都有文字稿
- 没有视频的广告，或者视频里转不出文字的，按不存在返回，不扣费。
关于 Meta 广告库 API 的常见问题
回答从简，细节在各接口的页面。
Meta 广告库 API 怎么收费？
按次收费，没有订阅。5 个接口都是一次 $0.0020。拿到数据才扣费，失败不收。
需要 Meta 广告库账号或 Cookie 吗？
不需要。你只拿一把 DataXAPI 的 Key：不用登录 Meta 广告库，不用 Cookie，也不用养设备。接口只返回公开可见的数据。
数据是实时的吗？
每次调用都当场去 Meta 广告库取，meta.fetched_at 写明取到的时间。结果保留 24 小时，带同一个 Idempotency-Key 重试不会再扣一次。
空结果收费吗？
列表返回空结果时照价收费：搜索已经执行了。读单个对象而对象不存在时返回 not_found，不收费。
Meta 广告库改版了怎么办？
调用失败不管什么原因都不扣费。被暂停的接口返回 capability_paused，同样不扣费；GET /v1/catalog/status 写着现在哪些能用。
相关
一把 Key 调 Meta 广告库。
免费试用：按 $0.0020 一次，最多可调 50 次，不用绑卡。 不用登录 Meta 广告库，不用 Cookie，没有订阅。失败不收费。