Endpoint Playground

Try the 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`.

What a live request returned

14 Oct 2026: Single record response; 8 fields had a value in every checked item.

Observed request: GET /imdb/name/images?id=nm0000151&limit=40&type=still_frame
Fields with a value in every checked item: id, name, types, limit, url, total, has_more, images

Sample value profiles: total: 493; name: “Morgan Freeman”; url: imdb.com.

Request: GET /imdb/name/images
Cost: 2 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.13 s
Monitored request: GET /imdb/name/images?id=nm0000151&limit=5&type=still_frame

IMDb name images API documentation IMDb platform page Pricing

Prefilled cURL

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

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	string	No		IMDb name id
url	string	No		Absolute https://www.imdb.com/name/<id>/ URL
type	string	No	behind_the_scenes	Image type filter, single value or comma-separated list
limit	integer	No		Rows to return, default 50, max 1000

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/"
          }
        ]
      }
    ]
  }
}

More IMDb endpoints

IMDb title charts IMDb image types IMDb name detail IMDb name awards IMDb name credits IMDb name video metadata IMDb title search IMDb advanced title search IMDb title detail IMDb title awards IMDb title box office summary IMDb title company credits All 30 IMDb endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestimdb.nameImagesResponseDocIMDb

GET /imdb/name/images

IMDb name images

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.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "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/"
          }
        ]
      }
    ]
  }
}

Endpoint Playground

Try the IMDb name images API

What a live request returned

14 Oct 2026: Single record response; 8 fields had a value in every checked item.

Observed request: GET /imdb/name/images?id=nm0000151&limit=40&type=still_frame
Fields with a value in every checked item: id, name, types, limit, url, total, has_more, images

Sample value profiles: total: 493; name: “Morgan Freeman”; url: imdb.com.

Request: GET /imdb/name/images
Cost: 2 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.13 s
Monitored request: GET /imdb/name/images?id=nm0000151&limit=5&type=still_frame

IMDb name images API documentation IMDb platform page Pricing

Prefilled cURL

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

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	string	No		IMDb name id
url	string	No		Absolute https://www.imdb.com/name/<id>/ URL
type	string	No	behind_the_scenes	Image type filter, single value or comma-separated list
limit	integer	No		Rows to return, default 50, max 1000

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/"
          }
        ]
      }
    ]
  }
}

More IMDb endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestimdb.nameImagesResponseDocIMDb

GET /imdb/name/images

IMDb name images

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "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/"
          }
        ]
      }
    ]
  }
}