GET https://api.mave.io/v1/videos
Returns the videos directly inside one folder, ordered by creation date (newest first). Without collection, only videos in the root of the space are returned, not videos inside collections. Results are paginated, with 15 items per page by default. Requires the API token.
| Param | Type |
|---|---|
| page | positive integer (default: 1) |
| per_page | positive integer (default: 15, max. 100) |
| uploaded | boolean; use true or false to filter by upload state. Omit it to return both. |
| archived | boolean; true returns archived items. Omitted or false returns active items. |
| collection | collection ID; returns only its direct children. Omit it or pass an empty value for the space root. |
| show_collections | boolean; when true, direct child collections are included in data. |
{
"current_page": 1, // the page you are looking at
"data": [
{
"created": 1643723823,
"duration": 0.108333, // duration of the video
"width": 1920, // width of the video in pixels
"height": 1080, // height of the video in pixels
"id": "IIzFKHuukg", // this can be used to put into the component
"last_upload": 1643746229,
"name": "test.mp4", // name of the file or chosen name
"object": "video",
"poster_image": "https://image.mave.io/IIzFKHuukg.jpg?time=0", // defaults to first frame of the video
"size": 358923, // size of the video in bytes
"renditions": ["sd", "hd"], // size of the video
"subtitles": ["en", "nl"] // available subtitles
},
{
"created": 1643723737,
"duration": null,
"width": null,
"height": null,
"id": "k1iFD7h4rW",
"last_upload": null,
"name": null, // empty embed
"object": "video",
"poster_image": null,
"size": null,
"renditions": [],
"subtitles": []
},
{
"created": 1643723523,
"duration": null,
"width": null,
"height": null,
"id": "NyzCJgb28a",
"last_upload": null,
"name": null,
"object": "video",
"poster_image": null,
"size": null,
"renditions": [],
"subtitles": []
},
{
"created": 1643723504,
"duration": null,
"width": null,
"height": null,
"id": "rV4k65cLmE",
"last_upload": null,
"name": null,
"object": "video",
"poster_image": null,
"size": null,
"renditions": [],
"subtitles": []
}
], // all the video embeds that have been created
"has_more": false, // the possibility whether there are more video embeds to retrieve
"object": "list", // the type of object you're looking at
"total_items": 4, // the total of video embeds
"total_pages": 1 // the total pages that are available
}