Skip to main content
GET
/
video
List videos
curl --request GET \
  --url https://api.videodb.io/video/ \
  --header 'x-access-token: <api-key>'
{
  "success": true,
  "data": {
    "videos": [
      {
        "id": "m-12345",
        "name": "video.mp4",
        "description": "Video description",
        "collection_id": "default",
        "length": 120.5,
        "size": 1048576,
        "stream_url": "https://stream.videodb.io/v/12345",
        "player_url": "https://console.videodb.io/player/12345",
        "thumbnail_url": "https://assets.videodb.io/thumb/12345.jpg",
        "created_at": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.videodb.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve all videos from a collection with full metadata for each video including duration, thumbnails, and stream URLs. 
import videodb

conn = videodb.connect(api_key="your_api_key")
coll = conn.get_collection()

# Get all videos
videos = coll.get_videos()

for video in videos:
    print(f"Video: {video.name} ({video.id})")
    print(f"Duration: {video.length}s")
  • Returns all videos within a specific collection
  • Each video object contains complete metadata (ID, name, duration, stream URL, thumbnail)
  • Videos are organized at the collection level
  • Video list includes only videos belonging to the authenticated user’s collections

Authorizations

​
x-access-token
string
header
required

API key for authentication (sk-xxx format)

Query Parameters

​
collection_id
string
Example:

"default"

​
page_index
integer
Example:

0

​
count
integer
Required range: x <= 5000
Example:

50

Response

200 - application/json

List of videos

​
success
boolean
Example:

true

​
data
object