Skip to main content
Version: v1.0

Search Video

Using a natural language query, this API will searches through all processed videos and ranks the results within milliseconds. MAVI retrieves and ranks videos based on visual information in a manner similar to human perception. With this API, developers can access the most relevant videos from their entire library.

Host URL

POST /api/serve/video/searchAI

Request Example

import requests

headers = {"Authorization": "<YOUR_ACCESS_TOKEN>"} # access token
data = {"searchValue": "<YOUR_PROMPT>"}
response = requests.post(
"https://mavi-backend.memories.ai/api/serve/video/searchAI",
headers=headers,
json=data
)
print(response.json())

Replace YOUR_ACCESS_TOKEN in the code above with your actual access token and YOUR_PROMPT with your search query. You can search for relevant videos you've uploaded using natural language.

Request Body

{
"searchValue": "string"
}

Request Parameters

NameLocationTypeRequiredDescription
AuthorizationheaderstringYesauthorization token
searchValuebodystringYesnatural language prompt

Response Example

Status code 200

{
"code": "string",
"msg": "string",
"data": {
"videos": [
{
"videoNo": "string",
"videoName": "string",
"videoStatus": "string",
"uploadTime": "string",
"duration": "string"
}
]
}
}

Response Result

Status codeStatus code msgDescriptionData
200OKnoneInline

Response Structure

Status code 200

NameTypeRequiredRestrictionDescription
codestringtruenoneresponse code
msgstringtruenonemessage with response code
dataobjecttruenoneJSON data
» videos[object]falsenoneJSON data
»» videoNostringtruenonevideo number
»» videoNamestringfalsenonevideo name
»» videoStatusstringfalsenonevideo status
»» uploadTimestringfalsenoneupload timestamp(ms)
»» durationstringfalsenonevideo length(seconds)