Facebook Поиск рекламы API
Ищет в Meta Ad Library по ключевому слову и возвращает подходящие объявления (рекламодатель, текст креатива, CTA, платформы и даты показа) с постраничной выдачей по курсору.
1,10 USD/1 тыс. запросов, оплата за запрос, без подписки.
~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.",+17 ещё}
Цены и поставщики
Цена API Facebook Поиск рекламы: один API, поставщиков 4, и любой может заменить другого
Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.
Попробовать
Получите Facebook Поиск рекламы одним запросом
{
"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-10-07 · доступность и задержка измерены за 30d
Тело запроса
JSON, отправляется на этот эндпоинт.
- querystring
protein powder
Ключевое слово для поиска в Meta Ad Library (например, "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, по одному примеру значения на поле.
- foundboolean
true
- totalResultsnumberможет потребовать
214
- nextCursorstring
AQHRZ9d3f2k7m1x8c
- idstring
705513298640217
- sourceUrlstring
https://www.facebook.com/ads/library/?id=705513298640217
- pageIdstring
398201744920331
- pageNamestring
Vantage Nutrition
- activeboolean
true
- startDatenumber
1756512000
- endDatenumber
1758758400
- textstring
20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.
- titlestring
Protein that doesn't taste like chalk
- ctaTextstring
Shop Now
- ctaTypestring
SHOP_NOW
- linkUrlstring
https://vantagenutrition.com/protein
- displayFormatstring
IMAGE
- platforms[]string
facebook
- adCountnumber
3
- pageProfilePicturestring
https://scontent.fbcdn.net/vantage-profile.jpg
- captionstring
vantagenutrition.com
- linkDescriptionstring
Subscribe and save 20%. Cancel anytime.
- pageUrlstring
https://www.facebook.com/vantagenutrition
- pageCategories[]string
Product/service
- pageLikesnumber
61300
- isResharedboolean
false
- pageDeletedboolean
false
- categories[]string
Uncategorized
- typestring
photo
- urlstring
https://scontent.xx.fbcdn.net/v/t45.1600-4/vantage-protein-tub.jpg
- widthnumber
1080
- heightnumber
1080
Вопросы и ответы
Об API Facebook Поиск рекламы
AnyAPI Facebook Поиск рекламы API возвращает данные Facebook в виде нормализованного JSON одним вызовом POST к /v1/run/facebook.ads_search. Ищет в Meta Ad Library по ключевому слову и возвращает подходящие объявления (рекламодатель, текст креатива, CTA, платформы и даты показа) с постраничной выдачей по курсору. AnyAPI направляет каждый запрос по источникам (их 4) и автоматически переключается, если один из них отказывает. Это стоит от 1,10 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 100,0% вызовов Facebook Поиск рекламы через AnyAPI завершились успешно, медианное время ответа 2,7 с, измерено вызовов: 8 938.