Схожі групи

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.
• Див. Помилки.