API Facebook

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

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

1,10 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.",
+17 ещё
}
Доступность
99,96%
30d · Вызовов: 8 938
Запросы
8 939
30 дн. · по неделям, последние недель: 12
Ответ
2,7s
медиана · 30d

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

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

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

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

Попробовать

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

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

Ответ

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

  • foundboolean

    true

datadata
  • totalResultsnumberможет потребовать

    214

  • nextCursorstring

    AQHRZ9d3f2k7m1x8c

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

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

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

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

За последние 30 дней 100,0% вызовов Facebook Поиск рекламы через AnyAPI завершились успешно, медианное время ответа 2,7 с, измерено вызовов: 8 938. Это собственные измерения AnyAPI по трафику через шлюз, пересчитываемые непрерывно, а не опубликованный целевой уровень обслуживания.

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

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

Отправьте запрос 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,20 USD /1 тыс. запросовПубликацияот 1,20 USD /1 тыс. запросовКомментарии к публикацииот 1,20 USD /1 тыс. запросовReels профиляот 1,20 USD /1 тыс. запросовДанные объявленияот 1,20 USD /1 тыс. запросовДанные объявления, полныеот 4,62 USD /1 тыс. запросовТранскрипт объявленияот 1,20 USD /1 тыс. запросовОтветы на комментарийот 1,20 USD /1 тыс. запросовРеклама компанииот 1,10 USD /1 тыс. запросовДанные событияот 1,20 USD /1 тыс. запросовСобытияот 1,20 USD /1 тыс. запросовПоиск событийот 1,20 USD /1 тыс. запросовПодписчикиот 6,00 USD /1 тыс. результатовПубликации группыот 1,20 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,20 USD /1 тыс. запросовПоиск страницот 11,18 USD /1 тыс. результатовПоиск публикацийот 30,00 USD /1 тыс. запросов