Facebook API

Facebook 广告详情(完整版) API

获取 Meta 广告资料库中的一条广告及其创意:每个轮播变体、图片和视频 URL、标题、正文和行动号召。

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

fMeta Ad Library
facebook.com/ads/library/?id=1185617869915074
Meta
United StatesiAll adsTrailhead Outdoors

Trailhead Outdoors

Active · Sponsored

Built from 20D ripstop nylon, the Wren 2 tent weighs 2.1 lbs and sets up in under 90 seconds. Backed by our lifetime warranty.

photo

trailheadoutdoors.com

Free returns within 60 days. Ships in 2 to 3 business days.

Shop Now
Library ID: 1185617869915074FBIG

Ad details

Status
Active
Started running on
August 16, 2025
Library ID
1185617869915074
API 返回的内容
{
"adArchiveId": "1185617869915074",
"sourceUrl": "https://www.facebook.com/ads/library/?id=1185617869915074",
"pageId": "281940573310482",
"pageName": "Trailhead Outdoors",
"pageUrl": "https://www.facebook.com/trailheadoutdoors",
"pageImage": "https://scontent.fbcdn.net/trailhead-profile.jpg",
"active": true,
"startedUtc": 1755302400,
... 还有 18 个字段
}
可用率
99.59%
30d · 727 次调用
请求数
727
30d · 按周,近 12 周
响应时间
8.1s
中位数 · 30d

价格

Facebook 广告详情(完整版) API 价格

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

试一试

一个请求获取 Facebook 广告详情(完整版)

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

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

{
  "found": true,
  "data": {
    "adArchiveId": "1185617869915074",
    "sourceUrl": "https://www.facebook.com/ads/library/?id=1185617869915074",
    "pageId": "281940573310482",
    "pageName": "Trailhead Outdoors",
    "pageUrl": "https://www.facebook.com/trailheadoutdoors",
    "pageImage": "https://scontent.fbcdn.net/trailhead-profile.jpg",
    "active": true,
    "startedUtc": 1755302400,
    "endedUtc": 1758758400,
    "displayFormat": "DCO",
    "title": "The 3 season tent that packs to a water bottle",
    "body": "Built from 20D ripstop nylon, the Wren 2 tent weighs 2.1 lbs and sets up in under 90 seconds. Backed by our lifetime warranty.",
    "caption": "trailheadoutdoors.com",
    "linkUrl": "https://trailheadoutdoors.com/products/wren-2-tent",
    "linkDescription": "Free returns within 60 days. Ships in 2 to 3 business days.",
    "ctaText": "Shop Now",
    "ctaType": "SHOP_NOW",
    "platforms": [
      "facebook",
      "instagram"
    ],
    "pageCategories": [
      "Product/service",
      "Outdoor recreation"
    ],
    "pageLikes": 22400,
    "isReshared": false,
    "pageDeleted": false,
    "categories": [
      "Uncategorized"
    ]
  }
}

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

参考

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

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

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

请求体

JSON,POST 到这个接口。

  • idstring

    1185617869915074

    Meta 广告资料库的广告 ID,即广告资料库 URL 中的数字 ID(例如从 https://www.facebook.com/ads/library/?id=962050096457659 中取 "962050096457659")。

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

响应

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

datadata
  • activeboolean

    true

    Whether the ad is currently running.

  • adArchiveIdstring

    1185617869915074

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

  • bodystring

    Built from 20D ripstop nylon, the Wren 2 tent weighs 2.1 lbs and sets up in under 90 seconds. Backed by our lifetime warranty.

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

  • captionstring

    trailheadoutdoors.com

    Display caption, usually the destination domain.

  • categoriesstring[]

    Ad Library categories the ad is filed under.

  • ctaTextstring

    Shop Now

    Call-to-action label (e.g. "Shop now").

  • ctaTypestring

    SHOP_NOW

    Call-to-action type (e.g. "SHOP_NOW").

  • displayFormatstring

    DCO

    Ad creative format (e.g. "DPA", "VIDEO", "IMAGE"). Populated whenever the provider has data for the entity.

  • endedUtcnumber

    1758758400

    Run end, or last-seen date while the ad is still running. UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • isResharedboolean

    false

    Whether the ad creative is a reshare of another post.

  • linkDescriptionstring

    Free returns within 60 days. Ships in 2 to 3 business days.

    Secondary link description line.

  • linkUrlstring

    https://trailheadoutdoors.com/products/wren-2-tent

    Creative destination URL.

  • pageCategoriesstring[]

    Categories Facebook lists the advertising page under.

  • pageDeletedboolean

    false

    Whether the advertising page has been deleted.

  • pageIdstring

    281940573310482

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

  • pageImagestring

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

    Advertiser page profile picture URL. Meta CDN URLs are signed and expire.

  • pageLikesinteger

    22400

    Like count of the advertising page.

  • pageNamestring

    Trailhead Outdoors

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

  • pageUrlstring

    https://www.facebook.com/trailheadoutdoors

    Advertiser page URL.

  • platformsstring[]

    Publisher platforms the ad runs on.

  • sourceUrlstring

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

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

  • startedUtcnumber

    1755302400

    Run start. UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • titlestring

    The 3 season tent that packs to a water bottle

    Creative headline. Dynamic-product ads return a template such as "{{product.name}}".

each creativedata.creatives[]

One entry per creative variant of a carousel or dynamic ad, in the order Meta returns them. Single-creative ads return an empty array and carry their media in images/videos. Meta CDN media URLs are signed and expire, so fetch what you need at read time.

  • bodystring

    Variant body text.

  • captionstring

    Variant display caption.

  • ctaTextstring

    Variant call-to-action label.

  • ctaTypestring

    Variant call-to-action type.

  • imagestring

    Original creative image URL.

  • imageResizedstring

    Resized creative image URL.

  • linkDescriptionstring

    Variant secondary description.

  • linkUrlstring

    Variant destination URL.

  • titlestring

    Variant headline.

  • videoPreviewImagestring

    Poster frame for the creative video.

  • videoUrlstring

    Creative video URL (HD when supplied, otherwise SD).

each imagedata.images[]

Standalone creative images for a single-image ad. Meta CDN media URLs are signed and expire.

  • imagestring

    Original creative image URL.

  • imageResizedstring

    Resized creative image URL.

each videodata.videos[]

Standalone creative videos for a single-video ad. Meta CDN media URLs are signed and expire.

  • videoPreviewImagestring

    Poster frame for the creative video.

  • videoUrlstring

    Creative video URL (HD when supplied, otherwise SD).

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_full,就以统一格式的 JSON 返回 Facebook 数据。获取 Meta 广告资料库中的一条广告及其创意:每个轮播变体、图片和视频 URL、标题、正文和行动号召。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$3.74 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Facebook 广告详情(完整版) API 调用中有 99.6% 成功,响应时间中位数为 8.1 秒,共测量 727 次调用。

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

获取 Meta 广告资料库中的一条广告及其创意:每个轮播变体、图片和视频 URL、标题、正文和行动号召。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

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

可以。新的 AnyAPI 账户自带 US$0.10 免费余额,无需绑卡,足够调用 26 次 Facebook 广告详情(完整版),每次 US$0.00374。

向 https://api.getanyapi.com/v1/run/facebook.ad_details_full 发送 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 调用这个接口。