Integration API

Mass & Autoboost

Внешний API для другого сайта: импорт профилей, настройка автобуста, генерация комментариев, создание заказов, баланс, услуги и история заказов.

✦ Autoboost import принимает Instagram, Telegram, YouTube и TikTok

Authorization

Base URLhttps://myrzboss.com
AuthBearer integration key
Content-Typeapplication/json
CORSВключён для /api/integrations/*
Authorization: Bearer tb_int_YOUR_KEY
Content-Type: application/json

Ключ можно передать и через X-Integration-Key, но Bearer лучше для стандартных клиентов.

Methods

GET
/api/integrations/autoboost/statusСостояние Instagram/Telegram/YouTube/TikTok autoboost, jobs, ошибки, последние ссылки.
GET
/api/integrations/autoboost/catalogКаталог Autoboost1 услуг для Instagram, Telegram, YouTube и TikTok.
POST
/api/integrations/autoboost/resolveОпределить соцсеть по ссылке и вернуть подходящие карточки услуг.
POST
/api/integrations/autoboost/importДобавить профили, каналы и диапазоны услуг.
GET
/api/integrations/autoboost/instagram/profilesТекущий список Instagram профилей.
POST
/api/integrations/autoboost/instagram/profilesЗаменить список Instagram профилей.
POST
/api/integrations/autoboost/instagram/profile/refreshОбновить профиль и попробовать найти новые посты.
POST
/api/integrations/autoboost/instagram/profile/commentsПоследние comment-заказы профиля.
POST
/api/integrations/autoboost/instagram/retry-failedВернуть failed Instagram jobs в очередь.
GET
/api/integrations/autoboost/telegram/settingsТекущие Telegram каналы и услуги.
POST
/api/integrations/autoboost/telegram/settingsЗаменить Telegram каналы.
GET
/api/integrations/autoboost/youtube/settingsТекущие YouTube каналы и услуги.
POST
/api/integrations/autoboost/youtube/settingsЗаменить YouTube каналы и диапазоны.
GET
/api/integrations/autoboost/tiktok/settingsТекущие TikTok профили и услуги.
POST
/api/integrations/autoboost/tiktok/settingsЗаменить TikTok профили и диапазоны.
POST
/api/integrations/comments/generateСгенерировать комментарии без создания заказа.
POST
/api/integrations/orders/createСоздать массовые заказы TwiBoost.
GET
/api/integrations/ordersИстория, активные и завершённые заказы.
POST
/api/integrations/orders/refreshОбновить статусы заказов.
POST
/api/integrations/orders/importПодтянуть заказы по ID.
POST
/api/integrations/orders/clearОчистить локальную историю заказов.
POST
/api/integrations/servicesПолучить список услуг TwiBoost.
POST
/api/integrations/balanceПроверить баланс TwiBoost.

Examples

await fetch("https://myrzboss.com/api/integrations/autoboost/import", {
  method: "POST",
  headers,
  body: JSON.stringify({
    source: "client-site-1",
    instagramProfiles: ["oliviascarters", "https://instagram.com/philysanto"],
    telegramChannels: ["MikeCapital"],
    youtubeChannels: ["@channel", "https://www.youtube.com/@channel2"],
    tiktokProfiles: ["@profile", "https://www.tiktok.com/@profile2"],
    instagramServices: [
      { "serviceId": "4362", "min": 20, "max": 35, "scope": "all" },
      { "serviceId": "1006", "min": 10, "max": 20, "scope": "all" }
    ],
    youtubeServices: [
      { "serviceId": "1933", "min": 15, "max": 20 },
      { "serviceId": "4451", "min": 600, "max": 999 },
      { "serviceId": "1919", "min": 70, "max": 99 }
    ],
    tiktokServices: [
      { "serviceId": "1002", "min": 900, "max": 1500 },
      { "serviceId": "4660", "min": 20, "max": 40 },
      { "serviceId": "4009", "min": 90, "max": 140 }
    ]
  })
});
await fetch("https://myrzboss.com/api/integrations/comments/generate", {
  method: "POST",
  headers,
  body: JSON.stringify({
    minComments: 10,
    maxComments: 20,
    modelName: "Olivia",
    allowedEmojis: ["😍", "🔥", "✨"],
    styleExample: "Olivia this looks clean\nsoft vibe here ✨",
    items: [{ "link": "https://www.instagram.com/p/SHORTCODE/" }]
  })
});
await fetch("https://myrzboss.com/api/integrations/orders/create", {
  method: "POST",
  headers,
  body: JSON.stringify({
    serviceId: "4362",
    orderKind: "quantity",
    fixedQuantity: 25,
    items: [
      { "link": "https://www.instagram.com/p/SHORTCODE1/" },
      { "link": "https://www.instagram.com/reel/SHORTCODE2/" }
    ]
  })
});
await fetch("https://myrzboss.com/api/integrations/balance", {
  method: "POST",
  headers,
  body: "{}"
});

Autoboost Import

Для внешнего сайта поток такой: клиент вставляет integration key, сайт вызывает catalog, при вставке ссылки вызывает resolve, рисует карточки услуг из ответа и отправляет выбранные диапазоны в import.

instagramProfilesМассив username или Instagram ссылок.
telegramChannelsМассив username или t.me ссылок.
youtubeChannelsМассив @handle или YouTube ссылок.
tiktokProfilesМассив @profile или TikTok ссылок.
instagramServicesМассив диапазонов или строка all:1006:10-20.
telegramServicesМассив диапазонов или строка 2817:90-140.
youtubeServicesПо умолчанию: comments 1933, views 4451, likes 1919.
tiktokServicesПо умолчанию: views 1002, comments 4660, likes 4009.
dryRuntrue проверит запрос без сохранения.

Catalog + link resolve

const catalog = await fetch("https://myrzboss.com/api/integrations/autoboost/catalog", {
  headers
}).then((response) => response.json());

const resolved = await fetch("https://myrzboss.com/api/integrations/autoboost/resolve", {
  method: "POST",
  headers,
  body: JSON.stringify({ link: "https://www.youtube.com/@channel" })
}).then((response) => response.json());

// resolved.first.services уже содержит serviceId, label, kind, min, max.
// Эти значения можно сразу показать карточками и дать клиенту поменять min/max.

Import payload

{
  "instagramProfiles": ["https://instagram.com/profile"],
  "telegramChannels": ["https://t.me/channel"],
  "youtubeChannels": ["https://www.youtube.com/@channel"],
  "tiktokProfiles": ["https://www.tiktok.com/@profile"],
  "instagramServices": "all:1006:10-20,reel:3319:300-650",
  "telegramServices": "4188:70-115@1,1993:2300-4300",
  "youtubeServices": "1933:15-20,4451:600-999,1919:70-99",
  "tiktokServices": "1002:900-1500,4660:20-40,4009:90-140"
}

Comment Generation

Ручка только генерирует текст. Заказ создаётся через orders/create или автоматически внутри Instagram autoboost.

  • minComments и maxComments задают диапазон.
  • styleExample помогает держать нужный стиль.
  • allowedEmojis ограничивает эмодзи.
  • forceLocal включает локальный генератор без OpenAI.

Mass Orders

Для лайков, просмотров и охватов передавайте количество. Для комментариев передавайте комментарии строками.

Instagram likes

await fetch("https://myrzboss.com/api/integrations/orders/create", {
  method: "POST",
  headers,
  body: JSON.stringify({
    serviceId: "4362",
    orderKind: "quantity",
    fixedQuantity: 90,
    items: [
      { "link": "https://www.instagram.com/p/SHORTCODE/" }
    ]
  })
});

Instagram views

await fetch("https://myrzboss.com/api/integrations/orders/create", {
  method: "POST",
  headers,
  body: JSON.stringify({
    serviceId: "3319",
    orderKind: "quantity",
    fixedQuantity: 1000,
    items: [
      { "link": "https://www.instagram.com/reel/SHORTCODE/" }
    ]
  })
});

YouTube likes

await fetch("https://myrzboss.com/api/integrations/orders/create", {
  method: "POST",
  headers,
  body: JSON.stringify({
    serviceId: "1919",
    orderKind: "quantity",
    fixedQuantity: 80,
    items: [
      { "link": "https://www.youtube.com/watch?v=VIDEO_ID" }
    ]
  })
});

YouTube views

await fetch("https://myrzboss.com/api/integrations/orders/create", {
  method: "POST",
  headers,
  body: JSON.stringify({
    serviceId: "4451",
    orderKind: "quantity",
    fixedQuantity: 750,
    items: [
      { "link": "https://www.youtube.com/watch?v=VIDEO_ID" }
    ]
  })
});

TikTok likes

await fetch("https://myrzboss.com/api/integrations/orders/create", {
  method: "POST",
  headers,
  body: JSON.stringify({
    serviceId: "4009",
    orderKind: "quantity",
    fixedQuantity: 120,
    items: [
      { "link": "https://www.tiktok.com/@profile/video/VIDEO_ID" }
    ]
  })
});

TikTok views

await fetch("https://myrzboss.com/api/integrations/orders/create", {
  method: "POST",
  headers,
  body: JSON.stringify({
    serviceId: "1002",
    orderKind: "quantity",
    fixedQuantity: 1200,
    items: [
      { "link": "https://www.tiktok.com/@profile/video/VIDEO_ID" }
    ]
  })
});

Comment order

await fetch("https://myrzboss.com/api/integrations/orders/create", {
  method: "POST",
  headers,
  body: JSON.stringify({
    serviceId: "1006",
    orderKind: "comment",
    items: [{
      "link": "https://www.instagram.com/p/SHORTCODE/",
      "comments": "clean look here\nthis one hits different\nsoft energy ✨"
    }]
  })
});

Telegram reaction

await fetch("https://myrzboss.com/api/integrations/orders/create", {
  method: "POST",
  headers,
  body: JSON.stringify({
    serviceId: "4188",
    orderKind: "quantity",
    fixedQuantity: 90,
    answerNumber: 1,
    items: [
      { "link": "https://t.me/channel/123" }
    ]
  })
});

Order maintenance

GET  /api/integrations/orders
POST /api/integrations/orders/refresh
POST /api/integrations/orders/import
POST /api/integrations/orders/clear

Instagram Actions

POST /api/integrations/autoboost/instagram/profiles
POST /api/integrations/autoboost/instagram/profile/refresh
POST /api/integrations/autoboost/instagram/profile/comments
POST /api/integrations/autoboost/instagram/retry-failed

Эти действия нужны для ручного контроля: заменить список, форснуть обновление профиля, посмотреть последние сгенерированные комментарии и повторить ошибки.

Errors

401 missing_integration_keyКлюч не передан.
401 invalid_integration_keyКлюч неверный или отключён.
400 invalid_jsonBody невалидный JSON.
400 invalid_payloadBody должен быть JSON object.
400 invalid_servicesНеверный формат диапазонов услуг.
400 missing_api_keyУ пользователя не сохранён TwiBoost API key.