API библиотеки рекламы Facebook и отслеживание рекламы конкурентов

1. Соберите URL библиотеки

   Выполните поиск в Meta Ad Library как обычно — со страной, статусом «активные» и ключевым словом — или откройте страницу рекламодателя и скопируйте URL. Для Google откройте рекламодателя или домен в Ads Transparency Center. Для LinkedIn используйте URL поиска в Ad Library.

2. Запустите инструмент

   Отправьте URL в facebook-ads в поле urls или в google-ads-transparency и linkedin-ads в поле startUrls, задав лимит max_results.

3. Сравнивайте во времени

   Сохраняйте объявления вместе с рекламодателем и датами, запустите снова через неделю и сравните. Модель на том же ключе может разложить тексты по офферам, подачам и призывам к действию.

Этот запуск собирает до 100 активных объявлений в США по запросу «meal kit»:

curl https://lovelyrouter.com/v1/tools/facebook-ads/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "urls": [{"url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=meal%20kit"}],
      "count": 100
    },
    "max_results": 100
  }'

Каждый элемент в items — одно объявление с креативом, текстом, датой начала и рекламодателем. Чтобы следить за одним конкурентом, а не за ключевым словом, укажите в urls URL его страницы Facebook. Можно передать и несколько URL в одном запуске; limitPerSource ограничивает число объявлений с каждого из них. Запуск, который не завершился за 60 секунд, возвращается с кодом 202 и путём poll, как описано в разделе Запуск инструмента.

Инструмент для Google принимает URL Transparency Center для рекламодателя или домена:

curl https://lovelyrouter.com/v1/tools/google-ads-transparency/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"input": {"startUrls": [{"url": "https://adstransparency.google.com/?region=US&domain=nike.com"}]}, "max_results": 50}'

Он возвращает формат каждого объявления, текст, даты показа и регионы.

Подключите MCP-сервер к Claude Code, Cursor или другому MCP-клиенту и попросите: «Собери активные объявления этих трёх брендов в США из Meta Ad Library и Google Ads Transparency Center, перечисли те, что появились за последние 30 дней, и сгруппируй их по офферу. В каждом запуске задавай max_results». Агент находит инструменты через suggest_tools, читает их схемы через get_tool и запускает их, списывая оплату с вашего баланса.

Инструменты библиотек рекламы берут оплату за каждое возвращённое объявление, а website-traffic — за каждый сайт плюс плату за вызов. Карточки выше показывают актуальные цены. При старте запуск резервирует свою максимальную стоимость — плату за вызов плюс цену за результат, умноженную на max_results, — а по завершении списывается сумма за фактически возвращённое. Запуск, завершившийся ошибкой, оплачивает только объявления, доставленные до его окончания, так что неудачный запуск без результатов ничего не стоит. Подписки нет: вы пополняете предоплаченный баланс, который оплачивает также модели и другие инструменты данных. Подробнее — на странице цен.