Похожие группы

GET/v1/groups/{identifier}/similar1₽ за 2xx

Возвращает до 25 доступных групп, в которых состоят те же участники, что и в указанной, отсортированных по числу общих участников.

Авторизация

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

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

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

Примеры

cURL

curl -H "Api-Key: $API_KEY" \
  https://api.telesint.dev/v1/groups/example_group/similar

Python

import os, requests

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

result = get_similar_groups("example_group")

JavaScript

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

const { total_users, groups } = await getSimilarGroups('example_group');

Ответ — 200 OK

{
  "data": {
    "total_users": 1000,
    "groups": [
      {
        "data": { "id": 12345, "title": "Related Group A", "url": "related_a" },
        "similar_count": 243
      },
      {
        "data": { "id": 67890, "title": "Related Group B", "url": "related_b" },
        "similar_count": 87
      }
    ]
  }
}

Поля — data

Поле	Тип	Описание
total_users	integer	Число участников эталонной группы.
groups	массив similar group	Группы с общими участниками, отсортированы по similar_count по убыванию.

Similar group

Поле	Тип	Описание
data	object	{ id, title, url }. Полный профиль — через GET /v1/groups/{identifier}.
similar_count	integer	Число общих участников с эталонной группой.

Ошибки

• 404 — эталонная группа не найдена.
• 400 — некорректный identifier.
• См. Ошибки.