---
title: "Get visually similar items"
method: GET
path: "/items/{id}/visual-similar"
tags: ["items"]
---

# Get visually similar items

`GET /items/{id}/visual-similar`

Finds items with visually similar document images using gemini-embedding-2 image embeddings.
Compares up to 5 images from the item's source document against all other document images.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` integer
- `threshold` number

## Response `200`

OK

- ModelsVisualSimilarResponse
  - `item_id` string
  - `items` ModelsVisualSimilarItem[]
    - `classification` string — exact_duplicate, duplicate, alternative, different
    - `image_signed_url` string — Time-limited signed HTTPS URL
    - `item_id` string
    - `manufacturer` string
    - `part_number` string
    - `similarity_score` number
    - `source_filename` string
    - `title` string
  - `total` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `503` — Visual search not available

---

[API](https://skmtc.net/resourcly/apis/resourcly-api.md) · [All operations](https://skmtc.net/resourcly/apis/resourcly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/resourcly/resourcly-api/revisions/7f97d8cd0f1e/schema)