---
title: "Search for similar assets"
method: POST
path: "/api/1/assets/similarity-search/"
tags: ["Similarity Search"]
---

# Search for similar assets

`POST /api/1/assets/similarity-search/`

Perform a similarity search for assets based on asset IDs, image URL, image data, or text query. <br><br>This endpoint uses the newer, standard UUID format of 8-4-4-4-12, and letters are lowercase. See the example for `assetIds`, and [Note on identifiers](https://api.bynder.com/docs/getting-started#note-on-identifiers) for more information. Additionally, only one of the search parameters (`assetIds`, `imageUrl`, `imageData`, `textQuery`) should be provided per request. Providing multiple parameters will result in a `400` Bad request response. Only OAuth2 authentication is supported for this endpoint, and permanent tokens are not accepted.

## Request body

- object
  - `assetIds` string[] — List of asset IDs to search similar assets for.
  - `imageUrl` string — URL of the image to find similar assets.
  - `imageData` string — Base64 encoded image data for similarity search.
  - `textQuery` string — A text query describing the image for the search.

## Response `200`

Successful response

- object
  - `assets` object[]
    - `assetId` string
    - `similarityScore` number, float

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/bynder/apis/oauth-2-0.md) · [All operations](https://skmtc.net/bynder/apis/oauth-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bynder/oauth-2-0/revisions/bb9efc864ce1/schema)