Facebook 广告详情 API

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

POST/v1/run/facebook.ad_details

可用率

100.00%

30d · 63 次调用

请求数

30d · 按周，近 12 周

响应时间

2.5s

中位数 · 30d

价格

一个价格，以美元计

服务商

Giraffe已服务 63可用率 100.00%2382ms p50100.00% (63 次调用)2382ms (63 次调用)63US$1.20/千次请求固定价

试一试

发出你的第一个请求

idstringMeta 广告资料库的广告 ID（例如 "702369045530963"）。提供 id 或 url 之一。urlstringMeta 广告资料库的广告 URL（例如 "https://www.facebook.com/ads/library?id=1185617869915074"）。提供 id 或 url 之一。

打开于提示词已复制

获取免费密钥

示例响应

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

{
  "data": {
    "active": true,
    "adArchiveId": "a1b2c3d4",
    "caption": "A short example description of this item.",
    "categories": [
      "example"
    ],
    "ctaText": "A short example description of this item.",
    "currency": "USD",
    "displayFormat": "example",
    "endDate": 42,
    "isReshared": true,
    "linkDescription": "https://example.com/page",
    "linkUrl": "https://example.com/page",
    "media": [
      {
        "height": 42,
        "type": "general",
        "url": "https://example.com/page",
        "videoUrl": "https://example.com/page",
        "width": 1024
      }
    ],
    "pageCategories": [
      "example"
    ],
    "pageDeleted": false,
    "pageId": "a1b2c3d4",
    "pageLikes": 12500,
    "pageName": "Example title",
    "pageProfilePicture": "https://example.com/image.jpg",
    "pageUrl": "https://example.com/page",
    "platforms": [
      "example"
    ],
    "sourceUrl": "https://example.com/page",
    "startDate": 42,
    "text": "A short example description of this item.",
    "title": "Example title"
  },
  "found": true,
  "reason": "not_found"
}

响应类型定义

interface FacebookAdDetailsResponse {
  data: {
    active?: boolean | null;
    adArchiveId: string;
    caption?: string;
    categories?: string[];
    ctaText?: string | null;
    currency?: string | null;
    displayFormat?: string | null;
    endDate?: number | null;
    isReshared?: boolean;
    linkDescription?: string;
    linkUrl?: string | null;
    media?: {
      height?: number;
      type: string;
      url: string;
      videoUrl?: string;
      width?: number;
    }[];
    pageCategories?: string[];
    pageDeleted?: boolean;
    pageId: string;
    pageLikes?: number;
    pageName?: string | null;
    pageProfilePicture?: string;
    pageUrl?: string;
    platforms?: string[] | null;
    sourceUrl: string;
    startDate?: number | null;
    text?: string | null;
    title?: string | null;
  } | null;
  found: boolean;
  reason?: "not_found";
}

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

参考

请求、响应与价格

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

POST /v1/run/facebook.ad_details

curl -X POST https://api.getanyapi.com/v1/run/facebook.ad_details \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"962050096457659"}'

字段	类型	示例值
请求体
id	string	"962050096457659"Meta 广告资料库的广告 ID（例如 "702369045530963"）。提供 id 或 url 之一。
url	string	Meta 广告资料库的广告 URL（例如 "https://www.facebook.com/ads/library?id=1185617869915074"）。提供 id 或 url 之一。
响应
data	object
data.active	boolean	Whether the ad is currently running.
data.adArchiveId	string	Ad Library archive ID (stable identity). Populated whenever the provider has data for the entity.
data.caption	string	Caption line of the ad creative, usually the advertiser's display domain.
data.categories	string[]	Ad Library categories the ad is filed under.
data.ctaText	string	Call-to-action label. Populated whenever the provider has data for the entity.
data.currency	string	Spend currency, may be empty.
data.displayFormat	string	Ad creative format. Populated whenever the provider has data for the entity.
data.endDate	integer	Run end, epoch seconds.
data.isReshared	boolean	Whether the ad creative is a reshare of another post.
data.linkDescription	string	Description text shown under the ad's link.
data.linkUrl	string	Creative destination URL. Populated whenever the provider has data for the entity.
data.media	object[]	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.
data.media[].height	integer	Pixel height of the media item, when the lane reports it.
data.media[].type	string	One of photo, video, or gif.
data.media[].url	string	Image URL. For a video or GIF this is the poster/thumbnail frame.
data.media[].videoUrl	string	Playable video file URL. Present only for video and gif items.
data.media[].width	integer	Pixel width of the media item, when the lane reports it.
data.pageCategories	string[]	Categories Facebook lists the advertising page under.
data.pageDeleted	boolean	Whether the advertising page has been deleted.
data.pageId	string	Advertiser page ID (stable identity). Populated whenever the provider has data for the entity.
data.pageLikes	integer	Like count of the advertising page.
data.pageName	string	Advertiser page name. Populated whenever the provider has data for the entity.
data.pageProfilePicture	string	Profile picture of the advertising page. This is the advertiser's identity image, not ad creative.
data.pageUrl	string	Canonical Facebook URL of the advertising page.
data.platforms	string[]	Publisher platforms the ad runs on. Populated whenever the provider has data for the entity.
data.sourceUrl	string	Inspectable Meta Ad Library URL for this ad. Populated whenever the provider has data for the entity.
data.startDate	integer	Run start, epoch seconds. Populated whenever the provider has data for the entity.
data.text	string	Ad body text. Populated whenever the provider has data for the entity.
data.title	string	Creative title. Populated whenever the provider has data for the entity.
found	boolean
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.
价格
每次请求价格	USD	US$0.0012
价格（/千次请求）	USD	US$1.20

常见问题

关于 Facebook 广告详情 API

AnyAPI 的 Facebook 广告详情 API 只需一次 POST 请求 /v1/run/facebook.ad_details，就以统一格式的 JSON 返回 Facebook 数据。通过 ID 或 URL 查询 Meta 广告资料库中的单条广告，以干净的 JSON 返回广告主、创意文案、行动号召、投放平台和投放日期。无论哪个数据源提供服务，AnyAPI 都返回同一套统一的 schema。费用：每千次请求 US$1.20 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Facebook 广告详情 API 调用中有 100.0% 成功，响应时间中位数为 2.5 秒，共测量 63 次调用。

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

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

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

更多接口

Facebook 的其他接口

一个密钥，一个钱包，
开始你的第一次 Facebook 调用。

领取 ~150 次免费请求

Facebook 广告详情 API

一个价格，以美元计

发出你的第一个请求

请求、响应与价格

关于 Facebook 广告详情 API

Facebook 广告详情 API 怎么收费？

Facebook 广告详情 API 返回什么？

Facebook 广告详情 API 的可靠性如何？

Facebook 的其他接口

一个密钥，一个钱包，开始你的第一次 Facebook 调用。

一个密钥，一个钱包，
开始你的第一次 Facebook 调用。