Skip to main content
POST
/
serve
/
api
/
v1
/
search_public_similar_images
Search Public Videos by Image
curl --request POST \
  --url https://api.memories.ai/serve/api/v1/search_public_similar_images \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form type=TIKTOK \
  --form unique_id=default \
  --form similarity=0.85
{
  "code": "0000",
  "msg": "success",
  "data": [
    {
      "videoNo": "PI-600947902470296459",
      "videoName": "Sample public video title",
      "startTime": "79",
      "endTime": "82",
      "score": 0.8631
    },
    {
      "videoNo": "PI-600947902470296460",
      "videoName": "Another public video",
      "startTime": "32",
      "endTime": "35",
      "score": 0.8712
    }
  ],
  "success": true,
  "failed": false
}

Documentation Index

Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt

Use this file to discover all available pages before exploring further.

Endpoints

1. Search Public Similar Images

POST /v1/search_public_similar_images

2. Search Private Similar Images

POST /v1/search_similar_images

Authentication

All requests must include the API key in the Authorization header.
Authorization: <your_key>

Authorizations

Authorization
string
header
required

Body

multipart/form-data
file
file
required

Query image. Allowed extensions: .jpg/.jpeg/.png/.gif/.bmp/.webp. Content-Type must start with image/. Max 20 MB.

type
enum<string>
default:TIKTOK

Source platform to search within.

Available options:
TIKTOK,
YOUTUBE,
INSTAGRAM
unique_id
string
default:default

Scope identifier for the authenticated account.

similarity
number<double>
default:0.85

Minimum similarity threshold (0-1). Results below this score are filtered out.

Required range: 0 <= x <= 1

Response

200 - application/json

Successful response

code
string
Example:

"0000"

msg
string
Example:

"success"

data
object[]
success
boolean
Example:

true

failed
boolean
Example:

false