Skip to main content
GET
/
video
/
{video_id}
Get video details
curl --request GET \
  --url https://api.videodb.io/video/{video_id} \
  --header 'x-access-token: <api-key>'
{
  "success": true,
  "data": {
    "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 complete metadata for a specific video including duration, transcript status, thumbnail, and stream URLs. 
import videodb

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

# Get video from collection
video = coll.get_videos()[0]

print(f"Video ID: {video.id}")
print(f"Name: {video.name}")
print(f"Duration: {video.length} seconds")
print(f"Stream URL: {video.stream_url}")
  • Video IDs start with the prefix v-
  • Each video maintains its own stream URL for playback
  • Video metadata includes length in seconds, name, description, and thumbnail URL
  • Videos belong to a collection and inherit collection-level access controls

Authorizations

​
x-access-token
string
header
required

API key for authentication (sk-xxx format)

Path Parameters

​
video_id
string
required
Pattern: ^m-
Example:

"m-12345"

Query Parameters

​
collection_id
string
Example:

"default"

Response

200 - application/json

Video details

​
success
boolean
Example:

true

​
data
object