list_videos
Read-onlyIdempotent
Browse and search video metadata using filters for date, collection, and pagination. Returns essential video info like duration and filename.
Instructions
Browse and search video metadata with powerful filtering options. Use this to explore available videos, find specific content by date, or see what's in a collection. Returns essential video info like duration, filename, and IDs needed for other tools. Results are paginated in 25 videos per page - use the 'page' parameter to retrieve specific pages (page 0 = first 25 videos, page 1 = next 25 videos, etc.). Each response includes page and total_pages fields. Use date filtering to focus on specific time periods, then paginate within those results.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for paginated results. Each page contains 25 videos. Defaults to 0 (first page). Use this to retrieve videos for specific pages. Increase the page number to get the next 25 videos. | |
| collection_id | No | Filter to videos in a specific collection. Use the collection ID from list_collections. Leave empty to see all user videos. | |
| created_after | No | Only show videos created after this date. Format: YYYY-MM-DD (e.g., '2024-01-15'). Useful for finding recent content. | |
| created_before | No | Only show videos created before this date. Format: YYYY-MM-DD (e.g., '2024-01-15'). Useful for filtering to older content. |