Skip to main content
Search Users
Performs vector-similarity search over user profiles in the project using AI embeddings. Returns the most semantically relevant user profiles for the given query. Requires a paid plan with semantic search enabled. Requires an authenticated user. Send the user’s access token as Authorization: Bearer <token> — missing token → 401, invalid/expired token → 403 (refresh and retry).

Body Parameters

string
required
The natural language search query (e.g., a name, username, bio text, or description).
number
default:"20"
Maximum number of users to return. Maximum 50.

Response

Returns an array of result objects ordered by similarity:

Error Responses

The endpoint requires an authenticated user. A missing token returns a bare 401; an invalid or expired token returns a bare 403 — refresh the access token and retry.