Получить пользователя по ID или username

GET/v1/users/{identifier}1₽ или 4₽ за 2xx

Возвращает профиль пользователя по числовому ID или username.

Авторизация

Требуется заголовок Api-Key.

Стоимость

Запрос стоит 1₽, если оба поля — groups и cl_groups — пусты. Если хотя бы в одном из них есть группа, запрос стоит 4₽.

Параметры пути

Имя	Тип	Обязателен	Описание
identifier	string	да	Числовой ID (например 12345) или username с @ или без него.

Примеры

cURL

# По числовому ID
curl -H "Api-Key: $API_KEY" \
  https://api.telesint.dev/v1/users/12345

# По username
curl -H "Api-Key: $API_KEY" \
  https://api.telesint.dev/v1/users/johndoe

Python

import os, requests

def get_user(identifier: str | int) -> dict:
    response = requests.get(
        f"https://api.telesint.dev/v1/users/{identifier}",
        headers={"Api-Key": os.environ["API_KEY"]},
        timeout=10,
    )
    response.raise_for_status()
    return response.json()["data"]

user = get_user("johndoe")

JavaScript

async function getUser(identifier) {
  const res = await fetch(
    `https://api.telesint.dev/v1/users/${identifier}`,
    { headers: { 'Api-Key': process.env.API_KEY } },
  );
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  const { data } = await res.json();
  return data;
}

const user = await getUser('johndoe');

Ответ — 200 OK

{
  "data": {
    "id": 12345,
    "username": "johndoe",
    "name": "John Doe",
    "h_name": [
      { "value": "John Doe Old", "update": "2021-01-01T00:00:00" },
      { "value": "John Doe Very Old", "update": null }
    ],
    "h_username": [
      { "value": "johndoe_old", "update": "2021-01-01T00:00:00" }
    ],
    "groups": [
      {
        "data": { "id": 12345, "title": "Example Group", "url": "example_group" },
        "admin": { "id": 12345, "is_creator": true, "role": "admin", "update": "2021-01-01T00:00:00" },
        "update": "2021-01-01T00:00:00"
      }
    ],
    "cl_groups": [],
    "scam": false,
    "dc": 2,
    "last_online": { "status": "recently", "update": "2021-01-01T00:00:00" },
    "premium": { "last_seen": "2021-01-01T00:00:00" },
    "is_bot": false,
    "is_deleted": false
  }
}

Поля — data

Поле	Тип	Описание
id	integer	Неизменный ID пользователя.
username	string | null	Текущий username.
name	string	Текущее отображаемое имя.
h_name	массив history entry	Предыдущие имена.
h_username	массив history entry	Предыдущие usernames.
groups	массив group membership	До 1 000 открытых групп пользователя.
cl_groups	массив group membership	До 1 000 закрытых/приватных групп.
scam	boolean	Аккаунт помечен как scam.
dc	integer | null	Номер датацентра.
last_online	last online | null	Последний онлайн-статус.
premium	premium | null	Премиум-статус.
is_bot	boolean	true для бот-аккаунтов.
is_deleted	boolean	true если аккаунт удалён.

History entry

Поле	Тип	Описание
value	string	Предыдущее значение имени или username.
update	string (date-time) | null	Когда это значение было заменено.

Group membership

Поле	Тип	Описание
data	object	{ id, title, url } — краткая информация о группе.
admin	object | null	Присутствует, только если пользователь — админ группы.
update	string (date-time) | null	Когда членство было последний раз подтверждено.

Last online

Поле	Тип	Описание
status	enum	Одно из empty, online, offline, last_week, last_month, recently.
update	string (date-time) | null	Когда статус был записан.

Premium

Поле	Тип	Описание
last_seen	string (date-time) | null	Когда у аккаунта последний раз был зафиксирован премиум.

Ошибки

• 404 — пользователь не найден.
• 400 — некорректный identifier.
• См. Ошибки.