---
title: "Comm-Link Reverse Image Similar Search"
method: GET
path: "/api/comm-link-images/{image}/similar"
tags: ["Comm-Links", "Search"]
---

# Comm-Link Reverse Image Similar Search

`GET /api/comm-link-images/{image}/similar`

Find Comm-Link images similar to an existing RSI-hosted image.

## Path parameters

- `image` integer, required

## Query parameters

- `similarity` integer

## Response `200`

List of similar Comm-Link images

- object
  - `data` CommLinkImage[]
    - `id` integer — Internal database identifier.
    - `name` string — File name or path segment of the image.
    - `rsi_url` string, uri — Full URL to the image on the RSI media CDN.
    - `api_url` string, uri, nullable — API URL for this image resource.
    - `alt` string — Alternative text for the image.
    - `size` integer — File size in bytes.
    - `mime_type` string — MIME type of the image file.
    - `last_modified` string, date-time — ISO 8601 timestamp of when the image was last modified on the CDN.
    - `tags` object[], nullable — Tags associated with the image when the `tags` relation is loaded.
      - `name` string — Tag name.
      - `translated_name` string, nullable — Translated tag name.
      - `images_count` integer — Number of images sharing this tag.
    - `similar_url` string, uri — API URL to find visually similar images.
    - `comm_links` object[], nullable — Comm-Links that reference this image, included when the `commLinks` relation is loaded.
      - `id` integer — CIG identifier of the Comm-Link
      - `title` string — Title of the Comm-Link
      - `api_url` string, uri — API URL for this Comm-Link resource.
      - `web_url` string, uri — Public web URL for this Comm-Link.
    - `duplicates` object[], nullable — Duplicate images that share the same base image, included when the `duplicates` relation is loaded.
      - `id` integer — Internal database ID of the duplicate image
      - `name` string — File name of the duplicate image
    - `base_image` object, nullable — The original image this is a duplicate of, included when the `baseImage` relation is loaded.
      - `id` integer — Internal database ID of the base image
      - `name` string — File name of the base image
    - `similarity` integer, nullable — Similarity percentage to the search image. Only present in reverse image search results.

## Other responses

- `401` — Unauthenticated. Bearer token is required for similar image search.
- `404` — Comm-Link image not found.
- `429` — Rate limit exceeded. Similar image search is limited to 10 requests per minute.

## Changes

- **2026-05-21** `af03a6ba771d` — 1 breaking, 6 info
  - the response's body type changed from `array` to `object` for status `200`
  - api operation id `fade67e6a8c4629ba8554b85925c1148` removed and replaced with `findSimilarImages`
  - api tag `RSI-Website` removed
  - added the media type `application/json` for the response with the status `404`
  - …3 more
- **2026-04-24** `c096aa819d11` — 1 breaking, 9 info
  - the `items/tags/items/` response's property type changed from `string` to `object` for status `200`
  - added the optional property `items/base_image` to the response with the `200` status
  - added the optional property `items/comm_links` to the response with the `200` status
  - added the optional property `items/duplicates` to the response with the `200` status
  - …6 more
- **2026-04-23** `01e52e527dd6` — 1 breaking, 9 info
  - the response property `items/api_url` became nullable for the status `200`
  - the endpoint scheme security `sanctum` was added to the API
  - the endpoint scheme security `securityScheme AND type AND bearerFormat AND scheme` was removed from the API
  - added the optional property `items/alt` to the response with the `200` status
  - …6 more
- …earlier changes not shown

[Full history](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/changes/api/comm-link-images/:image/similar/get.md)

---

[API](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api.md) · [All operations](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/llms.txt) · [OpenAPI document](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/revisions/c1df9b1bab38?raw)