Skip to main content
GET
/
video
/
{video_id}
/
scenes
/
Get video scenes
curl --request GET \
  --url https://api.videodb.io/video/{video_id}/scenes/ \
  --header 'x-access-token: <api-key>'
{
  "success": true,
  "data": [
    {
      "scene_id": "scene-123",
      "start_time": 10.5,
      "end_time": 25.3,
      "description": "Scene description",
      "thumbnail_url": "https://assets.videodb.io/scene/123.jpg"
    }
  ]
}
Retrieve a previously extracted scene collection by its ID. 
import videodb

conn = videodb.connect(api_key="your_api_key")
coll = conn.get_collection()
video = coll.get_videos()[0]

# Get a specific scene collection
scene_collection = video.get_scene_collection("scene_collection_id")

print(f"Scenes in collection: {len(scene_collection.scenes)}")
for scene in scene_collection.scenes:
    print(f"Scene {scene.id}: {scene.start}s - {scene.end}s")
    for frame in scene.frames:
        print(f"  Frame {frame.id} at {frame.frame_time}s")
  • Scene collection IDs follow the pattern sc- prefix
  • Returns SceneCollection containing multiple Scene objects
  • Each scene includes all extracted frames with URLs
  • Frames are ordered and can be displayed as galleries
  • Use scene IDs or frame IDs to get specific elements

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"

Response

200 - application/json

List of scenes

​
success
boolean
Example:

true

​
data
object[]