IMDb API endpoint
Returns public title video metadata and thumbnail URLs only; playback URLs and media manifests are never returned. IMDb server-truncates this connection and exposes no usable continuation cursor, so `total` can exceed returned rows and `has_more` reports that condition. Limit defaults to 50 and clamps to 100. Pass exactly one of `id` or `url`.
/imdb/title/videosReturns public metadata and thumbnail URLs for videos associated with one IMDb title. It deliberately excludes playback URLs, HLS manifests, and video bytes.
Query parameters:
id: IMDb title ID, for example tt1375666.url: absolute IMDb title URL, for example
https://www.imdb.com/title/tt1375666/.limit: metadata rows to return. Defaults to 50; maximum 100.Notable response behavior:
videos[].thumbnail describes IMDb's public preview image. It is not a
playback URL.videos[].duration_seconds is IMDb's stated duration, when supplied.videos[].primary_title identifies the production IMDb associates with the
video; it can differ from the requested title for related editorial videos.videoStrip is server-truncated and supplies no usable public
continuation cursor. total is the upstream count and has_more is true
whenever the returned slice is shorter; this endpoint does not imply deep
pagination is available.| Field | Filled in, of 4 checked | Values in the sample |
|---|---|---|
| id | 4 | |
| title | 4 | “10th Anniversary Dream Trailer” and 3 other values |
| content_type | 4 | Trailer in all 4 |
| duration_seconds | 4 | 83 to 145, median 105 |
| thumbnail | 4 | |
| primary_title | 4 | |
| position | 4 | 1 to 4, median 2 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | No | IMDb title id | tt1375666 | |
| url | string | No | Absolute https://www.imdb.com/title/<id>/ URL | https://www.imdb.com/title/tt1375666/ | |
| limit | integer | No | Rows to return, default 50, max 100 | 50 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/imdb/title/videos?limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "tt1375666",
"title": "Inception",
"limit": 50,
"url": "https://www.imdb.com/title/tt1375666/videogallery/",
"total": 35,
"has_more": true,
"videos": [
{
"id": "vi2959588889",
"title": "10th Anniversary Dream Trailer",
"content_type": "Trailer",
"duration_seconds": 105,
"thumbnail": {
"url": "https://m.media-amazon.com/images/M/example._V1_.jpg",
"width": 1905,
"height": 1071
},
"primary_title": {
"id": "tt1375666",
"title": "Inception",
"url": "https://www.imdb.com/title/tt1375666/"
},
"position": 1
}
]
}
}Request schema
No body schema
Response schema
#/definitions/imdb.titleVideosResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | imdb.TitleVideosResponse | No | ||||
| data.fetched_at | string | No | 2026-09-14T14:46:16Z | |||
| data.has_more | boolean | No | true | |||
| data.id | string | No | tt1375666 | |||
| data.limit | integer | No | 50 | |||
| data.source_url | string | No | https://www.imdb.com/title/tt1375666/videogallery/ | |||
| data.title | string | No | Inception | |||
| data.total | integer | No | 35 | |||
| data.url | string | No | https://www.imdb.com/title/tt1375666/videogallery/ | |||
| data.videos | array | No | VideoItem record, 13 fields: content_type, duration_seconds, id, position, primary_title, thumbnail, title. Described under IMDb name video metadata API. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/imdb/title/videos?limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"