Skip to main content
GET
/
video
/
{video_id}
/
thumbnail
Get video thumbnail
curl --request GET \
  --url https://api.videodb.io/video/{video_id}/thumbnail/ \
  --header 'x-access-token: <api-key>'
{
  "success": true,
  "data": {
    "thumbnail_url": "https://assets.videodb.io/thumb/12345.jpg"
  }
}
Retrieve the default thumbnail URL for a video. This is automatically generated when the video is uploaded. 
import videodb

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

# Get default thumbnail URL (no time parameter)
thumbnail_url = video.generate_thumbnail()

print(f"Thumbnail URL: {thumbnail_url}")
  • Returns thumbnail as a URL string (not an Image object)
  • Thumbnail is auto-generated from the video at upload time
  • Thumbnail URL can be used directly in img tags for web display
  • If stored in video.thumbnail_url, this method returns cached version
  • For custom thumbnails at specific timestamps, use create-thumbnail endpoint

Authorizations

​
x-access-token
string
header
required

API key for authentication (sk-xxx format)

Path Parameters

​
video_id
string
required
Example:

"m-12345"

Query Parameters

​
timestamp
number
Example:

10.5

Response

200 - application/json

Thumbnail URL

​
success
boolean
Example:

true

​
data
object