{ "openapi": "3.0.1", "info": { "title": "IMDb Top Charts & Advanced Title Search", "description": "Search IMDb movies and TV shows, fetch titles by IMDb ID, browse Top 250 and regional charts, or run an advanced search by genre, year, rating and vote count, with cast, crew and plot details per title.", "version": "1.2", "x-build-id": "Fbeq026cct90fLKAG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nimbryxo-studio~imdb-top-charts-and-advanced-title-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nimbryxo-studio-imdb-top-charts-and-advanced-title-search", "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/nimbryxo-studio~imdb-top-charts-and-advanced-title-search/runs": { "post": { "operationId": "runs-sync-nimbryxo-studio-imdb-top-charts-and-advanced-title-search", "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/nimbryxo-studio~imdb-top-charts-and-advanced-title-search/run-sync": { "post": { "operationId": "run-sync-nimbryxo-studio-imdb-top-charts-and-advanced-title-search", "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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "topRated", "search", "byId", "popular", "advanced", "reviews", "episodes" ], "type": "string", "description": "What to fetch from IMDb: title search, direct IDs, a chart, the popularity meter, a filtered search, user reviews, or TV episodes.", "default": "topRated" }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Free-text title search, e.g. 'inception' or 'breaking bad'. Used in search mode." }, "imdbIds": { "title": "IMDb Title IDs", "type": "array", "description": "IMDb title IDs (e.g. tt0111161) or title URLs. Used by byId, reviews and episodes modes. In episodes mode, pass TV series IDs.", "default": [], "items": { "type": "string" } }, "reviewSortBy": { "title": "Review Sort Order", "enum": [ "HELPFULNESS_SCORE", "USER_RATING", "SUBMISSION_DATE", "TOTAL_VOTES" ], "type": "string", "description": "How to order reviews in reviews mode.", "default": "HELPFULNESS_SCORE" }, "reviewSortOrder": { "title": "Review Sort Direction", "enum": [ "DESC", "ASC" ], "type": "string", "description": "Ascending or descending order for the review sort.", "default": "DESC" }, "excludeSpoilers": { "title": "Exclude Spoiler Reviews", "type": "boolean", "description": "Skip reviews flagged as containing spoilers.", "default": false }, "titleType": { "title": "Title Type", "enum": [ "", "movie", "tvSeries", "short", "tvMiniSeries", "tvMovie", "tvSpecial", "videoGame", "podcastSeries" ], "type": "string", "description": "Restrict results to one content type. Used in search, popular and advanced modes.", "default": "" }, "genres": { "title": "Genres", "type": "array", "description": "Filter by genres, e.g. Drama, Thriller, Sci-Fi. Multiple genres are combined with AND. Used in search and advanced modes.", "default": [], "items": { "type": "string" } }, "languages": { "title": "Spoken Languages", "type": "array", "description": "Filter by spoken-language codes, e.g. en, fr, hi, ta. Multiple languages are combined with OR. Used in search and advanced modes.", "default": [], "items": { "type": "string" } }, "countries": { "title": "Countries of Origin", "type": "array", "description": "Filter by country-of-origin codes, e.g. US, GB, IN, JP. Multiple countries are combined with OR. Used in search and advanced modes.", "default": [], "items": { "type": "string" } }, "runtimeMin": { "title": "Runtime (min minutes)", "minimum": 1, "maximum": 1440, "type": "integer", "description": "Only include titles at least this many minutes long. Used in search and advanced modes." }, "runtimeMax": { "title": "Runtime (max minutes)", "minimum": 1, "maximum": 1440, "type": "integer", "description": "Only include titles at most this many minutes long. Used in search and advanced modes." }, "yearMin": { "title": "Release Year (min)", "minimum": 1880, "maximum": 2030, "type": "integer", "description": "Include only titles released on or after this year." }, "yearMax": { "title": "Release Year (max)", "minimum": 1880, "maximum": 2030, "type": "integer", "description": "Include only titles released on or before this year." }, "minRating": { "title": "Minimum IMDb Rating", "minimum": 1, "maximum": 10, "type": "number", "description": "Only include titles with at least this IMDb rating (1-10)." }, "minVotes": { "title": "Minimum Vote Count", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Only include titles with at least this many IMDb votes." }, "sortBy": { "title": "Sort By", "enum": [ "RANKING", "USER_RATING", "USER_RATING_COUNT", "RELEASE_DATE", "TITLE_REGIONAL", "METACRITIC_SCORE" ], "type": "string", "description": "Sort field for search and advanced modes.", "default": "RANKING" }, "sortOrder": { "title": "Sort Direction", "enum": [ "DESC", "ASC" ], "type": "string", "description": "Sort direction for search and advanced modes.", "default": "DESC" }, "topRatedChart": { "title": "Chart", "enum": [ "TOP_250", "TOP_250_ENGLISH", "TOP_250_TV", "BOTTOM_100", "TOP_50_BENGALI", "TOP_50_MALAYALAM", "TOP_50_TAMIL", "TOP_50_TELUGU", "TOP_250_INDIA" ], "type": "string", "description": "Which IMDb chart to fetch in topRated mode.", "default": "TOP_250" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of records to return across all requested IDs (1-1000). Each review or episode is one record. Results are paginated, so the upstream 50-reviews-per-request limit does not cap this.", "default": 50 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }