v1

latestOpenAPI 3.1.02026-07-266827131.9 KB

Search from Public Video Sources

post/serve/api/v1/search_public

Request body

search_paramstring required

Natural-language search query. Must be non-empty.

search_type'BY_VIDEO' | 'BY_AUDIO'

Search modality. Only BY_VIDEO and BY_AUDIO are accepted here; BY_CLIP and BY_IMAGE are explicitly rejected. BY_VIDEO is treated as BY_CLIP internally.

type'TIKTOK' | 'YOUTUBE' | 'INSTAGRAM'

Source platform to search within.

top_kinteger

Maximum number of results to return. Range 1-1000.

filtering_level'low' | 'medium' | 'high'

Similarity-score filter. low=0.15, medium=0.225, high=0.4.

Example request

{
  "search_param": "Find sprint race with Usain Bolt",
  "search_type": "BY_VIDEO",
  "filtering_level": "medium"
}

Response

Successful response

codestring

msgstring

successboolean

failedboolean

Example response

{
  "code": "0000",
  "msg": "success",
  "data": [
    {
      "videoNo": "PI-600947902470296459",
      "videoName": "They played in their OPPONENTS jerseys?!?",
      "startTime": "23",
      "endTime": "27",
      "audio_ts": "...matched transcript text...",
      "score": 0.7350679636001586,
      "video_bucket": "mavi-public-video",
      "video_blob": "<scraper-id>.mp4",
      "keyframe_bucket": "mavi-public-keyframe",
      "keyframe_blob": "<uuid>/keyframe-000023.jpg"
    }
  ],
  "success": true,
  "failed": false
}