List Videos

GET /library/{libraryId}/videos

List Videos

cURL

curl --request GET \
  --url https://video.bunnycdn.com/library/{libraryId}/videos \
  --header 'AccessKey: <api-key>'

200

{
  "totalItems": 123,
  "currentPage": 123,
  "itemsPerPage": 123,
  "items": [
    {
      "videoLibraryId": 123,
      "guid": "<string>",
      "title": "<string>",
      "dateUploaded": "2023-11-07T05:31:56Z",
      "views": 123,
      "isPublic": true,
      "length": 123,
      "status": 0,
      "framerate": 123,
      "width": 123,
      "height": 123,
      "outputCodecs": "<string>",
      "thumbnailCount": 123,
      "encodeProgress": 123,
      "storageSize": 123,
      "hasMP4Fallback": true,
      "averageWatchTime": 123,
      "totalWatchTime": 123,
      "description": "<string>",
      "rotation": 123,
      "availableResolutions": "<string>",
      "captions": [
        {
          "srclang": "<string>",
          "label": "<string>",
          "version": 123
        }
      ],
      "collectionId": "<string>",
      "thumbnailFileName": "<string>",
      "thumbnailUrl": "<string>",
      "thumbnailBlurhash": "<string>",
      "category": "<string>",
      "chapters": [
        {
          "title": "<string>",
          "start": 123,
          "end": 123
        }
      ],
      "moments": [
        {
          "label": "<string>",
          "timestamp": 123
        }
      ],
      "metaTags": [
        {
          "property": "<string>",
          "value": "<string>"
        }
      ],
      "transcodingMessages": [
        {
          "timeStamp": "2023-11-07T05:31:56Z",
          "level": 0,
          "issueCode": 0,
          "message": "<string>",
          "value": "<string>"
        }
      ],
      "jitEncodingEnabled": true,
      "smartGenerateStatus": 0,
      "smartGenerateFeaturesStatus": {
        "title": 0,
        "description": 0,
        "chapters": 0,
        "moments": 0
      },
      "hasOriginal": true,
      "originalHash": "<string>",
      "hasHighQualityPreview": true
    }
  ]
}

Authorizations

AccessKey · string · header · required

AccessKey based authentication

Path Parameters

libraryId · integer<int64> · required

The ID of the video library.

Query Parameters

page · integer<int32> · default: 1

The page number to return, 1-based; values below 1 are treated as 1.

itemsPerPage · integer<int32> · default: 100

The number of items to return per page, clamped to a range of 10-1000.

search · string | null · default: ""

Filters videos by title, case-insensitive substring match.

collection · string | null · default: ""

Filters videos by collection ID.

orderBy · string | null · default: date

The field to order results by. Possible values: date, title — any other value falls back to date.

Response

200

application/json

The list of videos for the current parameters

totalItems · integer<int64>

The total number of items across all pages matching the query, not just the current page.

currentPage · integer<int64>

The current page number of the result set (1-based).

itemsPerPage · integer<int32>

The effective page size after clamping the requested value; the last page may contain fewer items.

items · object[] | null

The items on the current page, in the order returned by the query; an empty list if no results match.

Show child attributes