Docs menu

IMDb API endpoint

IMDb name video metadata API

Returns public person video metadata and thumbnail URLs only; playback URLs and media manifests are never returned. IMDb caps the upstream slice at 100 and provides 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`.

GETapiKey2 credits/requestIMDbimdb.nameVideosResponseDoc/imdb/name/videos

Endpoint facts

Method: GET
API path: /imdb/name/videos
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: IMDb
Response schema: #/definitions/imdb.nameVideosResponseDoc

IMDb Scraper API Try IMDb name video metadata API in Playground IMDb API documentation

How this endpoint behaves

Returns public metadata and thumbnail URLs for videos associated with one IMDb person. It deliberately excludes playback URLs, HLS manifests, and video bytes.

Query parameters:

id: IMDb name ID, for example nm0000151.
url: absolute IMDb name URL, for example https://www.imdb.com/name/nm0000151/.
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[].primary_title identifies the production IMDb associates with the video and includes an IMDb title URL when present.
IMDb honours limit only up to 100 and currently returns no usable continuation cursor even when total is larger. has_more therefore reports that the bounded response is incomplete; this endpoint does not offer deep pagination.
A well-formed but unresolvable name ID returns a not-found error.
If IMDb removes the video field or changes its shape, the endpoint fails closed with an upstream parser-drift error.

Live monitoring

Monitored request: GET /imdb/name/videos?id=nm0000151&limit=5
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.15 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /imdb/name/videos?id=nm0000151&limit=40
Items in videos: 40
Fields filled in every checked item: 7

Field	Filled in, of 40 checked	Values in the sample
id	40
title	40	“Morgan Freeman \| Career Retrospective” and 12 other values
content_type	40	Clip (28), Interview (12)
duration_seconds	40	26 to 299, median 52
thumbnail	40
primary_title	40
position	40	1 to 40, median 20

Request parameters

Parameter	Type	Required	Description	Example
id	string	No	IMDb name id	nm0000151
url	string	No	Absolute https://www.imdb.com/name/<id>/ URL	https://www.imdb.com/name/nm0000151/
limit	integer	No	Rows to return, default 50, max 100	50
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/imdb/name/videos?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "nm0000151",
    "name": "Morgan Freeman",
    "limit": 50,
    "url": "https://www.imdb.com/name/nm0000151/videogallery/",
    "total": 214,
    "has_more": true,
    "videos": [
      {
        "id": "vi1137360921",
        "title": "Morgan Freeman | Career Retrospective",
        "content_type": "Clip",
        "duration_seconds": 105,
        "thumbnail": {
          "url": "https://m.media-amazon.com/images/M/example._V1_.jpg",
          "width": 1920,
          "height": 1080
        },
        "primary_title": {
          "id": "tt8544204",
          "title": "IMDb Supercuts",
          "url": "https://www.imdb.com/title/tt8544204/"
        },
        "position": 1
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/imdb.nameVideosResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	imdb.NameVideosResponse	No
data.fetched_at	string	No	2026-09-14T14:46:16Z
data.has_more	boolean	No	true
data.id	string	No	nm0000151
data.limit	integer	No	50
data.name	string	No	Morgan Freeman
data.source_url	string	No	https://www.imdb.com/name/nm0000151/videogallery/
data.total	integer	No	214
data.url	string	No	https://www.imdb.com/name/nm0000151/videogallery/
data.videos	array	No
data.videos[].content_type	string	No	Trailer
data.videos[].duration_seconds	integer	No	105
data.videos[].id	string	No	vi2959588889
data.videos[].position	integer	No	1
data.videos[].primary_title	imdb.VideoPrimaryTitle	No
data.videos[].primary_title.id	string	No	tt1375666
data.videos[].primary_title.title	string	No	Inception
data.videos[].primary_title.url	string	No	https://www.imdb.com/title/tt1375666/
data.videos[].thumbnail	imdb.VideoThumbnail	No
data.videos[].thumbnail.height	integer	No	1071
data.videos[].thumbnail.url	string	No	https://m.media-amazon.com/images/M/MV5BMTQ1ZmIzOTAtNDcwZi00NDVkLWE4NWItYWNhZGY1MmVlZGU0XkEyXkFqcGdeQWRvb2xpbmhk._V1_.jpg
data.videos[].thumbnail.width	integer	No	1905
data.videos[].title	string	No	10th Anniversary Dream Trailer
msg	string	No	OK

Failure responses

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

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/imdb/name/videos?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More IMDb endpoint docs IMDb Scraper API IMDb title charts API documentation IMDb image types API documentation IMDb name detail API documentation IMDb name awards API documentation IMDb name credits API documentation IMDb name images API documentation

Open in Playground Back to group

Docs menu

IMDb API endpoint

IMDb name video metadata API

GETapiKey2 credits/requestIMDbimdb.nameVideosResponseDoc/imdb/name/videos

Endpoint facts

Method: GET
API path: /imdb/name/videos
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: IMDb
Response schema: #/definitions/imdb.nameVideosResponseDoc

IMDb Scraper API Try IMDb name video metadata API in Playground IMDb API documentation

How this endpoint behaves

Returns public metadata and thumbnail URLs for videos associated with one IMDb person. It deliberately excludes playback URLs, HLS manifests, and video bytes.

Query parameters:

id: IMDb name ID, for example nm0000151.
url: absolute IMDb name URL, for example https://www.imdb.com/name/nm0000151/.
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[].primary_title identifies the production IMDb associates with the video and includes an IMDb title URL when present.
IMDb honours limit only up to 100 and currently returns no usable continuation cursor even when total is larger. has_more therefore reports that the bounded response is incomplete; this endpoint does not offer deep pagination.
A well-formed but unresolvable name ID returns a not-found error.
If IMDb removes the video field or changes its shape, the endpoint fails closed with an upstream parser-drift error.

Live monitoring

Monitored request: GET /imdb/name/videos?id=nm0000151&limit=5
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.15 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /imdb/name/videos?id=nm0000151&limit=40
Items in videos: 40
Fields filled in every checked item: 7

Field	Filled in, of 40 checked	Values in the sample
id	40
title	40	“Morgan Freeman \| Career Retrospective” and 12 other values
content_type	40	Clip (28), Interview (12)
duration_seconds	40	26 to 299, median 52
thumbnail	40
primary_title	40
position	40	1 to 40, median 20

Request parameters

Parameter	Type	Required	Description	Example
id	string	No	IMDb name id	nm0000151
url	string	No	Absolute https://www.imdb.com/name/<id>/ URL	https://www.imdb.com/name/nm0000151/
limit	integer	No	Rows to return, default 50, max 100	50
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/imdb/name/videos?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "nm0000151",
    "name": "Morgan Freeman",
    "limit": 50,
    "url": "https://www.imdb.com/name/nm0000151/videogallery/",
    "total": 214,
    "has_more": true,
    "videos": [
      {
        "id": "vi1137360921",
        "title": "Morgan Freeman | Career Retrospective",
        "content_type": "Clip",
        "duration_seconds": 105,
        "thumbnail": {
          "url": "https://m.media-amazon.com/images/M/example._V1_.jpg",
          "width": 1920,
          "height": 1080
        },
        "primary_title": {
          "id": "tt8544204",
          "title": "IMDb Supercuts",
          "url": "https://www.imdb.com/title/tt8544204/"
        },
        "position": 1
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/imdb.nameVideosResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	imdb.NameVideosResponse	No
data.fetched_at	string	No	2026-09-14T14:46:16Z
data.has_more	boolean	No	true
data.id	string	No	nm0000151
data.limit	integer	No	50
data.name	string	No	Morgan Freeman
data.source_url	string	No	https://www.imdb.com/name/nm0000151/videogallery/
data.total	integer	No	214
data.url	string	No	https://www.imdb.com/name/nm0000151/videogallery/
data.videos	array	No
data.videos[].content_type	string	No	Trailer
data.videos[].duration_seconds	integer	No	105
data.videos[].id	string	No	vi2959588889
data.videos[].position	integer	No	1
data.videos[].primary_title	imdb.VideoPrimaryTitle	No
data.videos[].primary_title.id	string	No	tt1375666
data.videos[].primary_title.title	string	No	Inception
data.videos[].primary_title.url	string	No	https://www.imdb.com/title/tt1375666/
data.videos[].thumbnail	imdb.VideoThumbnail	No
data.videos[].thumbnail.height	integer	No	1071
data.videos[].thumbnail.url	string	No	https://m.media-amazon.com/images/M/MV5BMTQ1ZmIzOTAtNDcwZi00NDVkLWE4NWItYWNhZGY1MmVlZGU0XkEyXkFqcGdeQWRvb2xpbmhk._V1_.jpg
data.videos[].thumbnail.width	integer	No	1905
data.videos[].title	string	No	10th Anniversary Dream Trailer
msg	string	No	OK

Failure responses

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

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/imdb/name/videos?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

IMDb name video metadata API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

IMDb name video metadata API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related