Facebook Реклама компании API
Список объявлений Meta Ad Library, которые показывает компания, по ID страницы или названию компании (текст креатива, формат, платформы и даты показа) с постраничной выдачей по курсору.
1,10 USD/1 тыс. запросов, оплата за запрос, без подписки.
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}
Цены и поставщики
Цена API Facebook Реклама компании: один API, поставщиков 2, и любой может заменить другого
Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.
Попробовать
Получите Facebook Реклама компании одним запросом
В этом примере показано полей: 34 из 46. Все поля
{
"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-21 · доступность и задержка измерены за 30d
Тело запроса
JSON, отправляется на этот эндпоинт.
- companyNamestring
Trailhead Outdoors
Название компании для поиска (например, "nike"). Точное совпадение с учётом регистра по индексу Meta Ad Library; у рекламодателя без проиндексированной страницы вернётся found:false.
- countrystring
Двухбуквенный код страны для ограничения результатов. По умолчанию все страны.
- cursorstring
Непрозрачный курсор постраничной выдачи из nextCursor предыдущего ответа.
- endDatestring
Только объявления с показами в эту дату или раньше, в формате YYYY-MM-DD.
- languagestring
Двухбуквенный код языка для фильтрации объявлений (например, "EN", "ES", "FR").
- mediaTypeenum
Фильтр по типу креатива.
- pageIdstring
ID страницы компании в Ad Library. Укажите 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? Полная схема, которую должен возвращать ваш эндпоинт.
Вопросы и ответы
Об API Facebook Реклама компании
AnyAPI Facebook Реклама компании API возвращает данные Facebook в виде нормализованного JSON одним вызовом POST к /v1/run/facebook.company_ads. Список объявлений Meta Ad Library, которые показывает компания, по ID страницы или названию компании (текст креатива, формат, платформы и даты показа) с постраничной выдачей по курсору. AnyAPI направляет каждый запрос по источникам (их 2) и автоматически переключается, если один из них отказывает. Это стоит от 1,10 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 99,9% вызовов Facebook Реклама компании через AnyAPI завершились успешно, медианное время ответа 1,5 с, измерено вызовов: 542 716.