Skip to main content

Search users

GET /search/username/{query}

Search users by name/login; the standard way to resolve username to pk. Upstream: users/search/?q=.

Request​

ParameterInRequiredDescription
querypathyesSearch query
countquerynoResults per page, 1-50 (default 10)

Response​

{
"num_results": 3,
"users": [
{
"pk": 4663052,
"username": "durov",
"full_name": "Pavel Durov",
"is_private": false,
"is_verified": true,
"profile_pic_url": "https://..."
}
]
}
note

The exact match is usually first — verify by comparing the username field.