← На главную

API Automybiznes

Программный доступ к подбору рекламных площадок — для агентств и интеграций. Входит в тариф Agency.

Аутентификация

Выпустите API-ключ в личном кабинете (раздел «API», тариф Agency) и передавайте его в заголовке:

Authorization: Bearer amb_ВАШ_КЛЮЧ

Ключ показывается один раз при выпуске. Повторный выпуск отзывает предыдущий ключ. Действуют лимиты вашего тарифа (Agency: до 500 подборов в день, до 200 площадок на подбор).

Запустить подбор

curl -X POST https://automybiznes.com/search \
  -H "Authorization: Bearer amb_..." -H "Content-Type: application/json" \
  -d '{"niche": "доставка цветов, ищу клиентов", "platforms": ["vk","telegram"], "top": 20}'

Если ниша уже покрыта каталогом — ответ сразу со статусом done и массивом results (площадка, ссылка, подписчики, тема, релевантность 0–1, обоснование). Если ниша новая — статус collecting и request_id: сервис собирает площадки в фоне (обычно 1–3 минуты), результат заберите вторым запросом.

Опциональные поля: city, budget, audience_min/audience_max — уточняют ранжирование и фильтрацию.

Получить результат

curl https://automybiznes.com/requests/REQUEST_ID -H "Authorization: Bearer amb_..."

Экспорт

curl "https://automybiznes.com/requests/REQUEST_ID/export?format=xlsx" \
  -H "Authorization: Bearer amb_..." -o placements.xlsx

format: xlsx или csv.

История подборов

curl https://automybiznes.com/history -H "Authorization: Bearer amb_..."

Мониторинг ниш

МетодПутьЧто делает
POST/monitorsследить за нишей: {"niche":"...","platforms":["vk","telegram"]}
GET/monitorsсписок мониторов с изменениями (новые/ушедшие площадки)
GET/monitors/{id}/mapкарта ниши: все площадки со статусами
DELETE/monitors/{id}перестать следить

ИИ-тексты

curl -X POST https://automybiznes.com/adtext \
  -H "Authorization: Bearer amb_..." -H "Content-Type: application/json" \
  -d '{"niche":"доставка цветов","name":"Подслушано Москва","topic":"город","members_count":250000}'

POST /adtext — 2 варианта рекламного поста под аудиторию площадки; POST /outreach (те же поля) — 2 варианта первого сообщения администратору.

Ошибки

401 — неверный/отозванный ключ · 403 — не хватает тарифа · 429 — лимит запросов (дневной или скоростной) · 5xx — повторите позже.

Вопросы по интеграции: @automybiznes_support_bot · partners@automybiznes.com