> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replyke.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Users

> Semantic search over project 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.**

## Body Parameters

<ParamField body="query" type="string" required>
  The natural language search query (e.g., a name, username, bio text, or description).
</ParamField>

<ParamField body="limit" type="number" default="20">
  Maximum number of users to return. Maximum `50`.
</ParamField>

## Response

Returns an array of result objects ordered by similarity:

```json theme={null}
[
  {
    "similarity": 0.91,
    "record": { ...User object... }
  }
]
```

## Error Responses

<AccordionGroup>
  <Accordion title="Plan Required — 403">
    ```json theme={null}
    { "error": "Semantic search requires a paid plan", "code": "project/plan-required" }
    ```
  </Accordion>
</AccordionGroup>