Data formats

Requests and responses

• The base URL is https://api.datool.ru/v1/…, HTTPS only.
• The key goes in the Authorization: Bearer dtk_… header (or X-API-Key: dtk_…).
• Responses are JSON in UTF-8. Request bodies (webhooks) are JSON with the Content-Type: application/json header.
• The language of error texts and descriptions follows the Accept-Language header: en — English, otherwise Russian. Data (channel titles, post texts, category names) is as in MAX.

Time and dates

• Points in time are ISO 8601 with a time zone, in Moscow time: 2026-10-18T11:42:00+03:00. Any program that understands ISO 8601 converts them to another zone by itself. The exception is the X-Quota-Reset header: it is in UTC (2026-11-04T10:20:00Z).
• Days (statistics, the from and to filters) are YYYY-MM-DD in Moscow time: 2026-10-17.

Numbers

• id — the number in datool.ru (of a channel, post, category, webhook). It is used in API URLs and filters.
• external_id — the number in MAX: for a channel — the chat ID with a minus sign (-71204896310021), for a post — the post number in the channel.

Values

• null — no value or it is unknown: for example, subscribers: null — the channel wasn’t polled that day.
• Yes / no — true / false.
• Money (the balance in /v1/me/) — a string with two decimal places, in rubles: "1490.00".
• Reactions — an “emoji → count” object: {"👍": 180, "🔥": 56}.

Compatibility

New fields and methods appear in v1 without a version change. Write your client so that unfamiliar fields in a response don’t break parsing.