Skip to main content
Version: v1.1

List Videos

Use this API to retrieve a paginated list of videos that have been uploaded to the platform. You can optionally filter the results by video name, video ID, folder, or processing status.

Prerequisites

  • You have uploaded videos to the platform using the Upload API.
  • You have a valid memories.ai API key.

Host URL

  • https://api.memories.ai

Endpoint

POST /serve/api/video/list_videos

Request Example

import requests
headers = {"Authorization": "<API_KEY>"}

json_body = {
"page": page,
"size": size,
"video_name": "<video_name>",
"video_no": "<video_no>",
"folder_id": "<folder_id>",
"status": "<status>",
}

response = requests.post("https://api.memories.ai/serve/api/video/list_videos", headers=headers, json=json_body)
print(response.json())

Request Parameters

NameLocationTypeRequiredDescription
pagequeryintNoPage number for pagination (default: 1)
sizequeryintNoNumber of results per page (default: 20)
video_namequerystringNoFilter by partial or exact video name
video_noquerystringNoFilter by unique video ID
folder_idqueryintNoFilter videos by folder ID
statusquerystringNoFilter by video status (must match internal VideoStatus enum)
AuthorizationheaderstringYesYour API key for authentication

Response Example

{
"code": "0000",
"msg": "success",
"data": {
"videos": [
{
"duration": "12",
"size": "3284512",
"status": "PARSE",
"cause": "null",
"video_no": "VI606404158946574336",
"video_name": "182082-867762198_tiny",
"create_time": "1754037217992"
},
{
"duration": "61",
"size": "5324808",
"status": "PARSE",
"cause": "null",
"video_no": "VI606402870447996928",
"video_name": "test_video_gz_visual_understanding_s36_gun_6_special_gun_6",
"create_time": "1754036910783"
},
{
"duration": "44",
"size": "3583477",
"status": "PARSE",
"cause": "null",
"video_no": "VI606401846039576576",
"video_name": "[email protected]_1747479033469",
"create_time": "1754036666561"
}
],
"current_page": 1,
"page_size": 200,
"total_count": "3"
},
"success": true,
"failed": false
}

Response Structure

NameTypeDescription
codestringResponse status code
msgstringHuman-readable status message
dataobjectPaginated video metadata
» videoslist of objectsList of video entries
»» durationstringLength of the video in seconds
»» sizestringFile size in bytes
»» statusstringProcessing status (e.g., PARSE, DONE, FAILED)
»» causestringReason for failure if status is failed (or "null")
»» video_nostringUnique video identifier
»» video_namestringName of the video
»» create_timestringUpload timestamp (Unix milliseconds format)
» current_pageintCurrent page number
» page_sizeintNumber of videos per page
» total_countstringTotal number of videos matching the query
successbooleanIndicates if the request was successful
failedbooleanIndicates if the request failed

Notes

  • Combine filters for more specific search results (e.g., by folder_id and status).
  • Use this API to find video_no values for downstream processing or retrieval tasks.