---
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.

---

[API](https://skmtc.net/starcitizenwiki/apis/star-citizen-wiki-api.md) · [All operations](https://skmtc.net/starcitizenwiki/apis/star-citizen-wiki-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/starcitizenwiki/star-citizen-wiki-api/versions/8b259bb9a44c/schema)