IMDb API endpoint
Returns public IMDb user review rows. Limit defaults to 10 and clamps to 20. Pass exactly one of `id` or `url`.
/imdb/title/reviewsQuery parameters:
id: IMDb title ID, for example tt1375666.url: absolute IMDb title URL, for example
https://www.imdb.com/title/tt1375666/.limit: rows to return. Defaults to 10; maximum 20.Notable response behavior:
data.reviews contains public review title, author, date, rating, text,
spoiler marker, and helpful-vote counts when present.data.total is the number of reviews IMDb lists for the title, and
data.has_more is true when the response returns fewer than that. IMDb
serves only the most recent reviews on the page, so data.reviews is
commonly much shorter than data.total regardless of limit.| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| id | 10 | |
| title | 10 | |
| url | 10 | imdb.com |
| author | 10 | |
| date | 10 | 1999-03-25 to 2021-02-17 |
| rating | 9 | 10 |
| text | 10 | median 995 characters |
| spoiler | 10 | true in 1 of 10 |
| helpful_votes | 10 | 172 to 1,857, median 971 |
| total_votes | 10 | 194 to 2,145, median 1,154 |
| helpfulness | 10 | |
| public_signals | 10 | 5 to 6, median 6 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | No | IMDb title id | tt1375666 | |
| url | string | No | Absolute https://www.imdb.com/title/<id>/ URL | https://www.imdb.com/title/tt1375666/ | |
| limit | integer | No | Rows to return, default 10, max 20 | 10 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/imdb/title/reviews?limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "tt1375666",
"limit": 10,
"reviews": [
{
"id": "rw2500001",
"title": "A smart blockbuster",
"rating": 9,
"helpful_votes": 123,
"total_votes": 150,
"spoiler": false
}
],
"public_page_derived": true
}
}Request schema
No body schema
Response schema
#/definitions/imdb.reviewsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | imdb.ReviewsResponse | No | ||||
| data.fetched_at | string | No | 2026-06-07T14:46:16Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.has_more | boolean | No | true | `true` when IMDb lists more reviews than were returned. | ||
| data.id | string | No | tt1375666 | IMDb title ID, for example `tt1375666`. | ||
| data.limit | integer | No | 10 | Maximum number of reviews requested. | ||
| data.public_page_derived | boolean | No | true | Always `true`. The data comes from IMDb's public pages. | ||
| data.reviews | array | No | User reviews of the title. | |||
| data.reviews[].author | string | No | movie_fan | Username of the reviewer. | ||
| data.reviews[].date | string | No | 2024-01-02 | Date the review was posted, for example `2024-01-02`. | ||
| data.reviews[].helpful_votes | integer | No | 123 | Number of users who marked the review as helpful. | ||
| data.reviews[].helpfulness | string | No | 82% | Share of votes that marked the review as helpful, as a percentage such as `82%`. | ||
| data.reviews[].id | string | No | rw1234567 | IMDb review ID, for example `rw1234567`. | ||
| data.reviews[].public_signals | integer | No | 5 | Number of details filled in on this review, counted across title, author, date, rating, text and votes. | ||
| data.reviews[].rating | integer | No | 9 | Rating the reviewer gave the title. | ||
| data.reviews[].spoiler | boolean | No | false | `true` when the review is marked as containing spoilers. | ||
| data.reviews[].text | string | No | Full text of the review. | |||
| data.reviews[].title | string | No | A smart blockbuster | Headline the reviewer gave the review. | ||
| data.reviews[].total_votes | integer | No | 150 | Total number of helpful and not helpful votes the review received. | ||
| data.reviews[].url | string | No | https://www.imdb.com/review/rw1234567/ | IMDb page URL of the review. | ||
| data.source_url | string | No | https://www.imdb.com/title/tt1375666/reviews/ | URL the data was read from. | ||
| data.total | integer | No | 11940 | Number of reviews IMDb lists for the title. | ||
| data.url | string | No | https://www.imdb.com/title/tt1375666/reviews/ | IMDb reviews page of the title. | ||
| 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/reviews?limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"