BFGuru

База знаний · Интеграция API

BFGuru API: создание аналитического отчёта по ссылке на объект недвижимости или техники

Автор: BFGuru

Новое расширение BFGuru API позволяет партнёрам создавать аналитические отчёты, передавая только ссылку на страницу объекта. Система самостоятельно получает данные со страницы с помощью парсеров, анализирует информацию и формирует готовый отчёт.

Иллюстрация к созданию отчёта через BFGuru API

Описание

BFGuru API позволяет встроить создание аналитических отчётов непосредственно в сайт партнёра. Решение подходит для площадок недвижимости, каталогов техники, автомобилей и других объектов.

Пользователь может заказать анализ прямо из карточки объекта. Партнёру не требуется передавать характеристики объекта вручную — достаточно отправить URL страницы.

Передаваемые данные

  • url — ссылка на страницу объекта;
  • price_id — идентификатор тарифа;
  • email — email пользователя;
  • variant — тип отчёта.

Методы API

Получение тарифов

GET /api/partners/{partner_id}/price

Возвращает доступные тарифы партнёра.

Поля тарифа
Поле Описание
id ID тарифа
name Название отчёта
variant house — недвижимость, tech — техника
price Стоимость отчёта

Создание отчёта

POST /api/partners/{partner_id}/reports

Запрос отправляется в формате multipart/form-data.

Параметры создания отчёта
Параметр Описание
url Ссылка на объект на сайте партнёра, например на карточку недвижимости
price_id ID выбранного тарифа
email Email клиента
variant Тип отчёта
fast_pay Создание прямой ссылки оплаты
send_email_to_user Автоматическая отправка отчёта

Пример запроса

const formData = new FormData();

formData.append("url", "https://site.ru/object/12345");
formData.append("price_id", "5");
formData.append("email", "client@example.com");
formData.append("variant", "house");
formData.append("fast_pay", "1");
formData.append("send_email_to_user", "1");

Ответ API

{
  "status": "ok",
  "redirect_link": "https://payment.bfguru.ru/..."
}

Преимущества

  • Минимальная интеграция — достаточно передать URL объекта.
  • Автоматический сбор данных со страницы объекта.
  • Поддержка недвижимости и техники.
  • Быстрое подключение к существующим карточкам объектов.
  • Готовый путь пользователя от заказа до получения отчёта.
  • https://bfgu.ru/promo10 — живой пример использования BFGuru API для создания отчёта по ссылке на объект.