Поиск пользователей по имени

GET/v1/search/1₽ за 2xx

Возвращает список пользователей, совпадающих по имени. Ответ содержит только базовые поля пользователей (id, username, name, is_bot, is_deleted). Полный профиль — через GET /v1/users/{identifier}.

Авторизация

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

Query-параметры

Имя	Тип	Обязателен	По умолчанию	Описание
name	string	да	—	Непустое имя или поисковая фраза.
raw	boolean	нет	false	Если true, возвращать только точные совпадения.

Примеры

cURL

# Полнотекстовый поиск
curl -G -H "Api-Key: $API_KEY" \
  --data-urlencode "name=john" \
  https://api.telesint.dev/v1/search/

# Точное совпадение
curl -G -H "Api-Key: $API_KEY" \
  --data-urlencode "name=John Doe" \
  --data-urlencode "raw=true" \
  https://api.telesint.dev/v1/search/

Python

import os, requests

def search_users(name: str, raw: bool = False) -> list[dict]:
    response = requests.get(
        "https://api.telesint.dev/v1/search/",
        headers={"Api-Key": os.environ["API_KEY"]},
        params={"name": name, "raw": raw},
        timeout=10,
    )
    response.raise_for_status()
    return response.json()["data"]

matches = search_users("john")

JavaScript

async function searchUsers(name, { raw = false } = {}) {
  const params = new URLSearchParams({ name, raw: String(raw) });
  const res = await fetch(
    `https://api.telesint.dev/v1/search/?${params}`,
    { headers: { 'Api-Key': process.env.API_KEY } },
  );
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  const { data } = await res.json();
  return data;
}

const users = await searchUsers('john');

Ответ — 200 OK

{
  "data": [
    {
      "id": 12345,
      "username": "johndoe",
      "name": "John Doe",
      "is_bot": false,
      "is_deleted": false
    },
    {
      "id": 67890,
      "username": null,
      "name": "John",
      "is_bot": false,
      "is_deleted": false
    }
  ]
}

Поля — data[]

Поле	Тип	Описание
id	integer	ID пользователя.
username	string | null	Username, если есть.
name	string	Отображаемое имя.
is_bot	boolean | null	true для ботов.
is_deleted	boolean | null	true для удалённых аккаунтов.

Полнотекстовый и точный поиск

• Полнотекстовый (по умолчанию, raw=false) — возвращает до 50 результатов, упорядоченных по релевантности.
• Точный (raw=true) — поле name должно совпадать с запросом ровно.

Ошибки

• 422 — параметр name отсутствует или пустой.
• См. Ошибки.