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
Name | Location | Type | Required | Description |
---|---|---|---|---|
page | query | int | No | Page number for pagination (default: 1) |
size | query | int | No | Number of results per page (default: 20) |
video_name | query | string | No | Filter by partial or exact video name |
video_no | query | string | No | Filter by unique video ID |
folder_id | query | int | No | Filter videos by folder ID |
status | query | string | No | Filter by video status (must match internal VideoStatus enum) |
Authorization | header | string | Yes | Your 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
Name | Type | Description |
---|---|---|
code | string | Response status code |
msg | string | Human-readable status message |
data | object | Paginated video metadata |
» videos | list of objects | List of video entries |
»» duration | string | Length of the video in seconds |
»» size | string | File size in bytes |
»» status | string | Processing status (e.g., PARSE , DONE , FAILED ) |
»» cause | string | Reason for failure if status is failed (or "null" ) |
»» video_no | string | Unique video identifier |
»» video_name | string | Name of the video |
»» create_time | string | Upload timestamp (Unix milliseconds format) |
» current_page | int | Current page number |
» page_size | int | Number of videos per page |
» total_count | string | Total number of videos matching the query |
success | boolean | Indicates if the request was successful |
failed | boolean | Indicates if the request failed |
Notes
- Combine filters for more specific search results (e.g., by
folder_id
andstatus
). - Use this API to find
video_no
values for downstream processing or retrieval tasks.