Facebook API

Facebook 广告详情 API

通过 ID 或 URL 查询 Meta 广告资料库中的单条广告,以干净的 JSON 返回广告主、创意文案、行动号召、投放平台和投放日期。

US$1.20/千次请求,按请求付费,无需订阅。

fMeta Ad Library
facebook.com/ads/library/?id=962050096457659
Meta
United StatesiAll adsSolace Sleep

Solace Sleep

Active · Sponsored

Fall asleep 40% faster with the Solace weighted blanket. Engineered with glass microbeads for even pressure all night. Ships free, try it for 100 nights.

video

solacesleepco.com

Free shipping. 100 night trial. Financing available.

Shop Now
Library ID: 962050096457659FBIGMSG

Ad details

Status
Active
Started running on
September 15, 2025
Platforms
facebook, instagram, messenger
Library ID
962050096457659
API 返回的内容
{
"adArchiveId": "962050096457659",
"sourceUrl": "https://www.facebook.com/ads/library/?id=962050096457659",
"pageId": "104882733481920",
"pageName": "Solace Sleep",
"active": true,
"startDate": 1757894400,
"endDate": null,
"currency": "USD",
... 还有 17 个字段
}
可用率
99.27%
30d · 13,156 次调用
请求数
13,159
30d · 按周,近 12 周
响应时间
1.5s
中位数 · 30d

价格与服务商

Facebook 广告详情 API 价格:一个 API,2 个可互换的服务商

最便宜的服务商优先响应。如果它失败,下一个会在同一次调用中接手。

你需支付
US$12.00
US$1.20/千次请求,只为实际用量付费。没有月度套餐。
有了 US$0.10 的初始余额,你的前 83 次请求免费。

试一试

一个请求获取 Facebook 广告详情

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。

这个示例展示了 42 个字段中的 25 个。查看全部字段

{
  "found": true,
  "data": {
    "adArchiveId": "962050096457659",
    "sourceUrl": "https://www.facebook.com/ads/library/?id=962050096457659",
    "pageId": "104882733481920",
    "pageName": "Solace Sleep",
    "active": true,
    "startDate": 1757894400,
    "endDate": null,
    "currency": "USD",
    "text": "Fall asleep 40% faster with the Solace weighted blanket. Engineered with glass microbeads for even pressure all night. Ships free, try it for 100 nights.",
    "title": "The blanket that ends 2am scrolling",
    "ctaText": "Shop Now",
    "linkUrl": "https://solacesleepco.com/weighted-blanket?utm_source=fb",
    "displayFormat": "VIDEO",
    "platforms": [
      "facebook",
      "instagram",
      "messenger"
    ],
    "pageProfilePicture": "https://scontent.fbcdn.net/solace-profile.jpg",
    "caption": "solacesleepco.com",
    "linkDescription": "Free shipping. 100 night trial. Financing available.",
    "pageUrl": "https://www.facebook.com/solacesleepco",
    "pageCategories": [
      "Product/service",
      "Home decor"
    ],
    "pageLikes": 48200,
    "isReshared": false,
    "pageDeleted": false,
    "categories": [
      "Uncategorized"
    ]
  }
}

完整的参数与响应参考:这个接口的每个字段、类型和示例。

参考

一个请求,一种响应结构。

你发送的每个字段和收到的每个字段,都附有真实示例。

最近验证于 2026-11-14 · 可用率和延迟按 30d 统计

请求体

JSON,POST 到这个接口。

  • idstring

    962050096457659

    Meta 广告资料库的广告 ID(例如 "702369045530963")。提供 id 或 url 之一。

  • urlstring

    Meta 广告资料库的广告 URL(例如 "https://www.facebook.com/ads/library?id=1185617869915074")。提供 id 或 url 之一。

你发送。 一个简短的 JSON 请求体。显示的值只是示例,请换成你自己的。

响应

JSON,每个字段一个示例值。

datadata
  • activeboolean

    true

    Whether the ad is currently running.

  • adArchiveIdstring

    962050096457659

    Ad Library archive ID (stable identity). Populated whenever the provider has data for the entity.

  • captionstring

    solacesleepco.com

    Caption line of the ad creative, usually the advertiser's display domain.

  • categoriesstring[]

    Ad Library categories the ad is filed under.

  • ctaTextstring

    Shop Now

    Call-to-action label. Populated whenever the provider has data for the entity.

  • currencystring

    USD

    Spend currency, may be empty.

  • displayFormatstring

    VIDEO

    Ad creative format. Populated whenever the provider has data for the entity.

  • endDateinteger

    null

    Run end, epoch seconds.

  • isResharedboolean

    false

    Whether the ad creative is a reshare of another post.

  • linkDescriptionstring

    Free shipping. 100 night trial. Financing available.

    Description text shown under the ad's link.

  • linkUrlstring

    https://solacesleepco.com/weighted-blanket?utm_source=fb

    Creative destination URL. Populated whenever the provider has data for the entity.

  • pageCategoriesstring[]

    Categories Facebook lists the advertising page under.

  • pageDeletedboolean

    false

    Whether the advertising page has been deleted.

  • pageIdstring

    104882733481920

    Advertiser page ID (stable identity). Populated whenever the provider has data for the entity.

  • pageLikesinteger

    48200

    Like count of the advertising page.

  • pageNamestring

    Solace Sleep

    Advertiser page name. Populated whenever the provider has data for the entity.

  • pageProfilePicturestring

    https://scontent.fbcdn.net/solace-profile.jpg

    Profile picture of the advertising page. This is the advertiser's identity image, not ad creative.

  • pageUrlstring

    https://www.facebook.com/solacesleepco

    Canonical Facebook URL of the advertising page.

  • platformsstring[]

    Publisher platforms the ad runs on. Populated whenever the provider has data for the entity.

  • sourceUrlstring

    https://www.facebook.com/ads/library/?id=962050096457659

    Inspectable Meta Ad Library URL for this ad. Populated whenever the provider has data for the entity.

  • startDateinteger

    1757894400

    Run start, epoch seconds. Populated whenever the provider has data for the entity.

  • textstring

    Fall asleep 40% faster with the Solace weighted blanket. Engineered with glass microbeads for even pressure all night. Ships free, try it for 100 nights.

    Ad body text. Populated whenever the provider has data for the entity.

  • titlestring

    The blanket that ends 2am scrolling

    Creative title. Populated whenever the provider has data for the entity.

each creativedata.creatives[]

One entry per card of a carousel, dynamic-product, or dynamic-creative ad, in the order Meta returns them, each with its own text and destination. Single-creative ads return an empty array. The same card images and videos also appear in media. Meta CDN media URLs are signed and expire.

  • bodystring

    Card body text.

  • captionstring

    Card display caption, usually the destination domain.

  • ctaTextstring

    Card call-to-action label (e.g. "Shop Now").

  • ctaTypestring

    Card call-to-action type (e.g. "SHOP_NOW").

  • imagestring

    Card image URL. For a video card this is the poster frame.

  • linkDescriptionstring

    Card secondary description line.

  • linkUrlstring

    Card destination URL.

  • titlestring

    Card headline.

  • videoUrlstring

    Card video file URL (HD when supplied, otherwise SD). Present only on video cards.

each mediadata.media[]

Creative attached to the ad: one element per image, video, or carousel card, in the order the ad presents them. Empty when the ad has none.

  • heightinteger

    Pixel height of the media item, when the lane reports it.

  • typestring

    One of photo, video, or gif.

  • urlstring

    Image URL. For a video or GIF this is the poster/thumbnail frame.

  • videoUrlstring

    Playable video file URL. Present only for video and gif items.

  • widthinteger

    Pixel width of the media item, when the lane reports it.

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

你收到。 字段有名称、有类型,无论哪个数据源响应,结构都一样。

常见问题

关于 Facebook 广告详情 API

AnyAPI 的 Facebook 广告详情 API 只需一次 POST 请求 /v1/run/facebook.ad_details,就以统一格式的 JSON 返回 Facebook 数据。通过 ID 或 URL 查询 Meta 广告资料库中的单条广告,以干净的 JSON 返回广告主、创意文案、行动号召、投放平台和投放日期。AnyAPI 会在 2 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Facebook 广告详情 API 调用中有 99.3% 成功,响应时间中位数为 1.5 秒,共测量 13,156 次调用。

费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。

通过 ID 或 URL 查询 Meta 广告资料库中的单条广告,以干净的 JSON 返回广告主、创意文案、行动号召、投放平台和投放日期。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

过去 30 天,通过 AnyAPI 发起的 Facebook 广告详情 API 调用中有 99.3% 成功,响应时间中位数为 1.5 秒,共测量 13,156 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。

可以。新的 AnyAPI 账户自带 US$0.10 免费余额,无需绑卡,足够调用 83 次 Facebook 广告详情,每次 US$0.0012。

AnyAPI 会在同一个请求中依次尝试它的 2 个数据源,从最便宜的开始,所以一个数据源宕机不会让你的调用失败。

向 https://api.getanyapi.com/v1/run/facebook.ad_details 发送 POST 请求,在 “Authorization: Bearer” 请求头中放入你的 AnyAPI 密钥,并以 JSON 请求体传入参数。同一个密钥和同一个钱包适用于所有 AnyAPI 接口。

不需要。你向一个预付费的 AnyAPI 余额充值美元,每个请求从中扣费。没有月度套餐,也没有最低消费,同一个余额可用于所有 AnyAPI 接口。

有。TypeScript 用 npm 安装 @getanyapi/sdk,Python 用 pip 安装 getanyapi。两者都用同一个密钥调用所有 AnyAPI 接口,任何 HTTP 客户端也都可以。

可以。智能体可以连接 https://api.getanyapi.com/mcp 上的 AnyAPI MCP 服务器,或者向 https://api.getanyapi.com/agent/signup 发送一次无需认证的 POST 来创建自己的免费试用密钥,再通过 HTTP 调用这个接口。