# BookMyShow Scraper - Movies, Events & Showtimes (`abotapi/bookmyshow-scraper`) Actor

Scrape BookMyShow movies and live events by city, category or URL. Extract genres, languages, posters, synopsis, cast, show dates and cinema showtimes. Includes incremental monitoring, resume support and MCP export.

- **URL**: https://apify.com/abotapi/bookmyshow-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 movie, event or showtime records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## BookMyShow Scraper

Scrapes [BookMyShow India](https://in.bookmyshow.com): movies, live events
(concerts, comedy, workshops, plays, sports, activities) and per-cinema
showtimes.

### What you get

| Record kind | Fields (highlights) |
|---|---|
| `movie` | title, code, link, poster, languages, genres, censor, release date, duration, formats, synopsis, cast, director, listing section |
| `event` | title, code, link, poster, venue, category, date, time, price display, availability, synopsis |
| `showtime` | movie code, cinema name, date, time, session id, availability status, facility labels |

Every record carries `kind` and `recordId`. Incremental mode adds
`changeType`, `changedFields`, `firstSeenAt`, `lastSeenAt`.

### Modes

- **Search** (default): walk one city x category listing. Cities use the
  site's own slugs; the top ten are `mumbai`,
  `national-capital-region-ncr`, `bengaluru`, `hyderabad`, `chandigarh`,
  `ahmedabad`, `pune`, `chennai`, `kolkata`, `kochi`. Any other city slug
  from the site works.
- **URL**: paste movie pages (`/movies/...`), live-show pages
  (`/events/...`), per-day showtimes pages (`buytickets` links, one
  record per showing) or city explore links (`/explore/...`), which are
  walked like search mode.

Movie filters (`languages`, `genres`, `formats`) use the site's own codes
and narrow server-side. Unknown codes are dropped rather than silently
ignored. The other categories ignore these filters.

### Details and reviews

**Fetch details** (default on) reads each listing row's own page and merges
the richer fields: synopsis, duration, censor, release date, formats, cast,
director, and for live shows the date, time, venue, price display and
availability. Each returned row whose detail page was read adds a small
**detail surcharge**; rows whose detail page was refused are pushed with the
listing fields and never charged. Turn it off for faster listing-shape rows.

User reviews and booking are account-gated on the site and are not part of
this actor.

### Limits, resume and recurring updates

`maxItems` stops a run early (0 = no limit). The listing surface arrives in
one server-rendered page, so there is exactly one page per scope.

- **Resume**: paste a previous run ID or dataset ID to continue a large pull
  without returning records already collected there.
- **Incremental mode**: for scheduled monitoring. The first run returns
  every record as NEW; later runs return only NEW, UPDATED and REAPPEARED.
  The poster image URL (it embeds a live
  like-count and churns hourly) and the listing widget a card was served
  under are excluded from change detection, so neither churn alone is ever
  an UPDATED row. `emitUnchanged` and `emitExpired` return (and bill) extra rows.

### Send results into your apps (MCP connectors)

Add a connector ID under `mcpConnectors` (authorize it under Apify,
Settings, API & Integrations). Notion gets a rich page-per-item export when
you also set `notionParentPageUrl`; other connectors get a best-effort
write. `maxNotifyListings` caps the export per run. The dataset output never
changes.

### Connection

The default proxy is Apify RESIDENTIAL country-IN, applied to every run
(Console, API, CLI or schedule) unless you override it: that is the lane the
site serves reliably. The groupless datacenter pool is refused on roughly
half its exits. You can bring your own proxy via `proxyConfiguration`.

### Output

Dataset fields are listed on the Output tab. Movies, events and showtimes
share one dataset, discriminated by `kind`; dataset views for movies,
events and showtimes are preconfigured.

### 🔗 Want more sports data?

Pair this actor with these related scrapers from the same team:

<table>
<tr><td>⚽ <a href="https://apify.com/abotapi/hotstar-com-scraper"><b>JioHotstar Scraper</b></a><br>Scrape the JioHotstar catalog by content type or URL. Extract shows, movies, episodes...</td><td>⚽ <a href="https://apify.com/abotapi/eventim-de-event-scraper"><b>Eventim Scraper</b></a><br>Scrape CTS Eventim Germany and EU event catalogue: concerts, festivals, comedy, sports...</td></tr>
<tr><td>⚽ <a href="https://apify.com/abotapi/whatnot-scraper"><b>Whatnot Scraper</b></a><br>Scrape Whatnot live and upcoming shows, queued items and lots, and seller profiles...</td><td>⚽ <a href="https://apify.com/abotapi/onefootball-com-scraper"><b>OneFootball Scraper</b></a><br>Scrape public OneFootball data including football news, upcoming fixtures, match results...</td></tr>
<tr><td>⚽ <a href="https://apify.com/abotapi/globo-ge"><b>Globo Esporte Scraper</b></a><br>Scrape public sports content from ge.globo.com, including news, videos, matches and feed...</td><td>⚽ <a href="https://apify.com/abotapi/sportsbook-odds-scraper"><b>Sportsbook Odds Scraper (1xBet, Melbet, Linebet, Paripulse)</b></a><br>Collect live and prematch betting odds from 1xBet, Melbet, Linebet and Paripulse. Give it...</td></tr>
</table>

👉 [Browse all abotapi scrapers](https://apify.com/abotapi)

### 💬 Support & custom scrapers

- 🐞 **Found a bug or a missing field?** Open a ticket on the [Issues tab](https://apify.com/abotapi/bookmyshow-scraper/issues/open). We usually reply within hours.
- 🛠️ **Need another site, extra fields or a private build?** Email <abotapi@proton.me> or message [Telegram @abotapi](https://t.me/abotapi).
- ⭐ **Enjoying it?** A quick review on the actor page helps other users find it.

# Actor input Schema

## `mode` (type: `string`):

Search walks a city and category listing (movies, events, plays, sports, activities). URL mode reads the exact BookMyShow pages you paste.

## `city` (type: `string`):

Search mode: the city slug, for example mumbai, national-capital-region-ncr, bengaluru, hyderabad, chandigarh, ahmedabad, pune, chennai, kolkata, kochi (the top ten on the site). Any other city slug from the site works too.

## `category` (type: `string`):

Search mode: which listing to walk in the city.

## `languages` (type: `string`):

Movies only: comma-separated language codes, for example hindi, english, tamil, telugu, malayalam, marathi, gujarati, punjabi, kannada, assamese, korean. Unknown codes are dropped rather than silently ignored.

## `genres` (type: `string`):

Movies only: comma-separated genre codes, for example action, drama, comedy, thriller, romantic, horror, sci-fi, animation, biography. Unknown codes are dropped rather than silently ignored.

## `formats` (type: `string`):

Movies only: comma-separated format codes, for example 2d, 3d, 4dx, imax-2d, 4dx-3d, epiq, mx4d, ice-3d. Unknown codes are dropped rather than silently ignored.

## `urls` (type: `array`):

URL mode: BookMyShow pages to read, one per line. Movie pages (/movies/...) and live-show pages (/events/...) are one record each; per-day showtimes pages (buytickets links) are one record per showing; city explore links (/explore/...) are walked like search mode. Multi-value supported.

## `maxItems` (type: `integer`):

Stop after this many records (0 = no limit; the run then stops when the results run out).

## `maxPages` (type: `integer`):

Upper bound on pages walked per scope. This listing surface arrives in one server-rendered page, so the walk reads exactly that page; the bound exists for consistency and defaults wide open.

## `fetchDetails` (type: `boolean`):

Read each listing row's own page and merge the richer fields: synopsis, duration, censor, release date, formats, cast, director, and for live shows the date, time, venue details, price display and availability. Adds one detail read per returned row (a per-row surcharge applies); rows whose detail page is refused are pushed without the extra fields and never charged. Turn off to return the faster listing-shape rows only.

## `resumeFromRunId` (type: `string`):

Paste a previous run ID or dataset ID to continue a large pull without returning records already collected there.

## `incrementalMode` (type: `boolean`):

Turn this on for daily or recurring monitoring. The first run returns every matching record as NEW. Later runs normally return only NEW, UPDATED and REAPPEARED records. The poster image URL is excluded from change detection (it embeds a live like-count), so a poster churn alone is not an UPDATED row. Turn on Emit unchanged or Emit expired only when you also want those rows returned (and billed).

## `stateKey` (type: `string`):

Optional. Name this monitoring campaign to keep its state stable, or deliberately share state across differently configured runs. Leave empty to let the actor derive a key automatically from the search and link settings.

## `emitUnchanged` (type: `boolean`):

Off by default. Turn on to also return records that have not changed since the last run, marked UNCHANGED. This returns, and bills, extra rows you already have.

## `emitExpired` (type: `boolean`):

Off by default. Turn on to also return records that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned the tracked search.

## `mcpConnectors` (type: `array`):

Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a rich page-per-item export; other connectors get a best-effort write or digest. Leave empty to skip; never changes the dataset output.

## `notionParentPageUrl` (type: `string`):

URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors.

## `maxNotifyListings` (type: `integer`):

Cap on items written to each connector per run. Does not affect the dataset.

## `proxyConfiguration` (type: `object`):

Apify Proxy settings. By default every run (Console, API or schedule) uses residential India exits: the lane the site reliably serves (measured). The groupless datacenter pool is refused on roughly half its exits.

## Actor input object example

```json
{
  "mode": "search",
  "city": "mumbai",
  "category": "movies",
  "urls": [
    "https://in.bookmyshow.com/explore/movies-mumbai"
  ],
  "maxItems": 20,
  "maxPages": 0,
  "fetchDetails": true,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "maxNotifyListings": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "IN"
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "city": "mumbai",
    "category": "movies",
    "urls": [
        "https://in.bookmyshow.com/explore/movies-mumbai"
    ],
    "maxItems": 20,
    "maxPages": 0,
    "fetchDetails": true,
    "incrementalMode": false,
    "emitUnchanged": false,
    "emitExpired": false,
    "maxNotifyListings": 50,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "IN"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/bookmyshow-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "city": "mumbai",
    "category": "movies",
    "urls": ["https://in.bookmyshow.com/explore/movies-mumbai"],
    "maxItems": 20,
    "maxPages": 0,
    "fetchDetails": True,
    "incrementalMode": False,
    "emitUnchanged": False,
    "emitExpired": False,
    "maxNotifyListings": 50,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "IN",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/bookmyshow-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "city": "mumbai",
  "category": "movies",
  "urls": [
    "https://in.bookmyshow.com/explore/movies-mumbai"
  ],
  "maxItems": 20,
  "maxPages": 0,
  "fetchDetails": true,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "maxNotifyListings": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "IN"
  }
}' |
apify call abotapi/bookmyshow-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/bookmyshow-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/RcctTn0tH6RKbiTbp/builds/bioYaV0VN2Zsp6jKM/openapi.json