Get similar users
GET/v1/users/{identifier}/similar6₽ per 2xx
Returns users ranked by the number of groups shared with the reference user, plus the groups most often shared.
Authentication
Section titled “Authentication”Api-Key header required.
Parameters
Section titled “Parameters”| Name | In | Type | Required | Description |
|---|---|---|---|---|
identifier |
path | string | yes | Numeric user ID or username, with or without @. |
pattern |
query | string | no | A known part of the similar user’s ID. Use it to limit results when some ID digits are known in advance. |
match_type |
query | string | no | How pattern is matched against the ID: starts_with, ends_with, or contains. Defaults to contains when pattern is provided. |
id_length |
query | integer | no | Required full ID length. Used only with pattern; minimum value is 2. |
Example
Section titled “Example”curl -H "Api-Key: $API_KEY" \ 'https://api.telesint.dev/v1/users/johndoe/similar?pattern=42&match_type=contains'Response — 200 OK
Section titled “Response — 200 OK”The response contains data.user_id, data.total_groups_searched, arrays of data.similar_users, and data.top_groups.
Errors
Section titled “Errors”400— invalid identifier or filter parameters.404— user or similar users not found.- See Errors.