IMDb API endpoint
Returns a bounded slice of a title's public connections: other titles it references or is referenced by, such as remakes, spin-offs, "featured in" clips, and "edited into" compilations. `category` is upstream-supplied free text, not a closed enum. IMDb's connections list can run to hundreds or thousands of rows, so `total` can exceed the returned rows and `has_more` reports that condition. Limit defaults to 50 and clamps to 250. Pass exactly one of `id` or `url`.
/imdb/title/connectionsQuery parameters:
id: IMDb title ID, for example tt0111161.url: absolute IMDb title URL, for example
https://www.imdb.com/title/tt0111161/.limit: rows to return. Defaults to 50; maximum 250.Notable response behavior:
connections[].category is upstream-supplied free text (for example
Featured in, Referenced in, Spoofed in, Edited into), not a closed
enum — there is no filter parameter for it.connections[].note is an optional editorial note IMDb attaches to some
rows; many rows have none.connections[].associated_title.title_type and .year are included when
IMDb supplies them.total is the upstream count and has_more is true
whenever the returned slice is shorter than total.connections list.| Field | Filled in, of 40 checked | Values in the sample |
|---|---|---|
| category | 40 | Featured in in all 40 |
| note | 38 | “Clips appear in the teaser for next week's show.” and 33 other values |
| associated_title | 40 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | No | IMDb title id | tt0111161 | |
| url | string | No | Absolute https://www.imdb.com/title/<id>/ URL | https://www.imdb.com/title/tt0111161/ | |
| limit | integer | No | Rows to return, default 50, max 250 | 50 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/imdb/title/connections?limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "tt0111161",
"title": "The Shawshank Redemption",
"limit": 50,
"url": "https://www.imdb.com/title/tt0111161/",
"total": 999,
"has_more": true,
"connections": [
{
"category": "Featured in",
"note": "Clips appear in the teaser for next week's show.",
"associated_title": {
"id": "tt1936736",
"title": "Why Gump? Why Now?",
"url": "https://www.imdb.com/title/tt1936736/",
"title_type": "TV Episode",
"year": 1994
}
}
]
}
}Request schema
No body schema
Response schema
#/definitions/imdb.titleConnectionsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | imdb.TitleConnectionsResponse | No | ||||
| data.connections | array | No | ||||
| data.connections[].associated_title | imdb.ConnectionAssociatedTitle | No | ||||
| data.connections[].associated_title.id | string | No | tt1936736 | |||
| data.connections[].associated_title.title | string | No | Why Gump? Why Now? | |||
| data.connections[].associated_title.title_type | string | No | TV Episode | |||
| data.connections[].associated_title.url | string | No | https://www.imdb.com/title/tt1936736/ | |||
| data.connections[].associated_title.year | integer | No | 1994 | |||
| data.connections[].category | string | No | Featured in | |||
| data.connections[].note | string | No | Clips appear in the teaser for next week's show. | |||
| data.fetched_at | string | No | 2026-09-17T14:46:16Z | |||
| data.has_more | boolean | No | true | |||
| data.id | string | No | tt0111161 | |||
| data.limit | integer | No | 50 | |||
| data.source_url | string | No | https://www.imdb.com/title/tt0111161/ | |||
| data.title | string | No | The Shawshank Redemption | |||
| data.total | integer | No | 999 | |||
| data.url | string | No | https://www.imdb.com/title/tt0111161/ | |||
| 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/connections?limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"