Facebook 广告搜索 API
按关键词搜索 Meta 广告资料库，返回匹配的广告（广告主、创意文案、CTA、投放平台和投放日期），支持游标分页。
US$1.10/千次请求，按请求付费，无需订阅。
~214 results
Vantage Nutrition
Active · Sponsored
20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.
vantagenutrition.com
Subscribe and save 20%. Cancel anytime.
PureForm Labs
Active · Sponsored
Plant based protein powder with 25g per scoop and no bloating. Third party tested, banned substance free.
pureformlabs.com
Free shipping on orders over $40.
{"id": "705513298640217","sourceUrl": "https://www.facebook.com/ads/library/?id=705513298640217","pageId": "398201744920331","pageName": "Vantage Nutrition","active": true,"startDate": 1756512000,"endDate": 1758758400,"text": "20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.",... 还有 18 个字段}
价格与服务商
Facebook 广告搜索 API 价格：一个 API，4 个可互换的服务商
最便宜的服务商优先响应。如果它失败，下一个会在同一次调用中接手。
试一试
一个请求获取 Facebook 广告搜索
这个示例展示了 46 个字段中的 35 个。查看全部字段
{
"found": true,
"data": {
"totalResults": 214,
"nextCursor": "AQHRZ9d3f2k7m1x8c",
"ads": [
{
"id": "705513298640217",
"sourceUrl": "https://www.facebook.com/ads/library/?id=705513298640217",
"pageId": "398201744920331",
"pageName": "Vantage Nutrition",
"active": true,
"startDate": 1756512000,
"endDate": 1758758400,
"text": "20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.",
"title": "Protein that doesn't taste like chalk",
"ctaText": "Shop Now",
"ctaType": "SHOP_NOW",
"linkUrl": "https://vantagenutrition.com/protein",
"displayFormat": "IMAGE",
"platforms": [
"facebook",
"instagram"
],
"adCount": 3,
"pageProfilePicture": "https://scontent.fbcdn.net/vantage-profile.jpg",
"media": [
{
"type": "photo",
"url": "https://scontent.xx.fbcdn.net/v/t45.1600-4/vantage-protein-tub.jpg",
"width": 1080,
"height": 1080
}
],
"caption": "vantagenutrition.com",
"linkDescription": "Subscribe and save 20%. Cancel anytime.",
"pageUrl": "https://www.facebook.com/vantagenutrition",
"pageCategories": [
"Product/service",
"Health/beauty"
],
"pageLikes": 61300,
"isReshared": false,
"pageDeleted": false,
"categories": [
"Uncategorized"
]
},
{
"id": "592047718834105",
"sourceUrl": "https://www.facebook.com/ads/library/?id=592047718834105",
"pageId": "711029384710556",
"pageName": "PureForm Labs",
"active": true,
"startDate": 1757203200,
"endDate": 1759363200,
"text": "Plant based protein powder with 25g per scoop and no bloating. Third party tested, banned substance free.",
"title": "25g of plant protein, zero bloat",
"ctaText": "Learn More",
"ctaType": "LEARN_MORE",
"linkUrl": "https://pureformlabs.com/plant-protein",
"displayFormat": "VIDEO",
"platforms": [
"facebook",
"instagram",
"messenger"
],
"adCount": 1,
"pageProfilePicture": "https://scontent.fbcdn.net/pureform-profile.jpg",
"media": [
{
"type": "video",
"url": "https://scontent.xx.fbcdn.net/v/t42.1790-2/pureform-protein-poster.jpg",
"videoUrl": "https://video.xx.fbcdn.net/v/t42.9040-2/pureform-protein-ad.mp4",
"width": 1080,
"height": 1350
}
],
"caption": "pureformlabs.com",
"linkDescription": "Free shipping on orders over $40.",
"pageUrl": "https://www.facebook.com/pureformlabs",
"pageCategories": [
"Product/service",
"Health/beauty"
],
"pageLikes": 18900,
"isReshared": false,
"pageDeleted": false,
"categories": [
"Uncategorized"
]
}
]
}
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
一个请求，一种响应结构。
你发送的每个字段和收到的每个字段，都附有真实示例。
最近验证于 2026-11-14 · 可用率和延迟按 30d 统计
请求体
JSON，POST 到这个接口。
- querystring
protein powder
在 Meta 广告资料库中搜索的关键词（例如 "protein powder"）。
- adTypeenum
限定为全部广告（默认）或仅政治和社会议题广告。
- countrystring
US
用于限定结果范围的两字母国家代码。省略则包含所有国家。
- cursorstring
上一次响应的 nextCursor 返回的不透明分页游标。
- endDatestring
筛选在此日期或之前有展示的广告，格式为 YYYY-MM-DD。
- mediaTypeenum
创意媒体类型筛选。
- requireFieldsarray
可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `totalResults`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某条广告确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。
- searchTypeenum
keyword_exact_phrase
查询的匹配方式：宽松关键词匹配（keyword_unordered，默认）或精确短语匹配（keyword_exact_phrase）。
- sortByenum
排序方式：impressions（展示量从高到低，默认）或 recent（最新）。
- startDatestring
筛选在此日期或之后有展示的广告，格式为 YYYY-MM-DD。
- statusenum
广告状态筛选。
响应
JSON，每个字段一个示例值。
- activeboolean
true
- adCountinteger
3
Number of ads in this campaign (collation count). Null when the source does not report it.
- captionstring
vantagenutrition.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
Populated whenever the provider has data for the entity.
- ctaTypestring
SHOP_NOW
Populated whenever the provider has data for the entity.
- displayFormatstring
IMAGE
Populated whenever the provider has data for the entity.
- endDateinteger
1758758400
Epoch seconds.
- idstring
705513298640217
Ad Library archive ID. Populated whenever the provider has data for the entity.
- isResharedboolean
false
Whether the ad creative is a reshare of another post.
- linkDescriptionstring
Subscribe and save 20%. Cancel anytime.
Description text shown under the ad's link.
- linkUrlstring
https://vantagenutrition.com/protein
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
398201744920331
Populated whenever the provider has data for the entity.
- pageLikesinteger
61300
Like count of the advertising page.
- pageNamestring
Vantage Nutrition
Populated whenever the provider has data for the entity.
- pageProfilePicturestring
https://scontent.fbcdn.net/vantage-profile.jpg
Profile picture of the advertising page. This is the advertiser's identity image, not ad creative.
- pageUrlstring
https://www.facebook.com/vantagenutrition
Canonical Facebook URL of the advertising page.
- platformsstring[]
Populated whenever the provider has data for the entity.
- sourceUrlstring
https://www.facebook.com/ads/library/?id=705513298640217
Inspectable Meta Ad Library URL for this ad. Populated whenever the provider has data for the entity.
- startDateinteger
1756512000
Epoch seconds. Populated whenever the provider has data for the entity.
- textstring
20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.
Ad body text. Populated whenever the provider has data for the entity.
- titlestring
Protein that doesn't taste like chalk
Populated whenever the provider has data for the entity.
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.
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
1080
Pixel height of the media item, when the lane reports it.
- typestring
photo
One of photo, video, or gif.
- urlstring
https://scontent.xx.fbcdn.net/v/t45.1600-4/vantage-protein-tub.jpg
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
1080
Pixel width of the media item, when the lane reports it.
- nextCursorstring
AQHRZ9d3f2k7m1x8c
Opaque cursor for the next page of ads, or null when this lane has no more. Pass it back as cursor to continue.
- totalResultsinteger可设为必填
214
Total number of ads matching the search. Null when the source cannot report an exact count.
- 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.
你在出售这个 API？查看你的接口必须返回的完整数据结构。
常见问题
关于 Facebook 广告搜索 API
AnyAPI 的 Facebook 广告搜索 API 只需一次 POST 请求 /v1/run/facebook.ads_search，就以统一格式的 JSON 返回 Facebook 数据。按关键词搜索 Meta 广告资料库，返回匹配的广告（广告主、创意文案、CTA、投放平台和投放日期），支持游标分页。AnyAPI 会在 4 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$1.10 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Facebook 广告搜索 API 调用中有 99.2% 成功，响应时间中位数为 1.7 秒，共测量 384,018 次调用。