API Facebook

Facebook Поиск рекламы API

Ищет в Meta Ad Library по ключевому слову и возвращает подходящие объявления (рекламодатель, текст креатива, CTA, платформы и даты показа) с постраничной выдачей по курсору.

1,05 USD/1 тыс. запросов, оплата за запрос, без подписки.

fMeta Ad Library
facebook.com/ads/library/?q=protein%20powder
Meta
United StatesiAll adsprotein powder

~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.

photo

vantagenutrition.com

Subscribe and save 20%. Cancel anytime.

Shop Now
Library ID: 705513298640217FBIG

PureForm Labs

Active · Sponsored

Plant based protein powder with 25g per scoop and no bloating. Third party tested, banned substance free.

video

pureformlabs.com

Free shipping on orders over $40.

Learn More
Library ID: 592047718834105FBIGMSG
Что вернул APIads[0]
{
"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
}
Доступность
99,92%
30d · Вызовов: 335 380
Запросы
335 455
30 дн. · по неделям, последние недель: 12
Ответ
1,7s
медиана · 30d

Цены и поставщики

Цена API Facebook Поиск рекламы: один API, поставщиков 5, и любой может заменить другого

Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.

Вы платите
10,50 USD
1,05 USD/1 тыс. запросов, только за то, чем пользуетесь. Без ежемесячного тарифа.
Ваши первые запросы (95) бесплатны за счёт стартового баланса 0,10 USD.

Попробовать

Получите Facebook Поиск рекламы одним запросом

requireFieldsarray
Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `totalResults`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может отсутствовать в объявлении, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания.
Открыть в
Пример ответа
Бесплатные запуски возвращают только первые результаты: 3. Пополните ключ, чтобы получить полный ответ.

В этом примере показано полей: 35 из 46. Все поля

{
  "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-21 · доступность и задержка измерены за 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. Показанные значения это примеры, замените их своими.

Ответ

JSON, по одному примеру значения на поле.

each addata.ads[]
  • 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.

each creativedata.ads[].creatives[]

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.

each mediadata.ads[].media[]

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.

datadata
  • 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.

top level
  • 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.ads_search. Ищет в Meta Ad Library по ключевому слову и возвращает подходящие объявления (рекламодатель, текст креатива, CTA, платформы и даты показа) с постраничной выдачей по курсору. AnyAPI направляет каждый запрос по источникам (их 5) и автоматически переключается, если один из них отказывает. Это стоит от 1,05 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 99,9% вызовов Facebook Поиск рекламы через AnyAPI завершились успешно, медианное время ответа 1,7 с, измерено вызовов: 335 380.

Это стоит от 1,05 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. Вы пополняете один кошелёк в долларах США, и каждый вызов списывает с него. По некоторым неудавшимся запросам, оплаченным из кошелька, возникают расходы на обработку; мы передаём их по себестоимости, без наценки, а сумма списания указана в ответе с ошибкой.

Ищет в Meta Ad Library по ключевому слову и возвращает подходящие объявления (рекламодатель, текст креатива, CTA, платформы и даты показа) с постраничной выдачей по курсору. Ответ это нормализованный JSON с тем же конвертом, что возвращает каждый эндпоинт AnyAPI, поэтому разбор второго эндпоинта это смена URL и ничего больше.

За последние 30 дней 99,9% вызовов Facebook Поиск рекламы через AnyAPI завершились успешно, медианное время ответа 1,7 с, измерено вызовов: 335 380. Это собственные измерения AnyAPI по трафику через шлюз, пересчитываемые непрерывно, а не опубликованный целевой уровень обслуживания.

Да. Новый аккаунт AnyAPI стартует с бесплатным балансом 0,10 USD, карта не нужна. Этого хватает на 95 вызовов Facebook Поиск рекламы по 0,00105 USD за каждый.

AnyAPI в том же запросе обращается к следующему из источников (их 5), начиная с самого дешёвого, поэтому отказ одного источника не ломает ваш вызов.

Отправьте запрос POST на https://api.getanyapi.com/v1/run/facebook.ads_search с вашим ключом AnyAPI в заголовке "Authorization: Bearer" и входными данными в теле JSON. Один и тот же ключ и один и тот же кошелёк работают на каждом эндпоинте AnyAPI.

Нет. Вы пополняете один предоплаченный баланс AnyAPI в долларах США, и каждый запрос списывает с него. Ежемесячного тарифа и минимума нет, а один и тот же баланс оплачивает каждый эндпоинт AnyAPI.

Да. Установите @getanyapi/sdk из npm для TypeScript или getanyapi из pip для Python. Оба вызывают любой эндпоинт AnyAPI с одним и тем же ключом, а ещё подойдёт любой HTTP-клиент.

Да. Агент может подключиться к MCP-серверу AnyAPI по адресу https://api.getanyapi.com/mcp или создать собственный бесплатный пробный ключ одним POST без аутентификации на https://api.getanyapi.com/agent/signup и вызывать этот эндпоинт по HTTP.
Ещё для вызова

Другие эндпоинты Facebook

Профильот 1,20 USD /1 тыс. запросовПубликации профиляот 1,15 USD /1 тыс. запросовПубликацияот 0,72 USD /1 тыс. запросовКомментарии к публикацииот 1,20 USD /1 тыс. запросовReels профиляот 1,20 USD /1 тыс. запросовДанные объявленияот 1,20 USD /1 тыс. запросовДанные объявления, полныеот 4,08 USD /1 тыс. запросовТранскрипт объявленияот 1,20 USD /1 тыс. запросовОтветы на комментарийот 1,20 USD /1 тыс. запросовРеклама компанииот 1,10 USD /1 тыс. запросовДанные событияот 0,96 USD /1 тыс. запросовСобытияот 1,20 USD /1 тыс. запросовПоиск событийот 1,20 USD /1 тыс. запросовПодписчикиот 3,15 USD /1 тыс. результатовПубликации группыот 0,72 USD /1 тыс. запросовМаркетплейсот 1,20 USD /1 тыс. запросовТовар на маркетплейсеот 1,20 USD /1 тыс. запросовПоиск местоположения на маркетплейсеот 1,20 USD /1 тыс. запросовКонтакты страницыот 1,20 USD /1 тыс. запросовПоиск страницыот 9,75 USD /1 тыс. запросовФотоот 1,20 USD /1 тыс. запросовТранскрипт публикацииот 1,20 USD /1 тыс. запросовСобытия профиляот 1,20 USD /1 тыс. запросовПоиск компанийот 1,10 USD /1 тыс. запросовПоиск страницот 10,00 USD /1 тыс. результатовПоиск публикацийот 16,00 USD /1 тыс. запросов