Docs menu

IMDb API endpoint

IMDb name images API

Returns image metadata from a person's media index, including the original image URL, dimensions, caption and credited people. Filter by image type with `type`, which accepts a single value or a comma-separated list of: `behind_the_scenes`, `event`, `poster`, `product`, `production_art`, `publicity`, `still_frame`, `unknown`. Omit `type` to return every type. Limit defaults to 50 and clamps to 1000. Pass exactly one of `id` or `url`.

GETapiKey2 credits/requestIMDbimdb.nameImagesResponseDoc/imdb/name/images

Endpoint facts

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

IMDb Scraper API Try IMDb name images API in Playground IMDb API documentation

How this endpoint behaves

Returns image metadata from a person's media index, including the original image URL, dimensions, caption, attribution and the people IMDb credits in each image.

Query parameters:

id: IMDb name ID, for example nm0000151.
url: absolute IMDb name URL, for example https://www.imdb.com/name/nm0000151/.
type: image type filter. Accepts a single value or a comma-separated list of behind_the_scenes, event, poster, product, production_art, publicity, still_frame, unknown. Omit it to return every type. Call /api/v1/imdb/image-types for the same list with display labels.
limit: rows to return. Defaults to 50; maximum 1000.

Notable response behavior:

images[].url is the original m.media-amazon.com asset. The endpoint returns metadata only and never proxies or re-hosts the image bytes; those URLs are fetchable directly.
images[].position is the 1-based rank of the row within the filtered result, matching the order IMDb's own gallery uses.
images[].names lists the people IMDb credits in the image, each with an IMDb name ID and profile URL when available.
images[].created_on is the date IMDb added the image.
images[].countries and images[].languages tag region-specific artwork (each with an ISO-style code and a display name). Posters commonly carry them; still frames usually do not.
images[].titles identifies which production each photo came from — IMDb id, title, year and URL. This is usually the field you want when turning a person's media index into per-film images.
data.total is the number of images matching the filter, and data.has_more is true when the response returns fewer than that.
data.type_counts is a per-type breakdown of the whole media index. It is returned only when no type filter is applied, because IMDb's own counts honour the active filter.
An unrecognized type returns an invalid-parameter error rather than an empty list.
A well-formed but unresolvable name ID returns a not-found error, so it is never confused with a person whose media index is genuinely empty.
If IMDb changes its payload, the endpoint returns an upstream parser-drift error rather than an empty or partial success.

Live monitoring

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

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /imdb/name/images?id=nm0000151&limit=40&type=still_frame
Fields returned with a value: 8

Field	In the sample	Value in the sample
id	Has a value
name	Has a value	“Morgan Freeman”
types	Has a value	1 entry
limit	Has a value
url	Has a value	imdb.com
total	Has a value	493
has_more	Has a value	true
images	Has a value	40 entries

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/
type	string	No	Image type filter, single value or comma-separated list Allowed values: behind_the_scenes, event, poster, product, production_art, publicity, still_frame, unknown.	still_frame
limit	integer	No	Rows to return, default 50, max 1000	50
x-api-key (header)	string	Yes	API key required

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "nm0000151",
    "name": "Morgan Freeman",
    "types": [
      "event"
    ],
    "limit": 50,
    "url": "https://www.imdb.com/name/nm0000151/mediaindex/",
    "total": 280,
    "has_more": true,
    "images": [
      {
        "id": "rm3215753474",
        "url": "https://m.media-amazon.com/images/M/MV5BMDgxZTdlOWUtOGMwMy00ODcwLTgwOWMtMDNiNTIwMWQ5ZDkyXkEyXkFqcGc@._V1_.jpg",
        "width": 3600,
        "height": 2400,
        "type": "event",
        "caption": "Morgan Freeman at an event",
        "copyright": "2025 Lionsgate",
        "position": 1,
        "names": [
          {
            "id": "nm0000151",
            "name": "Morgan Freeman",
            "url": "https://www.imdb.com/name/nm0000151/"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/imdb.nameImagesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	imdb.NameImagesResponse	No
data.fetched_at	string	No	2026-09-09T14:46:16Z
data.has_more	boolean	No	true
data.id	string	No	nm0000151
data.images	array	No
data.images[].caption	string	No	Elisabeth Wiedemann in Holly - The Movie (1984)
data.images[].copyright	string	No	2013 Getty Images
data.images[].countries	array	No
data.images[].countries[].code	string	No	SE
data.images[].countries[].name	string	No	Sweden
data.images[].created_by	string	No	Stanley Bielecki Movie Collection
data.images[].created_on	string	No	February 16, 2026
data.images[].height	integer	No	3024
data.images[].id	string	No	rm1894298369
data.images[].languages	array	No
data.images[].languages[].code	string	No	SE
data.images[].languages[].name	string	No	Sweden
data.images[].names	array	No
data.images[].names[].id	string	No	nm0000151
data.images[].names[].name	string	No	Morgan Freeman
data.images[].names[].url	string	No	https://www.imdb.com/name/nm0000151/
data.images[].position	integer	No	1
data.images[].source	string	No	gettyimages.com
data.images[].titles	array	No
data.images[].titles[].id	string	No	tt0068646
data.images[].titles[].title	string	No	The Godfather
data.images[].titles[].url	string	No	https://www.imdb.com/title/tt0068646/
data.images[].titles[].year	integer	No	1972
data.images[].type	string	No	still_frame
data.images[].url	string	No	https://m.media-amazon.com/images/M/MV5BZjczNmIzMjEtYmM4MC00ZjQxLTk4NjctMTA2MzEzOWI3NWRhXkEyXkFqcGc@._V1_.jpg
data.images[].width	integer	No	4032
data.limit	integer	No	50
data.name	string	No	Morgan Freeman
data.source_url	string	No	https://www.imdb.com/name/nm0000151/mediaindex/
data.total	integer	No	1262
data.type_counts	array	No
data.type_counts[].label	string	No	Still Frame
data.type_counts[].total	integer	No	381
data.type_counts[].type	string	No	still_frame
data.types	array	No
data.url	string	No	https://www.imdb.com/name/nm0000151/mediaindex/
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/images?type=behind_the_scenes&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 video metadata API documentation

Open in Playground Back to group

Docs menu

IMDb API endpoint

IMDb name images API

GETapiKey2 credits/requestIMDbimdb.nameImagesResponseDoc/imdb/name/images

Endpoint facts

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

IMDb Scraper API Try IMDb name images API in Playground IMDb API documentation

How this endpoint behaves

Returns image metadata from a person's media index, including the original image URL, dimensions, caption, attribution and the people IMDb credits in each image.

Query parameters:

id: IMDb name ID, for example nm0000151.
url: absolute IMDb name URL, for example https://www.imdb.com/name/nm0000151/.
type: image type filter. Accepts a single value or a comma-separated list of behind_the_scenes, event, poster, product, production_art, publicity, still_frame, unknown. Omit it to return every type. Call /api/v1/imdb/image-types for the same list with display labels.
limit: rows to return. Defaults to 50; maximum 1000.

Notable response behavior:

images[].url is the original m.media-amazon.com asset. The endpoint returns metadata only and never proxies or re-hosts the image bytes; those URLs are fetchable directly.
images[].position is the 1-based rank of the row within the filtered result, matching the order IMDb's own gallery uses.
images[].names lists the people IMDb credits in the image, each with an IMDb name ID and profile URL when available.
images[].created_on is the date IMDb added the image.
images[].countries and images[].languages tag region-specific artwork (each with an ISO-style code and a display name). Posters commonly carry them; still frames usually do not.
images[].titles identifies which production each photo came from — IMDb id, title, year and URL. This is usually the field you want when turning a person's media index into per-film images.
data.total is the number of images matching the filter, and data.has_more is true when the response returns fewer than that.
data.type_counts is a per-type breakdown of the whole media index. It is returned only when no type filter is applied, because IMDb's own counts honour the active filter.
An unrecognized type returns an invalid-parameter error rather than an empty list.
A well-formed but unresolvable name ID returns a not-found error, so it is never confused with a person whose media index is genuinely empty.
If IMDb changes its payload, the endpoint returns an upstream parser-drift error rather than an empty or partial success.

Live monitoring

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

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /imdb/name/images?id=nm0000151&limit=40&type=still_frame
Fields returned with a value: 8

Field	In the sample	Value in the sample
id	Has a value
name	Has a value	“Morgan Freeman”
types	Has a value	1 entry
limit	Has a value
url	Has a value	imdb.com
total	Has a value	493
has_more	Has a value	true
images	Has a value	40 entries

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/
type	string	No	Image type filter, single value or comma-separated list Allowed values: behind_the_scenes, event, poster, product, production_art, publicity, still_frame, unknown.	still_frame
limit	integer	No	Rows to return, default 50, max 1000	50
x-api-key (header)	string	Yes	API key required

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "nm0000151",
    "name": "Morgan Freeman",
    "types": [
      "event"
    ],
    "limit": 50,
    "url": "https://www.imdb.com/name/nm0000151/mediaindex/",
    "total": 280,
    "has_more": true,
    "images": [
      {
        "id": "rm3215753474",
        "url": "https://m.media-amazon.com/images/M/MV5BMDgxZTdlOWUtOGMwMy00ODcwLTgwOWMtMDNiNTIwMWQ5ZDkyXkEyXkFqcGc@._V1_.jpg",
        "width": 3600,
        "height": 2400,
        "type": "event",
        "caption": "Morgan Freeman at an event",
        "copyright": "2025 Lionsgate",
        "position": 1,
        "names": [
          {
            "id": "nm0000151",
            "name": "Morgan Freeman",
            "url": "https://www.imdb.com/name/nm0000151/"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/imdb.nameImagesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	imdb.NameImagesResponse	No
data.fetched_at	string	No	2026-09-09T14:46:16Z
data.has_more	boolean	No	true
data.id	string	No	nm0000151
data.images	array	No
data.images[].caption	string	No	Elisabeth Wiedemann in Holly - The Movie (1984)
data.images[].copyright	string	No	2013 Getty Images
data.images[].countries	array	No
data.images[].countries[].code	string	No	SE
data.images[].countries[].name	string	No	Sweden
data.images[].created_by	string	No	Stanley Bielecki Movie Collection
data.images[].created_on	string	No	February 16, 2026
data.images[].height	integer	No	3024
data.images[].id	string	No	rm1894298369
data.images[].languages	array	No
data.images[].languages[].code	string	No	SE
data.images[].languages[].name	string	No	Sweden
data.images[].names	array	No
data.images[].names[].id	string	No	nm0000151
data.images[].names[].name	string	No	Morgan Freeman
data.images[].names[].url	string	No	https://www.imdb.com/name/nm0000151/
data.images[].position	integer	No	1
data.images[].source	string	No	gettyimages.com
data.images[].titles	array	No
data.images[].titles[].id	string	No	tt0068646
data.images[].titles[].title	string	No	The Godfather
data.images[].titles[].url	string	No	https://www.imdb.com/title/tt0068646/
data.images[].titles[].year	integer	No	1972
data.images[].type	string	No	still_frame
data.images[].url	string	No	https://m.media-amazon.com/images/M/MV5BZjczNmIzMjEtYmM4MC00ZjQxLTk4NjctMTA2MzEzOWI3NWRhXkEyXkFqcGc@._V1_.jpg
data.images[].width	integer	No	4032
data.limit	integer	No	50
data.name	string	No	Morgan Freeman
data.source_url	string	No	https://www.imdb.com/name/nm0000151/mediaindex/
data.total	integer	No	1262
data.type_counts	array	No
data.type_counts[].label	string	No	Still Frame
data.type_counts[].total	integer	No	381
data.type_counts[].type	string	No	still_frame
data.types	array	No
data.url	string	No	https://www.imdb.com/name/nm0000151/mediaindex/
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/images?type=behind_the_scenes&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 images 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 images 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