Сценарии: куда встроить API

Пять готовых схем — от бота за вечер до потока проектов агентства. Код — рабочий, подставьте свой ключ.

Telegram-бот, который сам запускает продвижение

Кому: Сервисы для малого бизнеса, боты-помощники, конструкторы ботов.

Бот спрашивает у клиента ссылку и город, считает цену через /projects/price и показывает её.
Клиент соглашается — бот создаёт проект и оплачивает его с вашего баланса.
Раз в 10 минут бот проверяет /tasks?status=ready и присылает клиенту готовые отчёты.

Python

import os, requests

API = "https://boosttools.ru/v1"
KEY = os.environ["BT_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def launch(link, city, phrase):
    body = {
        "marketKey": "yandexseo:people",
        "days": 5,
        "title": link,
        "link": link,
        "city": city,
        "searchPhrases": [phrase],
        "activities": [
            {"type": "MAIN.INFO", "count": 20},
        ],
    }
    p = requests.post(f"{API}/projects",
                      json=body, headers=H).json()
    r = requests.post(
        f"{API}/projects/{p['id']}/pay",
        json={"expectedPrice": p["price"]},
        headers=H,
    )
    # 402 — пополнить баланс
    return r.status_code, r.json()

Кнопка «Продвинуть» в вашем приложении

Кому: Сервисы для селлеров, онлайн-школы, платформы для кафе и салонов.

Пользователь вашего продукта нажимает «Продвинуть карточку» — ваш сервер отправляет запрос к нам, ключ живёт только на сервере.
Цену для показа берёте из /projects/price и добавляете свою наценку у себя — у нас списывается наша цена.
Статус и прогресс — из /projects/{id}: показываете у себя в интерфейсе.

JavaScript (Node.js)

const API = "https://boosttools.ru/v1";
const H = { Authorization: `Bearer ${process.env.BT_KEY}`, "Content-Type": "application/json" };

export async function price(marketKey, activities, days = 5) {
  const r = await fetch(`${API}/projects/price`, {
    method: "POST", headers: H, body: JSON.stringify({ marketKey, days, activities }),
  });
  return r.json();
}

export async function status(id) {
  const p = await (await fetch(`${API}/projects/${id}`, { headers: H })).json();
  return { status: p.status, progress: p.progress, paused: p.paused };
}

CRM: оплатил тариф — проект запустился

Кому: Агентства и студии, у которых продвижение входит в пакет услуг.

Вебхук CRM на смену этапа сделки вызывает ваш обработчик.
Обработчик собирает проект из полей сделки: ссылка, город, фразы.
Номер проекта записывается обратно в сделку — отчёты и статус видны менеджеру.

curl

# этап «Оплачено» → проект по данным сделки
curl -s https://boosttools.ru/v1/projects -H "Authorization: Bearer $KEY" \
  -H 'Content-Type: application/json' -d @deal-1042.json
# повторную отправку не делаем вслепую: сначала смотрим черновики
curl -s "https://boosttools.ru/v1/projects?scope=drafts" -H "Authorization: Bearer $KEY"

Make, n8n, Albato — без своего сервера

Кому: Маркетологи и владельцы бизнеса, которые собирают автоматизацию сами.

Модуль HTTP Request: метод, адрес из справочника, заголовок Authorization: Bearer <ключ>.
Тело — JSON из шага «Подключение»; значения подставляются из таблицы или формы.
Второй сценарий по расписанию забирает отчёты и пишет их в Google Таблицу или Telegram.

Настройка HTTP-шага

Метод:      POST
URL:        https://boosttools.ru/v1/projects/{{id}}/pay
Заголовки:  Authorization: Bearer {{BT_KEY}}
            Content-Type: application/json
Тело:       {"expectedPrice": {{price}}}

Отчёты в свою таблицу или BI

Кому: Все, кому нужна своя отчётность по исполнителям.

Раз в сутки забираете все отчёты одним CSV-файлом.
Файл грузится в таблицу или хранилище — ответы исполнителей и даты под рукой.

curl

curl -s "https://boosttools.ru/v1/reports/export?format=csv" \
  -H "Authorization: Bearer $KEY" -o reports-$(date +%F).csv

Ключ — за минуту, в кабинете

Бесплатно и без заявок. Платите только за запущенные проекты — с того же баланса, по тем же ценам.

Получить ключ