Get similar groups

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

Returns up to 25 available groups that share members with the given group, ranked by the number of shared members.

Authentication

Api-Key header required.

Path parameters

Name	Type	Required	Description
identifier	string	yes	Numeric group ID or @username.

Examples

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

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

Fields — data

Field	Type	Notes
total_users	integer	Member count of the reference group.
groups	array of similar group	Groups that share members, sorted by similar_count descending.

Similar group

Field	Type	Notes
data	object	{ id, title, url }. Fetch the full group via GET /v1/groups/{identifier}.
similar_count	integer	Number of members shared with the reference group.

Errors

• 404 — reference group not found.
• 400 — invalid identifier.
• See Errors.