Pricing

Rule

You pay per successful response (HTTP 2xx). Failed requests (4xx, 5xx) are never charged. If the balance cannot cover the next call, the API returns 400 with {"detail": "Not enough balance..."} and does not charge. In that case, billing headers still report a zero charge and the current balance.

Cost per endpoint

Endpoint	Cost
GET /v1/me/	Free
POST /v1/me/reset-token	Free
GET /v1/search/	1₽
GET /v1/groups/{identifier}	2₽
GET /v1/users/{identifier}	1₽ if groups and cl_groups are empty; otherwise 4₽
GET /v1/users/{identifier}/similar	6₽
GET /v1/groups/{identifier}/similar	1₽
GET /v1/groups/{identifier}/members	1₽ / 5₽ / 15₽1

All prices are in rubles (RUB).

¹ The price of access to the export depends on its size: 1–10 members cost 1₽, 11–49 cost 5₽, and 50 or more cost 15₽. See the endpoint documentation for the calculation and repeat-request rules.

Billing response headers

Every successful response from a paid endpoint includes:

Header	Meaning
Telesint-Billing-Charged	Amount charged for this request, in RUB.
Telesint-Billing-Balance	Current balance after the request.
Cache-Control	private, no-store, because the response contains account-specific billing data.

The response body keeps the documented resource model; billing information is not added to JSON.

Checking the balance

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

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

• balance — current available amount in rubles.
• multiplier — top-up multiplier.
• notification_threshold — when balance drops below this value, an alert is sent. Configured in the bot.

Cost examples

Scenario	Math	Total
Look up 100 users with group data by ID	100 × 4₽	400₽
Fuzzy-search + fetch 50 profiles with group data	50 × 1₽ + 50 × 4₽	250₽
Crawl 20 groups + similar for each	20 × 2₽ + 20 × 1₽	60₽
Poll /v1/me/ every minute for a week	10 080 × 0₽	0₽

Monitoring spend

1. Set notification_threshold in the bot to hear about low balance early.
2. Poll /v1/me/ periodically to watch balance — that call is free.