Get Supported Cities & Regions

Returns all supported regions and major popular cities across India on BookMyShow (Mumbai, Delhi-NCR, Bengaluru, Hyderabad, Chennai, Pune, Kolkata, etc.) with region codes and URL slugs.

Args: popular_only: If True, returns only major popular tier-1 metropolitan cities.

Get Active Movie Listings in a City

Retrieves clean, structured movie listings currently showing or coming soon in a selected city, with optional filtering by audio language (Hindi, English, Tamil, Telugu, Kannada) and genre (Action, Comedy, Drama, Thriller).

Args: city: City slug (e.g. 'mumbai', 'bengaluru', 'national-capital-region-ncr', 'hyderabad', 'chennai'). language: Filter by language (e.g. 'Hindi', 'English', 'Tamil', 'Telugu'). genre: Filter by genre (e.g. 'Action', 'Drama', 'Comedy', 'Thriller').

Get Live Events & Shows in a City

Retrieves active live events, comedy standup shows, music concerts, sports matches, exhibitions, and workshops in a target city with venue names, event dates, and category tags.

Args: city: City slug (e.g. 'mumbai', 'bengaluru', 'delhi'). category: Event category filter ('events', 'comedy-shows', 'music-shows', 'sports').

Get Movie Synopsis & Metadata

Retrieves comprehensive movie metadata including full plot synopsis, duration, censor certification, ratings, audio languages, high-res poster and banner background URLs, cast and crew profiles, and official video trailer links.

Args: movie_code: BookMyShow movie event code (e.g. 'ET00378770') or full movie page URL. city: City slug (default 'mumbai').

Get Cinema Venues & Showtimes

Retrieves all cinema halls/theaters showing a specific movie in a city, including showtimes, screen formats (2D, 3D, IMAX 3D, 4DX, ICE), ticket price ranges in INR, mobile ticket entry support (is_m_ticket), and seat availability status.

Args: movie_code: Movie event code (e.g. 'ET00378770') or full BookMyShow buy tickets URL. city: City slug (e.g. 'mumbai', 'chennai', 'bengaluru'). date: Show date in YYYYMMDD format (e.g. '20260826') or YYYY-MM-DD. Defaults to current date. language: Language filter or 'all' to aggregate all languages (e.g. 'tamil', 'hindi', 'kannada', 'telugu', 'all'). format: Screen format filter (e.g. '2D', '3D', 'IMAX', '4DX', 'EPIQ', 'ICE').

Search Movies & Live Events

Performs a cross-search across active movie titles and live event listings in a selected city matching a query search term.

Args: query: Search query keyword (e.g. 'Toxic', 'Standup Comedy'). city: City slug (e.g. 'mumbai', 'bengaluru').

Get Cinema Venue Location & Geo Coordinates

Retrieves detailed cinema hall/theater metadata including full street address, landmark, postal code, exact latitude and longitude coordinates, and available venue facilities/amenities (Parking, F&B, M-Ticket, Ticket Cancellation, Food Court).

Args: venue_code: BookMyShow venue code (e.g. 'PCAN', 'CSWO') or full venue URL. city: City slug (e.g. 'chennai', 'mumbai').