IMDb API: List user reviews (v1)

List a title's user reviews with rating, headline, full text, date, spoiler flag and helpful votes, 25 per page, most helpful first by default. An unknown title returns data: null.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

title_id_or_url*string

The title_id from a search result, or the title's imdb.com link, such as https://www.imdb.com/title/tt0111161/reviews/.

Lengthlength <= 1000

sort?string

helpful (as on imdb.com), newest, oldest, rating_high, rating_low or most_voted.

Default"helpful"

Value in

"helpful"
"newest"
"oldest"
"rating_high"
"rating_low"
"most_voted"

cursor?string

next_cursor from the previous page of the same request. Omit for the first page.

Lengthlength <= 2000

Default""

curl -X GET "https://example.com/v1/imdb/reviews?title_id_or_url=tt0111161" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "title_id": "tt0111161",    "title": "The Shawshank Redemption",    "sort": "helpful",    "total": 12080,    "count": 0,    "has_more": true,    "next_cursor": "string",    "reviews": [      {        "review_id": "rw6606154",        "url": "https://www.imdb.com/review/rw6606154/",        "author": {          "user_id": "ur15311310",          "name": "Sleepin_Dragon"        },        "rating": 10,        "headline": "An incredible movie. One that lives with you.",        "text": "string",        "date": "2021-02-17",        "is_spoiler": true,        "helpful_votes": 670,        "unhelpful_votes": 52      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}