Skip to main content
POST
/
imdb
/
reviews
cURL
curl --request POST \
  --url https://py-api.hobbo.ai/imdb/reviews \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "<string>",
  "sort_type": "HELPFULNESS_SCORE",
  "reviews_to_fetch": 123,
  "pagination_token": "<string>",
  "is_text_formatted": true,
  "sync_date": "<string>"
}'
{
  "all_reviews": [],
  "extra_information": {},
  "message": "<string>"
}

Body

application/json

IMDB review scraping parameters

​
query
string
required

Provide a proper IMDB URL or provide movie id

​
sort_type
enum<string>
default:HELPFULNESS_SCORE

Order in which reviews should be sorted

Available options:
HELPFULNESS_SCORE,
SUBMISSION_DATE,
TOTAL_VOTES,
SUBMITTER_REVIEW_COUNT,
USER_RATING
​
reviews_to_fetch
number

Number of reviews to fetch (default: all reviews, or within 30-second timeout)

​
pagination_token
string

The next key is for the next request for partial data fetching

​
is_text_formatted
boolean

returns the review text with visual formatting preserved

​
sync_date
string

Fetches reviews posted on a specific date using format: YYYY-MM-DD

Response

Reviews fetched successfully

​
all_reviews
object[]

Array of fetched reviews

​
extra_information
object
​
message
string

Status message about the review extraction