O'xshash guruhlar

GET/v1/groups/{identifier}/similar1₽ per 2xx

Ko’rsatilgan guruhdagi kabi a’zolarga ega bo’lgan, umumiy a’zolar soni bo’yicha tartiblangan 25 tagacha mavjud guruhni qaytaradi.

Avtorizatsiya

Api-Key sarlavhasi kerak.

Yo’l parametrlari

Nom	Tur	Majburiy	Tavsif
identifier	string	ha	Guruhning raqamli ID si yoki @username.

Misollar

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');

Javob — 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
      }
    ]
  }
}

Maydonlar — data

Maydon	Tur	Tavsif
total_users	integer	Etalon guruhdagi a’zolar soni.
groups	massiv similar group	Umumiy a’zolari bo’lgan guruhlar, similar_count bo’yicha kamayish tartibida saralangan.

Similar group

Maydon	Tur	Tavsif
data	object	{ id, title, url }. To’liq profil uchun GET /v1/groups/{identifier}.
similar_count	integer	Etalon guruh bilan umumiy a’zolar soni.

Xatoliklar

• 404 — etalon guruh topilmadi.
• 400 — noto’g’ri identifier.
• Qarang Xatoliklar.