---
title: "Search Public Videos by Image"
method: POST
path: "/serve/api/v1/search_public_similar_images"
---

# Search Public Videos by Image

`POST /serve/api/v1/search_public_similar_images`

## Request

- Base URL: `https://mavi-backend.memories.ai/serve/api/v2`
- URL: `https://mavi-backend.memories.ai/serve/api/v2/serve/api/v1/search_public_similar_images`
- Auth: API key in header `Authorization`

## Request body `multipart/form-data`

- SearchSimilarImagesRequest
  - `file` string, binary, required: Query image. Allowed extensions: .jpg/.jpeg/.png/.gif/.bmp/.webp. Content-Type must start with image/. Max 20 MB.
  - `type` 'TIKTOK' | 'YOUTUBE' | 'INSTAGRAM': Source platform to search within.
  - `similarity` number, double: Minimum similarity threshold (0-1). Results below this score are filtered out.

## Response `200`

Successful response

- SearchSimilarImagesResponse
  - `code` string
  - `msg` string
  - `data` object[]
    - `videoNo` string
    - `videoName` string
    - `startTime` string
    - `endTime` string
    - `score` number, double
    - `video_bucket` string: GCS bucket of our cached copy of the public video. Omitted when the storage location cannot be resolved.
    - `video_blob` string: GCS blob path of the cached video. Use with video_bucket at GET /serve/api/v2/download to fetch the file directly.
    - `keyframe_bucket` string: GCS bucket of the matched keyframe image.
    - `keyframe_blob` string: GCS blob path of the matched keyframe image.
  - `success` boolean
  - `failed` boolean

---

[API](https://skmtc.dev/memories/apis/screenplay-extraction-api.md) - [All operations](https://skmtc.dev/memories/apis/screenplay-extraction-api/llms.txt) - [OpenAPI document](https://skmtc.dev/memories/apis/screenplay-extraction-api/revisions/720c8c144ddc?raw)
