{ "openapi": "3.0.1", "info": { "title": "IMDb Scraper", "description": "[💰 $5.0 / 1K] Extract movie & TV data from IMDb — ratings, vote counts, cast, directors, genres, runtime, certificates, plot, and release year. Search by title, paste IMDb URLs, or browse the catalog by genre, year, and rating. Optional user reviews per title.", "version": "1.0", "x-build-id": "Odc608Ux57srXS2a4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~imdb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-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/solidcode~imdb-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-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/solidcode~imdb-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-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", "properties": { "searchTerms": { "title": "Search Terms", "type": "array", "description": "Movie or TV show names to search for on IMDb, such as 'The Godfather' or 'Breaking Bad'. Each term returns its matching titles. Leave empty if using title URLs or advanced filters.", "items": { "type": "string" } }, "startUrls": { "title": "IMDb Title URLs", "type": "array", "description": "Paste IMDb title URLs (e.g. https://www.imdb.com/title/tt0068646/) to pull full details for specific movies or shows. Also accepts bare IMDb IDs like 'tt0068646'.", "items": { "type": "string" } }, "useAdvancedFilters": { "title": "Use Advanced Filters", "type": "boolean", "description": "Browse IMDb's advanced title catalog using the filters below (type, genre, year, rating) instead of (or in addition to) search terms. Turn this on to run a filtered catalog search.", "default": false }, "titleType": { "title": "Title Type", "enum": [ "feature", "tv_series", "tv_movie", "tv_episode", "tv_miniseries", "tv_special", "short", "video_game", "any" ], "type": "string", "description": "Limit advanced-filter results to a single kind of title. Only used when 'Use Advanced Filters' is enabled.", "default": "feature" }, "genres": { "title": "Genres", "uniqueItems": true, "type": "array", "description": "Only include titles in these genres. Leave empty for all genres. Used only with advanced filters.", "items": { "type": "string", "enum": [ "action", "adventure", "animation", "biography", "comedy", "crime", "documentary", "drama", "family", "fantasy", "film_noir", "history", "horror", "music", "musical", "mystery", "romance", "sci_fi", "sport", "thriller", "war", "western" ], "enumTitles": [ "Action", "Adventure", "Animation", "Biography", "Comedy", "Crime", "Documentary", "Drama", "Family", "Fantasy", "Film-Noir", "History", "Horror", "Music", "Musical", "Mystery", "Romance", "Sci-Fi", "Sport", "Thriller", "War", "Western" ] }, "default": [] }, "releaseYearMin": { "title": "Release Year From", "minimum": 1870, "maximum": 2030, "type": "integer", "description": "Only include titles released in or after this year. Leave empty for no lower bound." }, "releaseYearMax": { "title": "Release Year To", "minimum": 1870, "maximum": 2030, "type": "integer", "description": "Only include titles released in or before this year. Leave empty for no upper bound." }, "ratingMin": { "title": "Minimum IMDb Rating", "minimum": 0, "maximum": 10, "type": "integer", "description": "Only include titles with an IMDb rating at or above this value (0–10). Leave empty for no rating filter." }, "sortBy": { "title": "Sort Results By", "enum": [ "popularity", "rating", "votes", "release_date", "alpha" ], "type": "string", "description": "Order in which advanced-filter results are collected.", "default": "popularity" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of titles to return per search term or filter set. Set to 0 for as many as available. Each title returned is charged separately.", "default": 50 }, "maxReviewsPerTitle": { "title": "User Reviews Per Title", "minimum": 0, "maximum": 500, "type": "integer", "description": "Also collect up to this many user reviews for each title (capped at 500 per title). Set to 0 to skip reviews (default). Popular titles can have thousands of reviews — keep this low (e.g. 10–50) to control cost, as each review is charged as a result.", "default": 0 }, "language": { "title": "Language", "enum": [ "en", "es", "fr", "de", "it", "pt", "hi", "ja", "ko", "zh" ], "type": "string", "description": "Preferred language for IMDb titles and text where available.", "default": "en" } } }, "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 } } } } } } } } } }