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