BookMyShow APIin.bookmyshow.com ↗
Access BookMyShow movie listings, showtimes, cast details, and live events across Indian cities via 12 structured API endpoints.
What is the BookMyShow API?
The BookMyShow India API exposes 12 endpoints covering movies currently showing, upcoming releases, live events, and venue showtimes across Indian cities. Use get_now_showing_movies to pull currently playing films with titles, certifications, genres, and poster URLs for any supported city, or get_movie_showtimes to retrieve theater-level showtime schedules filtered by date and venue. Movie detail responses include cast, crew, synopsis, duration, and censor certification.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/c9d4d699-5bca-49af-a878-144ad05b0f5f/get_cities' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve all supported cities and regions with their codes, slugs, coordinates, and sub-regions. Returns both top cities and other cities combined into a single list. Each city includes a RegionCode (used internally) and a RegionSlug (used as the city identifier in other endpoints).
No input parameters required.
{
"type": "object",
"fields": {
"cities": "array of city/region objects with RegionCode, RegionName, RegionSlug, Lat, Long, StateCode, StateName, SubRegions, CountryCode"
},
"sample": {
"data": {
"cities": [
{
"Lat": "19.076",
"Long": "72.8777",
"StateCode": "MH",
"StateName": "Maharashtra",
"RegionCode": "MUMBAI",
"RegionName": "Mumbai",
"RegionSlug": "mumbai",
"SubRegions": [
{
"SubRegionCode": "MWEST",
"SubRegionName": "Mumbai: Western",
"SubRegionSlug": "mumbai-western"
}
],
"CountryCode": "IN"
},
{
"Lat": "12.971599",
"Long": "77.594563",
"StateCode": "KT",
"StateName": "Karnataka",
"RegionCode": "BANG",
"RegionName": "Bengaluru",
"RegionSlug": "bengaluru",
"SubRegions": [],
"CountryCode": "IN"
}
]
},
"status": "success"
}
}About the BookMyShow API
Movie Listings and Details
Three endpoints cover movie discovery by city: get_recommended_movies returns homepage-featured titles with ratings and poster URLs, get_now_showing_movies returns currently playing films paginated up to 5 pages, and get_upcoming_movies returns scheduled releases. All three accept a city parameter using the RegionSlug value from get_cities. The get_movie_details endpoint accepts an event_code (alphanumeric ID starting with ET) and returns a flat structure containing cast, crew, description, duration, event_genre, event_censor, and release_date. Use search_movies to resolve a title string to an event_code before passing it to detail or showtime endpoints — search results are nationwide, not city-scoped.
Showtimes and Venues
get_movie_showtimes accepts event_code or movie_name, an optional date in YYYYMMDD format, and an optional venue_code to narrow results to one theater. The response includes a venues array where each entry carries venue_code, venue_name, address, latitude, longitude, is_multiplex, has_food_sales, ticket_cancellation, and nested show_times. It also returns available_dates so you can page forward to future screenings. For nationwide showtime coverage without committing to a single city, search_showtimes_india covers up to 10 regions per call using either a page parameter or an explicit cities comma-separated list of RegionSlug values, returning regions_covered, regions_failed, and a has_more flag.
Events and Kids Activities
get_events_list returns concerts, comedy shows, workshops, theatre, and sports events for a city, with category, venue, and event_date fields alongside the standard poster and CTA URL fields. get_kids_events follows the same shape but filters to children-focused activities. For a single event's full details, get_event_details returns tags, price, format (offline or online), age_limit, duration, and a venues array with per-venue date_time, address, and coordinates.
City and Venue Discovery
get_cities is the starting point for any city-scoped call. It returns all supported regions with RegionCode, RegionSlug, Lat, Long, StateCode, and SubRegions. get_venue_events accepts a venue_code and optional date to list everything scheduled at a specific cinema or venue, with each result flagged as ongoing or upcoming and including a horizontal landscape poster_url.
The BookMyShow API is a managed, monitored endpoint for in.bookmyshow.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when in.bookmyshow.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official in.bookmyshow.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a movie discovery app showing now-playing and upcoming films with poster images and certifications per Indian city
- Display theater-level showtimes for a specific movie on a chosen date using get_movie_showtimes with venue and date filters
- Find nationwide theater coverage for a new release by paginating search_showtimes_india across all Indian regions
- List all concerts and comedy shows in a city with venue names, start dates, and ticket price text from get_events_list
- Show a cinema's full schedule for a given date including both movies and events using get_venue_events
- Pull cast, crew, synopsis, and certification for any film by resolving a title with search_movies then calling get_movie_details
- Surface kids workshops and children's events in a city with age limits and venue details from get_kids_events and get_event_details
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does BookMyShow provide an official public developer API?+
What does get_movie_showtimes return and how can I filter it?+
venues array where each theater entry includes venue_code, venue_name, address, coordinates, is_multiplex, has_food_sales, ticket_cancellation, and nested show times. You can filter by date (YYYYMMDD), narrow to a single theater with venue_code, and identify the movie using either event_code or movie_name. The response also includes available_dates listing future dates with showtimes.Does search_movies scope results to a specific city?+
search_movies returns nationwide results for the query string, along with event_code, status, language, and poster_url for each match. Once you have an event_code, pass it together with a city slug to get_movie_details or get_movie_showtimes to get city-specific data.Does the API return seat maps or individual seat availability for booking?+
Is there a limitation on how many events or movies a city query returns?+
get_now_showing_movies, get_upcoming_movies, get_events_list, and get_kids_events each paginate internally up to 5 pages and combine results into a single response. The total field in each response reflects the number of records actually returned. For get_recommended_movies, the limit parameter caps results; setting it to 0 returns all available items.