Facebook 公司广告 API
通过公共主页 ID 或公司名称列出某家公司正在投放的 Meta 广告资料库广告（创意文案、格式、投放平台和投放日期），支持游标分页。
US$1.10/千次请求，按请求付费，无需订阅。
Trailhead 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.
trailheadoutdoors.com
Free returns within 60 days.
Trailhead Outdoors
Active · Sponsored
Our down quilt drops to 15F and packs down to the size of a grapefruit. Made for thru hikers who count every ounce.
trailheadoutdoors.com
Ships in 2 to 3 business days.
{"id": "1185617869915074","pageId": "281940573310482","pageName": "Trailhead Outdoors","active": true,"startDate": 1755302400,"endDate": 1758758400,"currency": "USD","text": "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.",... 还有 18 个字段}
价格与服务商
Facebook 公司广告 API 价格：一个 API，2 个可互换的服务商
最便宜的服务商优先响应。如果它失败，下一个会在同一次调用中接手。
试一试
一个请求获取 Facebook 公司广告
这个示例展示了 46 个字段中的 34 个。查看全部字段
{
"found": true,
"data": {
"nextCursor": "AbTr8k2m9x1v7c3q",
"totalResults": 18,
"ads": [
{
"id": "1185617869915074",
"pageId": "281940573310482",
"pageName": "Trailhead Outdoors",
"active": true,
"startDate": 1755302400,
"endDate": 1758758400,
"currency": "USD",
"text": "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.",
"displayFormat": "DCO",
"platforms": [
"facebook",
"instagram"
],
"adCount": 2,
"pageProfilePicture": "https://scontent.fbcdn.net/trailhead-profile.jpg",
"media": [
{
"type": "photo",
"url": "https://scontent.xx.fbcdn.net/v/t45.1600-4/wren-tent-creative-1.jpg",
"width": 1080,
"height": 1080
}
],
"caption": "trailheadoutdoors.com",
"linkDescription": "Free returns within 60 days.",
"pageUrl": "https://www.facebook.com/trailheadoutdoors",
"pageCategories": [
"Product/service",
"Outdoor recreation"
],
"pageLikes": 22400,
"isReshared": false,
"pageDeleted": false,
"categories": [
"Uncategorized"
],
"title": "The 3 season tent that packs to a water bottle",
"ctaText": "Shop Now",
"ctaType": "SHOP_NOW",
"linkUrl": "https://trailheadoutdoors.com/products/wren-2-tent"
},
{
"id": "1092837465210983",
"pageId": "281940573310482",
"pageName": "Trailhead Outdoors",
"active": true,
"startDate": 1753488000,
"endDate": 1759104000,
"currency": "USD",
"text": "Our down quilt drops to 15F and packs down to the size of a grapefruit. Made for thru hikers who count every ounce.",
"displayFormat": "IMAGE",
"platforms": [
"facebook",
"instagram",
"messenger"
],
"adCount": 1,
"pageProfilePicture": "https://scontent.fbcdn.net/trailhead-profile.jpg",
"media": [
{
"type": "photo",
"url": "https://scontent.xx.fbcdn.net/v/t45.1600-4/trailhead-quilt-creative.jpg",
"width": 1080,
"height": 1350
}
],
"caption": "trailheadoutdoors.com",
"linkDescription": "Ships in 2 to 3 business days.",
"pageUrl": "https://www.facebook.com/trailheadoutdoors",
"pageCategories": [
"Product/service",
"Outdoor recreation"
],
"pageLikes": 22400,
"isReshared": false,
"pageDeleted": false,
"categories": [
"Uncategorized"
],
"title": "15F down quilt, packs to a grapefruit",
"ctaText": "Shop Now",
"ctaType": "SHOP_NOW",
"linkUrl": "https://trailheadoutdoors.com/products/down-quilt-15f"
}
]
}
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
一个请求，一种响应结构。
你发送的每个字段和收到的每个字段，都附有真实示例。
最近验证于 2026-11-14 · 可用率和延迟按 30d 统计
请求体
JSON，POST 到这个接口。
- companyNamestring
Trailhead Outdoors
要搜索的公司名称（例如 "nike"）。在 Meta 广告资料库索引中精确匹配且区分大小写；没有已索引主页的广告主会返回 found:false。
- countrystring
用于限定结果范围的两字母国家代码。默认包含所有国家。
- cursorstring
上一次响应的 nextCursor 返回的不透明分页游标。
- endDatestring
筛选在此日期或之前有展示的广告，格式为 YYYY-MM-DD。
- languagestring
用于筛选广告的两字母语言代码（例如 "EN"、"ES"、"FR"）。
- mediaTypeenum
创意媒体类型筛选。
- pageIdstring
公司在广告资料库中的公共主页 ID。提供 pageId 或 companyName 之一。
- sortByenum
recent
排序方式：impressions（展示量从高到低，默认）或 recent（最新）。
- startDatestring
筛选在此日期或之后有展示的广告，格式为 YYYY-MM-DD。
- statusenum
广告状态筛选。默认为 ACTIVE。
响应
JSON，每个字段一个示例值。
- activeboolean
true
- adCountinteger
2
Number of ads in this campaign (collation count). Null when the source does not report it.
- captionstring
trailheadoutdoors.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 button label on the ad.
- ctaTypestring
SHOP_NOW
Call-to-action button type on the ad, e.g. "SHOP_NOW".
- currencystring
USD
- displayFormatstring
DCO
Populated whenever the provider has data for the entity.
- endDateinteger
1758758400
Epoch seconds.
- idstring
1185617869915074
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
Free returns within 60 days.
Description text shown under the ad's link.
- linkUrlstring
https://trailheadoutdoors.com/products/wren-2-tent
Destination URL the ad links to.
- pageCategoriesstring[]
Categories Facebook lists the advertising page under.
- pageDeletedboolean
false
Whether the advertising page has been deleted.
- pageIdstring
281940573310482
Populated whenever the provider has data for the entity.
- pageLikesinteger
22400
Like count of the advertising page.
- pageNamestring
Trailhead Outdoors
Populated whenever the provider has data for the entity.
- pageProfilePicturestring
https://scontent.fbcdn.net/trailhead-profile.jpg
Profile picture of the advertising page. This is the advertiser's identity image, not ad creative.
- pageUrlstring
https://www.facebook.com/trailheadoutdoors
Canonical Facebook URL of the advertising page.
- platformsstring[]
Populated whenever the provider has data for the entity.
- startDateinteger
1755302400
Epoch seconds. Populated whenever the provider has data for the entity.
- textstring
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.
- titlestring
The 3 season tent that packs to a water bottle
Headline of the ad creative.
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/wren-tent-creative-1.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
AbTr8k2m9x1v7c3q
Opaque cursor for the next page of ads, or null when this lane has no more. Pass it back as cursor to continue.
- totalResultsinteger
18
Total number of ads Facebook reports for the page.
- 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.company_ads，就以统一格式的 JSON 返回 Facebook 数据。通过公共主页 ID 或公司名称列出某家公司正在投放的 Meta 广告资料库广告（创意文案、格式、投放平台和投放日期），支持游标分页。AnyAPI 会在 2 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$1.10 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Facebook 公司广告 API 调用中有 99.9% 成功，响应时间中位数为 1.5 秒，共测量 442,678 次调用。