Тарификация

Правило

Оплачиваются только успешные ответы (HTTP 2xx). Неуспешные запросы (4xx, 5xx) не списываются. При нехватке баланса API возвращает 400 с {"detail": "Not enough balance..."} и ничего не снимает. В этом случае billing-заголовки всё равно содержат нулевое списание и актуальный баланс.

Стоимость по методам

Эндпоинт	Стоимость
GET /v1/me/	Бесплатно
POST /v1/me/reset-token	Бесплатно
GET /v1/search/	1₽
GET /v1/groups/{identifier}	2₽
GET /v1/users/{identifier}	1₽, если groups и cl_groups пусты; иначе 4₽
GET /v1/users/{identifier}/similar	6₽
GET /v1/groups/{identifier}/similar	1₽
GET /v1/groups/{identifier}/members	1₽ / 5₽ / 15₽1

Все цены в рублях.

¹ Стоимость доступа к выгрузке зависит от её объёма: 1–10 участников — 1₽, 11–49 — 5₽, 50 и более — 15₽. Подробный расчёт и правила повторных запросов описаны в документации эндпоинта.

Заголовки биллинга

Каждый успешный ответ платного эндпоинта содержит:

Заголовок	Значение
Telesint-Billing-Charged	Сколько рублей списано за этот запрос.
Telesint-Billing-Balance	Актуальный баланс после выполнения запроса.
Cache-Control	private, no-store, потому что ответ содержит персональные данные биллинга.

Модель JSON-ответа при этом не меняется: информация о списании не добавляется в тело ответа.

Проверка баланса

curl -H "Api-Key: $API_KEY" https://api.telesint.dev/v1/me/

{
  "id_": 436307416,
  "balance": 109992,
  "multiplier": 1,
  "roles": [],
  "notification_threshold": 20
}

• balance — текущий остаток в рублях.
• multiplier — множитель пополнения баланса.
• notification_threshold — порог, при котором придёт оповещение о низком балансе. Настраивается в боте.

Примеры расчёта

Сценарий	Арифметика	Итого
Забрать по ID профили 100 пользователей с данными о группах	100 × 4₽	400₽
Найти и получить 50 полных профилей с данными о группах	50 × 1₽ + 50 × 4₽	250₽
Обойти 20 групп и похожие для каждой	20 × 2₽ + 20 × 1₽	60₽
Опросить /v1/me/ каждую минуту неделю	10 080 × 0₽	0₽

Контроль расходов

1. Выставьте notification_threshold в боте — узнаете о низком балансе заранее.
2. Периодически опрашивайте /v1/me/ и следите за balance — этот вызов бесплатен.
3. После каждого платного ответа читайте Telesint-Billing-Charged и Telesint-Billing-Balance: они показывают сумму списания и актуальный баланс сразу после запроса.