Facebook API

Facebook 广告详情（完整版） API

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

POST/v1/run/facebook.ad_details_full
可用率
100.00%
30d · 26 次调用
请求数
26
30d · 按周，近 12 周
响应时间
9.9s
中位数 · 30d

价格

一个价格，以美元计

试一试

发出你的第一个请求

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "active": true,
    "adArchiveId": "a1b2c3d4",
    "body": "A short example description of this item.",
    "caption": "A short example description of this item.",
    "categories": [
      "example"
    ],
    "creatives": [
      {
        "body": "A short example description of this item.",
        "caption": "A short example description of this item.",
        "ctaText": "A short example description of this item.",
        "ctaType": "general",
        "image": "https://example.com/image.jpg",
        "imageResized": "https://example.com/image.jpg",
        "linkDescription": "https://example.com/page",
        "linkUrl": "https://example.com/page",
        "title": "Example title",
        "videoPreviewImage": "https://example.com/image.jpg",
        "videoUrl": "https://example.com/page"
      }
    ],
    "ctaText": "A short example description of this item.",
    "ctaType": "general",
    "displayFormat": "example",
    "endedUtc": 12.5,
    "images": [
      {
        "image": "https://example.com/image.jpg",
        "imageResized": "https://example.com/image.jpg"
      }
    ],
    "isReshared": true,
    "linkDescription": "https://example.com/page",
    "linkUrl": "https://example.com/page",
    "pageCategories": [
      "example"
    ],
    "pageDeleted": false,
    "pageId": "a1b2c3d4",
    "pageImage": "https://example.com/image.jpg",
    "pageLikes": 12500,
    "pageName": "Example title",
    "pageUrl": "https://example.com/page",
    "platforms": [
      "example"
    ],
    "sourceUrl": "https://example.com/page",
    "startedUtc": 12.5,
    "title": "Example title",
    "videos": [
      {
        "videoPreviewImage": "https://example.com/image.jpg",
        "videoUrl": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface FacebookAdDetailsFullResponse {
  data: {
    active?: boolean;
    adArchiveId: string;
    body?: string;
    caption?: string;
    categories?: string[];
    creatives?: {
      body?: string;
      caption?: string;
      ctaText?: string;
      ctaType?: string;
      image?: string;
      imageResized?: string;
      linkDescription?: string;
      linkUrl?: string;
      title?: string;
      videoPreviewImage?: string;
      videoUrl?: string;
    }[];
    ctaText?: string;
    ctaType?: string;
    displayFormat?: string;
    endedUtc?: number;
    images?: {
      image?: string;
      imageResized?: string;
    }[];
    isReshared?: boolean;
    linkDescription?: string;
    linkUrl?: string;
    pageCategories?: string[];
    pageDeleted?: boolean;
    pageId: string;
    pageImage?: string;
    pageLikes?: number;
    pageName?: string;
    pageUrl?: string;
    platforms?: string[];
    sourceUrl: string;
    startedUtc?: number;
    title?: string;
    videos?: {
      videoPreviewImage?: string;
      videoUrl?: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

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

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/facebook.ad_details_full
curl -X POST https://api.getanyapi.com/v1/run/facebook.ad_details_full \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"962050096457659"}'
字段类型示例值
请求体
idstring"962050096457659"Meta 广告资料库的广告 ID，即广告资料库 URL 中的数字 ID（例如从 https://www.facebook.com/ads/library/?id=962050096457659 中取 "962050096457659"）。
响应
dataobject
data.activebooleanWhether the ad is currently running.
data.adArchiveIdstringAd Library archive ID (stable identity). Populated whenever the provider has data for the entity.
data.bodystringAd body text. Populated whenever the provider has data for the entity.
data.captionstringDisplay caption, usually the destination domain.
data.categoriesstring[]Ad Library categories the ad is filed under.
data.creativesobject[]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.
data.creatives[].bodystringVariant body text.
data.creatives[].captionstringVariant display caption.
data.creatives[].ctaTextstringVariant call-to-action label.
data.creatives[].ctaTypestringVariant call-to-action type.
data.creatives[].imagestringOriginal creative image URL.
data.creatives[].imageResizedstringResized creative image URL.
data.creatives[].linkDescriptionstringVariant secondary description.
data.creatives[].linkUrlstringVariant destination URL.
data.creatives[].titlestringVariant headline.
data.creatives[].videoPreviewImagestringPoster frame for the creative video.
data.creatives[].videoUrlstringCreative video URL (HD when supplied, otherwise SD).
data.ctaTextstringCall-to-action label (e.g. "Shop now").
data.ctaTypestringCall-to-action type (e.g. "SHOP_NOW").
data.displayFormatstringAd creative format (e.g. "DPA", "VIDEO", "IMAGE"). Populated whenever the provider has data for the entity.
data.endedUtcnumberRun 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.
data.imagesobject[]Standalone creative images for a single-image ad. Meta CDN media URLs are signed and expire.
data.images[].imagestringOriginal creative image URL.
data.images[].imageResizedstringResized creative image URL.
data.isResharedbooleanWhether the ad creative is a reshare of another post.
data.linkDescriptionstringSecondary link description line.
data.linkUrlstringCreative destination URL.
data.pageCategoriesstring[]Categories Facebook lists the advertising page under.
data.pageDeletedbooleanWhether the advertising page has been deleted.
data.pageIdstringAdvertiser page ID (stable identity). Populated whenever the provider has data for the entity.
data.pageImagestringAdvertiser page profile picture URL. Meta CDN URLs are signed and expire.
data.pageLikesintegerLike count of the advertising page.
data.pageNamestringAdvertiser page name. Populated whenever the provider has data for the entity.
data.pageUrlstringAdvertiser page URL.
data.platformsstring[]Publisher platforms the ad runs on.
data.sourceUrlstringInspectable Meta Ad Library URL for this ad. Populated whenever the provider has data for the entity.
data.startedUtcnumberRun start. UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.titlestringCreative headline. Dynamic-product ads return a template such as "{{product.name}}".
data.videosobject[]Standalone creative videos for a single-video ad. Meta CDN media URLs are signed and expire.
data.videos[].videoPreviewImagestringPoster frame for the creative video.
data.videos[].videoUrlstringCreative video URL (HD when supplied, otherwise SD).
foundboolean
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.
价格
每次请求价格USDUS$0.00462
价格（/千次请求）USDUS$4.62

常见问题

关于 Facebook 广告详情（完整版） API

AnyAPI 的 Facebook 广告详情（完整版） API 只需一次 POST 请求 /v1/run/facebook.ad_details_full，就以统一格式的 JSON 返回 Facebook 数据。获取 Meta 广告资料库中的一条广告及其创意：每个轮播变体、图片和视频 URL、标题、正文和行动号召。无论哪个数据源提供服务，AnyAPI 都返回同一套统一的 schema。费用：每千次请求 US$4.62 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Facebook 广告详情（完整版） API 调用中有 100.0% 成功，响应时间中位数为 9.9 秒，共测量 26 次调用。

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

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

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

Facebook 的其他接口

主页/千次请求 US$1.20 起主页帖子/千次请求 US$1.20 起帖子/千次请求 US$1.20 起帖子评论/千次请求 US$1.20 起主页 Reels/千次请求 US$1.20 起广告详情/千次请求 US$1.20 起广告转录文本/千次请求 US$1.20 起广告搜索/千次请求 US$1.20 起评论回复/千次请求 US$1.20 起公司广告/千次请求 US$1.20 起活动详情/千次请求 US$1.20 起活动/千次请求 US$1.20 起活动搜索/千次请求 US$1.20 起粉丝/千条结果 US$6.00 起小组帖子/千次请求 US$1.20 起Marketplace/千次请求 US$1.20 起Marketplace 商品/千次请求 US$1.20 起Marketplace 地点搜索/千次请求 US$1.20 起公共主页联系方式/千次请求 US$1.20 起查找公共主页/千次请求 US$9.75 起照片/千次请求 US$1.20 起帖子转录文本/千次请求 US$1.20 起主页活动/千次请求 US$1.20 起搜索公司/千次请求 US$1.20 起搜索公共主页/千条结果 US$11.18 起搜索帖子/千次请求 US$30.00 起