{ "openapi": "3.0.1", "info": { "title": "BookMyShow Scraper: Movies, Showtimes & Concerts", "description": "Extracts detailed movies, showtimes, live events, sports matches, plays, prices, certifications, languages, user ratings, and theater seating availability from BookMyShow.com. Supports all major Indian cities.", "version": "0.2", "x-build-id": "pbsAH8Pcd2ly6Cu9k" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~bookmyshow-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-bookmyshow-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/getascraper~bookmyshow-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-bookmyshow-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/getascraper~bookmyshow-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-bookmyshow-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": { "city": { "title": "Target City", "enum": [ "mumbai", "bengaluru", "national-capital-region-ncr", "pune", "hyderabad", "chennai", "kolkata", "ahmedabad", "chandigarh" ], "type": "string", "description": "Select the target Indian city to scrape listings from.", "default": "mumbai" }, "scrapeMode": { "title": "Scrape Mode", "enum": [ "movies", "events" ], "type": "string", "description": "Select whether to extract movies/cinema showtimes, live events/concerts, or custom Start URLs.", "default": "movies" }, "filterByLanguage": { "title": "Filter by Language", "type": "string", "description": "Only include listings in this language (case-insensitive partial match). Examples: 'hindi', 'english', 'tamil'. Leave empty for all.", "default": "" }, "filterByCertification": { "title": "Filter by Certification", "enum": [ "", "U", "A", "UA", "UA16+", "A16+", "S" ], "type": "string", "description": "Only include movies with this exact certification. Leave empty for all.", "default": "" }, "minRating": { "title": "Minimum Rating", "minimum": 0, "maximum": 10, "type": "number", "description": "Only include listings with a BookMyShow user rating at or above this value (1 to 10). Set to 0 to disable.", "default": 0 }, "onlyWithRating": { "title": "Only Rated Listings", "type": "boolean", "description": "Skip listings that have no user rating yet (new releases, upcoming shows). Useful for data quality.", "default": false }, "includeDetails": { "title": "Fetch detail pages", "type": "boolean", "description": "When enabled (default), visits each movie or event's own page to add cast, director, synopsis and runtime (movies) or venue, date, time and starting price (events) on top of the title, rating and language already available from the listing page. Roughly doubles request count. Disable for a faster, lighter run when you only need the listing summary.", "default": true }, "maxItems": { "title": "Max Results", "minimum": 1, "type": "integer", "description": "The maximum number of listing items or showtimes to save. Kept modest by default since each detail page takes real time to render; raise it for larger runs.", "default": 8 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Indian rotating residential proxies are highly recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IN" } } } }, "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 } } } } } } } } } }