IMDb API endpoint
Lists every value the `type` parameter of the IMDb image endpoints accepts: `behind_the_scenes`, `event`, `poster`, `product`, `production_art`, `publicity`, `still_frame`, `unknown`. Each row carries a display label and a short description.
/imdb/image-typesLists every value the type parameter of /api/v1/imdb/title/images and
/api/v1/imdb/name/images accepts, with IMDb's own display label and a short
description.
Query parameters: none.
Accepted type values: behind_the_scenes, event, poster, product,
production_art, publicity, still_frame, unknown.
Notable response behavior:
data.types[].type is the value to pass as type on the image endpoints.data.types[].label is IMDb's own display label for that type. Note that
unknown is shown as Other on IMDb.data.total is the number of accepted values.| Field | Filled in, of 8 checked | Values in the sample |
|---|---|---|
| type | 8 | “behind_the_scenes” and 7 other values |
| label | 8 | “Behind The Scenes” and 7 other values |
| description | 8 | “On-set and production photography.” and 7 other values |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/imdb/image-types" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"total": 8,
"types": [
{
"type": "behind_the_scenes",
"label": "Behind The Scenes",
"description": "On-set and production photography."
},
{
"type": "still_frame",
"label": "Still Frame",
"description": "A frame captured from the production itself."
}
]
}
}Request schema
No body schema
Response schema
#/definitions/imdb.imageTypesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | imdb.ImageTypesResponse | No | ||||
| data.fetched_at | string | No | 2026-09-09T14:46:16Z | |||
| data.total | integer | No | 8 | |||
| data.types | array | No | ||||
| data.types[].description | string | No | A frame captured from the production itself. | |||
| data.types[].label | string | No | Still Frame | |||
| data.types[].type | string | No | still_frame | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/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/image-types" \
-H "x-api-key: $CRAWLORA_API_KEY"