{ "openapi": "3.0.1", "info": { "title": "BookMyShow Scraper: Movies, Showtimes and Concerts", "description": "Get movie and event listings from BookMyShow across major Indian cities, with cast, director, synopsis, and runtime for movies, or venue, date, time, and starting price for concerts, plays, and sports matches nationwide. Built for entertainment-listing aggregators and local-event trackers.", "version": "0.2", "x-build-id": "9lnE5VfKZwKzaVw06" }, "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": { "scrapeMode": { "title": "Scrape Mode", "enum": [ "movies", "events" ], "type": "string", "description": "Choose public movie listings or public live-event listings for the selected city.", "default": "movies" }, "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 for the public listing source.", "default": "mumbai" }, "filterByLanguage": { "title": "Movie Language", "type": "string", "description": "Movies only. Include listings whose published language contains this value, case-insensitively. Leave empty for all movie languages; event runs reject this unsupported filter.", "default": "" }, "filterByCertification": { "title": "Movie Certification", "enum": [ "", "U", "UA", "UA16+", "A", "A16+", "S", "S16+", "U16+" ], "type": "string", "description": "Movies only. Include listings with this published BookMyShow certificate. Leave empty for all; event runs reject this unsupported filter.", "default": "" }, "minRating": { "title": "Minimum Rating", "minimum": 0, "maximum": 10, "type": "number", "description": "Include listings with a published BookMyShow user rating at or above this value. Set 0 to disable.", "default": 0 }, "onlyWithRating": { "title": "Only Rated Listings", "type": "boolean", "description": "Skip listings without a published user rating.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "An Indian residential proxy is required for reliable access to public BookMyShow pages. The secure default uses Apify Residential proxies in India.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IN" } }, "includeDetails": { "title": "Enrich With Detail Pages", "type": "boolean", "description": "Off by default for a fast listing dataset. Enable to visit each returned page and add only publicly published details. A failed detail page still returns its verified listing row.", "default": false }, "maxItems": { "title": "Max Results", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum emitted rows, never candidate cards or requests. Detail enrichment is bounded to these returned listings.", "default": 8 } } }, "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 } } } } } } } } } }