Reelee.kz
Войти

API reelee.kz для интеграций

Управляйте кампаниями бренда из своей CRM или админки: создание и запуск кампаний, работа с заявками креаторов, проверка видео, финансы. Всё, что умеет кабинет рекламодателя, доступно по REST.

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

API-ключ выдаёт платформа (напишите нам: [email protected]) — он привязан к вашему бренду и передаётся в каждом запросе:

curl https://api.reelee.kz/api/brands/me \
  -H "Authorization: Bearer ugc_live_ВАШ_КЛЮЧ"
  • Базовый URL: https://api.reelee.kz/api, все тела — JSON (`Content-Type: application/json`)
  • Ключ показывается один раз при выдаче; храните в секретах, не в коде
  • Суммы — целые тенге (₸); ставки (cpv) — тенге за 1 просмотр (≈3–8)
  • Ошибки: 400 — неверные данные (текст в `message`), 401 — ключ недействителен, 403 — операция недоступна
  • Ключу недоступны: удаление аккаунта, админ-разделы

Бренд и баланс

GET/brands/me

Профиль бренда: название, баланс (₸), verified — прошла ли проверка платформой (до неё запуск кампаний недоступен).

{ "id": "...", "name": "ТОО «Пример»", "balance": 250000, "verified": true }
GET/brands/me/transactions

История операций баланса: пополнения, резервы кампаний, возвраты.

POST/brands/me/topups

Сообщить о пополнении (после оплаты по QR/счёту). Зачисление подтверждает платформа.

{ "amount": 100000 }
POST/brands/me/doc-requests

Запросить закрывающие: INVOICE (счёт), ACT (акт, укажите campaignId), ESF (электронный счёт-фактура).

{ "type": "ACT", "campaignId": "...", "comment": "за сентябрь" }

Кампании

POST/campaigns

Создать кампанию. asDraft: true — черновик (без списания); false/нет — сразу запуск с резервом бюджета с баланса. Категории: FOOD, BEAUTY, FASHION, SHOPPING, FINANCE, TECH, EDUCATION, TRAVEL, AUTO, ENTERTAINMENT, FITNESS, FAMILY, PETS, HOME, GAMING, BUSINESS, MEDICINE, REAL_ESTATE, OTHER (+categoryOther). Тематики креаторов (topics) — те же плюс LIFESTYLE, HUMOR, REVIEWS, MUSIC, MOVIES, RELATIONSHIPS, ART. Форматы: NATIVE, PRODUCT_DEMO, STORE_VISIT. rewardType: MONEY (по умолчанию) | BARTER (barterOffer, barterValue) | CONTEST (prizePool, winnersCount).

{
  "title": "Обзор доставки",
  "category": "FOOD",
  "description": "Расскажи о нашей доставке",
  "briefText": "Закажи, сними распаковку, покажи приложение",
  "requiredElements": ["Упоминание бренда", "Пометка «реклама»"],
  "restrictions": ["Без конкурентов"],
  "format": "NATIVE",
  "platforms": ["INSTAGRAM"],
  "budget": 50000,
  "cpv": 0.6,
  "deadline": "2026-10-15",
  "applyDeadline": "2026-10-05",
  "cities": [],
  "contentLanguages": ["RU","KK"],
  "minFollowers": 0,
  "asDraft": true
}
GET/campaigns/my

Все кампании бренда со статусами: DRAFT, RECRUITING, PAUSED, PRODUCTION, STATS_COLLECTION, COMPLETED.

PATCH/campaigns/:id

Изменить черновик (тот же состав полей, что при создании). Запущенную кампанию менять нельзя.

POST/campaigns/:id/launch

Запустить черновик: бюджет резервируется с баланса. 400, если средств не хватает или бренд не прошёл проверку.

POST/campaigns/:id/pause

Выключить набор: кампания скрывается из ленты креаторов, начатые проекты продолжаются.

POST/campaigns/:id/resume

Включить набор обратно.

POST/campaigns/:id/start-production

Завершить набор: оставшиеся неразобранные заявки отклоняются.

POST/campaigns/:id/increase-budget

Долить бюджет живой кампании с баланса аккаунта (минимум 7 000 ₸).

{ "amount": 20000 }
POST/campaigns/:id/complete

Завершить кампанию; остаток бюджета вернётся на баланс. 400, пока есть проекты в работе.

GET/campaigns/:id/finance

Финансы кампании.

{ "budget": 50000, "reserved": 18000, "paid": 12000, "available": 20000 }

Заявки и видео (публикации)

GET/campaigns/:id/publications

Заявки кампании. Статусы: APPLIED (ждёт вашего решения), APPROVED (снимает), CONTENT_REVIEW (видео на вашей проверке), CONTENT_APPROVED (публикует), PUBLISHED (ждёт подтверждения), STATS_COLLECTION (считаем просмотры), PAID, REJECTED. Поля: forecastViews (прогноз), brandCost (чек, ₸), creator { handle, followers, rating }.

POST/publications/:id/approve

Одобрить заявку: чек резервируется из бюджета кампании. 400 при нехватке свободного бюджета.

POST/publications/:id/reject

Отклонить заявку (причину увидит креатор).

{ "reason": "Набор укомплектован" }
GET/publications/:id/video-url

Временная ссылка на загруженное видео для проверки (статус CONTENT_REVIEW).

POST/publications/:id/approve-content

Одобрить видео — креатор публикует в течение 48 часов.

POST/publications/:id/return-rework

Вернуть видео на доработку (бесплатно, любое число раз).

{ "reason": "Добавь промокод в кадр" }
POST/publications/:id/reject-compensate

Финальный отказ от снятого видео: креатору компенсация 20% чека из бюджета.

{ "reason": "Не по брифу" }
POST/publications/:id/start-stats

Подтвердить публикацию (после проверки ссылки) — старт 48-часового окна подсчёта. Если молчать, подтвердится автоматически. Итоговые просмотры сверяет и расчёт проводит платформа.

Каталог креаторов

GET/creators

Каталог одобренных креаторов (после проверки бренда): handle, city, followers, avgViews, rating, platforms. Без контактов и платёжных данных.

POST/campaigns/:id/invite

Пригласить креатора в кампанию со статусом RECRUITING — приглашение сразу одобрено (чек резервируется).

{ "creatorId": "..." }
Нужен ключ или помощь с интеграцией?

Подключим за один день и поможем с маппингом полей

Написать на [email protected] →