---
updatedAt: 2026-01-22T11:08:27.000Z
---

# Send Search Query

Get results for a given text or image query

The `imageBase64` or `text` fields are used to send the user query—either as a base64-encoded image or as a text string containing the user’s search.

To send a simple search query, the `query` object must include one of the following:

* **`text` (mandatory) :** A textual query string <br><span style="color:gray; font-size:0.8em;">Used only for Semantic Search campaigns</span>
* **`imageBase64` (mandatory):** A base64-encoded image string <br>Supported formats: JPG, PNG, GIF, BMP, HEIC<br>Maximum file size: 10 MB<br><span style="color:gray; font-size:0.8em;">Used only for Visual Search campaigns</span>

## Example: Sending a text query

```json
{
  "query": {
    "text": "dress",
    "pagination": {
      "numItems": 24,
      "offset": 0
    }
  }
}
```

This query returns the first 24 results for "dress".

## Example: Sending an image query

```json
{
  "query": {
    "imageBase64": "<base64 encoded image>",
  }
}
```

This query returns relevant products based on their image.

> 📌 Notes:
>
> * The `pagination` field must be included with each `text` query.
> * `imageBase64` queries do not support `pagination`.