---
title: "Comm-Link Image Search by filename"
method: POST
path: "/api/comm-link-images/search"
tags: ["Comm-Links", "Images", "Search"]
---

# Comm-Link Image Search by filename

`POST /api/comm-link-images/search`

Search comm-link images by filename with optional tag filtering. Only images without a base image and with non-zero file size are returned.

## Query parameters

- `filter[tags]` string

## Request body

- object
  - `query` string, required — Search term matched against image filenames (partial match)

## Response `200`

Search for a Comm-Link Image by its filename.

- 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

- `422` — Validation error. The query field is required and must be a string between 1 and 255 characters.

## Changes

- **2026-05-21** `af03a6ba771d` — 1 breaking, 4 info
  - the response's body type changed from `array` to `object` for status `200`
  - api operation id `dbd72b035105c4dcf17ee654931fe2ff` removed and replaced with `searchCommLinkImages`
  - api tag `RSI-Website` removed
  - added the media type `application/json` for the response with the status `422`
  - …1 more
- **2026-04-24** `c096aa819d11` — 2 breaking, 10 info
  - added required request body
  - the `items/tags/items/` response's property type changed from `string` to `object` for status `200`
  - added the non-success response with the status `422`
  - added the optional property `items/base_image` to the response with the `200` status
  - …8 more
- **2026-03-29** `8ff40d443bb4` — 2 breaking, 1 warning, 3 info
  - removed the request body
  - the response's body type changed from `object` to `array` for status `200`
  - removed the optional property `data` from the response with the `200` status
  - api operation id `searchCommLinkImages` removed and replaced with `dbd72b035105c4dcf17ee654931fe2ff`
  - …2 more

[Change history](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/changes/api/comm-link-images/search/post.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)