IMDb Scraper API

レスポンスに関する注記

- `data.results` contains normalized title rows with IMDb title IDs and public title URLs. - Empty parsed results are treated as parser drift unless IMDb returns an explicit no-results marker. - IMDb WAF or robot-verification pages return an upstream error. Example response: ```json { "code": 200, "msg": "OK", "data": { "query": "inception", "limit": 10, "results": [ { "id": "tt1375666", "title": "Inception", "url": "https://www.imdb.com/title/tt1375666/", "year": "2010" } ] } } ```

レスポンスに関する注記

- `data.public_page_derived` is `true`. - Rating, popularity, cast, and director fields are included only when present on the public page. - IMDb WAF or robot-verification pages return an upstream error. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "tt1375666", "title": "Inception", "year": "2010", "runtime_minutes": 148, "genres": ["Action", "Adventure", "Sci-Fi"], "rating_value": 8.8, "public_page_derived": true } } ```

レスポンスに関する注記

- `data.sections` contains named public credit sections such as cast, directed by, and writing credits when present on IMDb. - Each credit row includes a normalized person name, optional IMDb name URL, role, and character. `role` carries the crew job; `character` is set on cast rows only. - `sections[].total` is the number of credits IMDb lists for that section, and `sections[].has_more` is `true` when the section returns fewer than that. IMDb serves cast in full but caps most crew sections, so a large crew section can return a subset. - IMDb WAF or robot-verification pages return an upstream error. - If IMDb changes its page payload, the endpoint returns an upstream parser-drift error rather than an empty or partial success. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "tt1375666", "sections": [ { "name": "Cast", "slug": "cast", "credits": [ { "name": "Leonardo DiCaprio", "url": "https://www.imdb.com/name/nm0000138/", "character": "Dom Cobb" } ] } ], "public_page_derived": true } } ```

レスポンスに関する注記

- `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`. - Empty parsed review rows are treated as parser drift. - IMDb sometimes serves a sign-in card in place of the review list, with no review data in the response at all. That case returns a distinct upstream error naming the sign-in wall rather than a parser-drift error, because no credential-free extraction is possible when the data is simply absent. - IMDb WAF or robot-verification pages return an upstream error. - If IMDb changes its page payload, the endpoint returns an upstream parser-drift error rather than an empty or partial success. Example response: ```json { "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 } } ```

レスポンスに関する注記

- `data.episodes` contains public episode IDs, titles, season/episode numbers, air dates, ratings, vote counts, and plot snippets when IMDb exposes them. - `data.total` is the number of episodes IMDb lists for the requested season, and `data.has_more` is `true` when the response returns fewer than that. - Unaired or unrated episodes omit `air_date`, `rating_value`, and `rating_count`. - Empty episode pages are treated as upstream parser drift unless IMDb states an explicit zero count for the season. - IMDb WAF or robot-verification pages return an upstream error. - If IMDb changes its page payload, the endpoint returns an upstream parser-drift error rather than an empty or partial success. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "tt0944947", "season": 1, "limit": 10, "episodes": [ { "id": "tt1480055", "title": "Winter Is Coming", "url": "https://www.imdb.com/title/tt1480055/", "season": 1, "episode": 1, "air_date": "17 Apr 2011", "rating_value": 8.9, "rating_count": 52000 } ], "public_page_derived": true } } ```

レスポンスに関する注記

- `data.awards` contains public award rows with event, year, category, result, award name, recipients, related titles, notes, and signal counts when present. - Award `result` is normalized to `win` or `nomination` when IMDb exposes a clear winner/nominee marker. - `awards[].result` is `win` or `nomination`. - `data.total` is the number of awards IMDb lists, and `data.has_more` is `true` when the response returns fewer than that: IMDb server-renders at most a few rows per awards event. - If IMDb changes its page payload, the endpoint returns an upstream parser-drift error rather than an empty or partial success. - IMDb WAF or robot-verification pages return an upstream error. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "tt1375666", "awards": [ { "event": "Academy Awards, USA", "year": "2011", "category": "Best Achievement in Cinematography", "result": "win", "award": "Oscar", "recipients": [{"name": "Wally Pfister"}], "public_signals": 6 } ], "public_page_derived": true } } ```