API проверки стримов

Одна ссылка на стрим → индекс накрутки 0–100, вердикт, зрители и чаттеры в JSON. Для панелей, ботов и мониторинга.

1Зарегистрируйтесь в кабинете

2Создайте ключ в разделе «API»

3Вызывайте /v1/api/check

Лимиты и цена

100 проверок в день бесплатно на каждый ключ, дальше $0.01 за проверку с баланса кабинета. Запрос последнего результата без новой проверки — всегда бесплатно.

Запуск проверки

GET https://api.check-bots.ru/v1/api/check?link=https://www.twitch.tv/xqc
Authorization: Bearer cbk_ваш_ключ

Вместо link можно передать platform (twitch, yt, yt_vid, kick, vk, rumble) и channel. Ключ также принимается параметром ?key=, но заголовок безопаснее.

curl -H "Authorization: Bearer cbk_…" \
  "https://api.check-bots.ru/v1/api/check?link=twitch.tv/xqc"

Ответ

{
  "ok": true,
  "billing": { "free": true, "left": 99 },
  "result": {
    "platform": "twitch", "channel": "xqc", "name": "xQc",
    "score": 12, "confidence": 0.62, "verdict": "clean",
    "viewers": 41230, "chatters": 9870, "followers": 12400000,
    "reasons": ["LOW_CONFIDENCE"],
    "features": { "E": 0.1, "F": 0.05, "R": 0, "D": 0.2, "B": 0.02 },
    "degraded": []
  }
}

Поле	Что означает
`score`	Индекс накрутки 0–100. Больше — подозрительнее.
`verdict`	`clean` — накрутки не обнаружено, `suspicious` — подозрительно, `botted` — накрутка.
`confidence`	Уверенность 0–1: растёт с длительностью наблюдения и объёмом данных.
`reasons`	Коды причин: `EMPTY_CHAT`, `VIEWERS_VS_FOLLOWERS`, `INSTANT_RISE`, `FLAT_LINE`, `KNOWN_BOTS_IN_CHAT`, `NEW_CHANNEL`, `SCRIPTED_CHAT`, `FRESH_ACCOUNTS`, `FOLLOWER_ROLLBACK`, `RAID_DETECTED`, `LOW_CONFIDENCE`, `PARTIAL_DATA`.
`billing`	`{free, left}` — бесплатный лимит, или `{charged_cents, balance_cents}` — списано с баланса.

Первый ответ по каналу — по одному снимку; наблюдение продолжается до 60 минут, повторный запрос через 5–10 минут вернёт уточнённый результат.

Последний результат без новой проверки

GET https://api.check-bots.ru/v1/api/latest?platform=twitch&channel=xqc

Бесплатно. 404 not_checked, если канал ещё не проверяли.

Ошибки

Код	Причина
`401 api_key_required` / `bad_api_key`	Ключ не передан, отозван или неверный.
`400 bad_link` / `bad_request`	Ссылка не распознана или нет платформы/канала.
`402 insufficient_funds`	Бесплатный лимит исчерпан, на балансе нет средств.
`429`	Слишком часто по одному каналу — повторите через минуту.
`200 ok:false`	Канал офлайн или площадка недоступна: `error` с кодом, `message` с пояснением.

Бейджи и виджеты для сайта: /badge/{platform}/{channel}.svg и /embed/{platform}/{channel} — без ключа.

Stream check API

One stream link → bot index 0–100, verdict, viewers and chatters as JSON. For dashboards, bots and monitoring.

1Sign up in your account

2Create a key in the “API” section

3Call /v1/api/check

Get a key Home

Limits and price

100 checks per day are free for every key, then $0.01 per check from your account balance. Fetching the latest result without a new check is always free.

Run a check

GET https://api.check-bots.ru/v1/api/check?link=https://www.twitch.tv/xqc
Authorization: Bearer cbk_your_key

Instead of link you can pass platform (twitch, yt, yt_vid, kick, vk, rumble) and channel. The key is also accepted as ?key=, but the header is safer.

curl -H "Authorization: Bearer cbk_…" \
  "https://api.check-bots.ru/v1/api/check?link=twitch.tv/xqc"

Response

{
  "ok": true,
  "billing": { "free": true, "left": 99 },
  "result": {
    "platform": "twitch", "channel": "xqc", "name": "xQc",
    "score": 12, "confidence": 0.62, "verdict": "clean",
    "viewers": 41230, "chatters": 9870, "followers": 12400000,
    "reasons": ["LOW_CONFIDENCE"],
    "features": { "E": 0.1, "F": 0.05, "R": 0, "D": 0.2, "B": 0.02 },
    "degraded": []
  }
}

Field	Meaning
`score`	Bot index 0–100. Higher is more suspicious.
`verdict`	`clean`, `suspicious` or `botted`.
`confidence`	0–1, grows with observation time and data volume.
`reasons`	Reason codes: `EMPTY_CHAT`, `VIEWERS_VS_FOLLOWERS`, `INSTANT_RISE`, `FLAT_LINE`, `KNOWN_BOTS_IN_CHAT`, `NEW_CHANNEL`, `SCRIPTED_CHAT`, `FRESH_ACCOUNTS`, `FOLLOWER_ROLLBACK`, `RAID_DETECTED`, `LOW_CONFIDENCE`, `PARTIAL_DATA`.
`billing`	`{free, left}` for the free quota, or `{charged_cents, balance_cents}` when charged.

The first response uses a single snapshot; observation continues for up to 60 minutes — call again in 5–10 minutes for a refined result.

Latest result without a new check

GET https://api.check-bots.ru/v1/api/latest?platform=twitch&channel=xqc

Free. 404 not_checked if the channel was never checked.

Errors

Code	Reason
`401 api_key_required` / `bad_api_key`	Key missing, revoked or invalid.
`400 bad_link` / `bad_request`	Link not recognized or platform/channel missing.
`402 insufficient_funds`	Free quota used up and the balance is empty.
`429`	Too many checks of one channel — retry in a minute.
`200 ok:false`	Channel offline or platform unavailable: `error` code and `message`.

Badges and widgets for your site: /badge/{platform}/{channel}.svg and /embed/{platform}/{channel} — no key needed.