Skip to main content
GET
/
video
/
{video_id}
/
thumbnails
Get all video thumbnails
curl --request GET \
  --url https://api.videodb.io/video/{video_id}/thumbnails/ \
  --header 'x-access-token: <api-key>'
{
  "success": true,
  "data": [
    {
      "timestamp": 10.5,
      "url": "https://assets.videodb.io/thumb/12345_10.jpg"
    }
  ]
}

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 custom thumbnails that have been generated for a video at different timestamps. 
import videodb

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

# Get all thumbnails
thumbnails = video.get_thumbnails()

for thumbnail in thumbnails:
    print(f"Thumbnail ID: {thumbnail.id}")
    print(f"URL: {thumbnail.url}")
  • Returns list of Image objects for each generated custom thumbnail
  • Only includes custom thumbnails created with create-thumbnail endpoint
  • Each Image object contains ID, URL, and metadata
  • Default auto-generated thumbnail is not included in this list
  • Use to manage multiple thumbnails created at different video timestamps

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 thumbnails

​
success
boolean
Example:

true

​
data
object[]