{ "openapi": "3.0.1", "info": { "title": "IMDb Scraper — Movies, TV Shows, Ratings, Cast & Reviews", "description": "Scrape IMDb for comprehensive movie and TV show data at scale. Extract titles, IMDb ratings, vote counts, genres, directors, full cast lists, runtime, plot summaries, poster images, budget, box office gross, awards, content ratings (PG-13, R, etc.), release dates, languages, countries, production co", "version": "1.0", "x-build-id": "iXY6LSNIKeNnIeei9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sovereigntaylor~imdb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sovereigntaylor-imdb-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sovereigntaylor~imdb-scraper/runs": { "post": { "operationId": "runs-sync-sovereigntaylor-imdb-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sovereigntaylor~imdb-scraper/run-sync": { "post": { "operationId": "run-sync-sovereigntaylor-imdb-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "searchQuery" ], "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "The keyword or phrase to search on IMDb. Examples: 'The Dark Knight', 'Breaking Bad', 'Christopher Nolan', 'sci-fi 2024'. You can search for movie titles, TV show names, actor names, director names, or genre keywords.", "default": "The Dark Knight" }, "type": { "title": "Content Type", "enum": [ "movie", "tv", "all" ], "type": "string", "description": "Filter search results by content type. 'movie' returns only feature films and short films. 'tv' returns TV series, miniseries, and TV movies. 'all' returns everything including movies, TV shows, and people.", "default": "all" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of titles/results to scrape. IMDb shows ~20 results per search page. Set lower for quick runs (10-50) or higher for comprehensive datasets (100-500). Each result navigates to the detail page for full data extraction.", "default": 10 }, "includeReviews": { "title": "Include User Reviews", "type": "boolean", "description": "When enabled, the scraper will also visit the user reviews page for each title and extract up to 25 reviews with ratings, dates, and helpfulness votes. This increases run time but provides valuable sentiment data.", "default": false }, "sortBy": { "title": "Sort Results By", "enum": [ "relevance", "rating", "popularity", "newest", "votes" ], "type": "string", "description": "How to sort the search results. Only applies to advanced search mode. 'relevance' uses IMDb's default ranking. 'rating' sorts by IMDb user rating (highest first). 'popularity' sorts by IMDb popularity rank (most popular first). 'newest' sorts by release date (newest first). 'votes' sorts by number of votes (most voted first).", "default": "relevance" }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum number of concurrent page requests. IMDb is relatively lenient but higher values may trigger rate limiting. Recommended: 3-5 with proxies, 1-2 without.", "default": 3 }, "maxRetries": { "title": "Max Retries Per Page", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many times to retry a failed page request before giving up. IMDb occasionally returns 503 errors under load — retries with delays help recover.", "default": 5 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Recommended for large-scale scraping. IMDb may rate-limit or block datacenter IPs after many requests. Apify residential proxies provide the most reliable results for 100+ titles.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }