api

List videos

GET https://api.mave.io/v1/videos

List all video embeds from a space. Requires the API token.

Query params

Param Type
page integer
per_page integer (max. 100)
uploaded boolean (when adding this you can filter videos either uploaded, not uploaded or when not provided: mixed, sorted by upload)
collection string (when adding this you can filter videos by collection)
show_collections boolean (when true, collections will also be listed)

Response

{
  "current_page": 1, // the page you are looking at
  "data": [
    {
      "created": 1643723823,
      "duration": 0.108333, // duration of the video
      "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
    },
    {
      "created": 1643723737,
      "duration": null,
      "id": "k1iFD7h4rW",
      "last_upload": null,
      "name": null, // empty embed
      "object": "video",
      "poster_image": null,
      "size": null,
      "renditions": []
    },
    {
      "created": 1643723523,
      "duration": null,
      "id": "NyzCJgb28a",
      "last_upload": null,
      "name": null,
      "object": "video",
      "poster_image": null,
      "size": null,
      "renditions": []
    },
    {
      "created": 1643723504,
      "duration": null,
      "id": "rV4k65cLmE",
      "last_upload": null,
      "name": null,
      "object": "video",
      "poster_image": null,
      "size": null,
      "renditions": []
    }
  ], // 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
}
🍪 Press 'Accept' to confirm that you accept we don't use cookies. Yes, this banner is just for show!
Accept