← Back to all apps

Boxoffice

Entertainmentby The Boxoffice Company
Open in ChatGPTWebsite
Launched Feb 23, 2026 on ChatGPT

Boxoffice is the best way to find movie showtimes and local theaters around you. Save time by eliminating the need for manual filters, simply ask for what you want to watch and where you want to see it.

  • Instant Lookups: Get screening times for specific movies or theaters immediately.
  • Smart Filtering: Find films by genre (e.g., ""horror"") or premium formats (e.g., ""IMAX"").
  • Local Discovery: Locate theaters 'near you', in specific cities or neighborhoods.
  • Flexible Planning: Search for movies playing tonight, tomorrow, or on a specific day.
  • Clickable Ticketing Links: Choose your showtime and be directed to the ticketing journey with one click
4ChatGPT Tools
The Boxoffice CompanyDeveloper
EntertainmentCategory

Available Tools

Get Area Programming

get_area_programming
Full Description

Find movies playing near a location, optionally filtered by genre. Use this for queries like 'what's playing in Los Angeles', 'horror movies near me', 'comedy films in New York', or 'movies around [location]'. When a genre is specified, returns only movies of that genre. When no genre is specified, returns all movies playing near the location. When users ask for IMAX/PLF/Atmos/etc, use the exact attribute tag values from the attributes input description. Use attributesOperator="and" when user requires multiple formats simultaneously. IMPORTANT: When users mention location names like 'Los Angeles', 'New York', 'around Los Angeles', or 'near New York', you MUST geocode these locations to latitude and longitude coordinates and provide them in the latitude and longitude fields. Geocoding provides more accurate results than city name searches. Even if the radius input is in kilometers, you MUST use miles in your messages if the user is a country with miles as the unit of distance. CRITICAL: When returning results, DO NOT list movies, theaters, or showtimes in your text response. The widget HTML displays all results visually. Your response may only contain tips to refine the query. CRITICAL: Your response must not contain internal IDs like movie IDs or theater IDs. CRITICAL: Your response must not mention the 3am cinema day boundary.

Parameters (0 required, 8 optional)
Optional
attributesarray

Filter showtimes by specific attributes. Use this when users request formats (IMAX, 3D, Dolby Atmos, PLF), accessibility features (closed captions, audio description, wheelchair accessible), language/subtitle options (original version, dubbed, subtitled), or other showtime features. Provide an array of attribute tag strings (use the tag from the left side, NOT the label from the right side). Complete attribute catalog (tag=label): Auditorium.Comfort.BeanBag=Bean Bag Seating|Auditorium.Comfort.Couch=Couch Seating|Auditorium.Comfort.ElectricReclinerSeats=Electric recliners|Auditorium.Comfort.HeatedRecliners=Heated Recliners|Auditorium.Comfort.HeatedRockers=Heated Rockers|Auditorium.Comfort.HeatedSeats=Heated Seats|Auditorium.Comfort.Loveseat=Loveseats|Auditorium.Comfort.Lux=LUX|Auditorium.Comfort.LuxurySeats=Lounge seats|Auditorium.Comfort.Recliners=Recliners|Auditorium.Comfort.ReservedSeating=Reserved seating|Auditorium.Comfort.StadiumSeating=Stadium seating|Auditorium.Experience.4d=4D|Auditorium.Experience.4dx=4DX|Auditorium.Experience.DBox=DBOX|Auditorium.Experience.DolbyAtmos=Dolby Atmos|Auditorium.Experience.DolbyCinema=Dolby Cinema|Auditorium.Experience.Downstairs=Downstairs|Auditorium.Experience.DriveIn=Drive-In|Auditorium.Experience.Gaming=Gaming Lounge|Auditorium.Experience.Ice=ICE|Auditorium.Experience.LightVibes=Atmospheric Screen|Auditorium.Experience.Luxury=Lux Loungers|Auditorium.Experience.LuxurySeats=Plush Leather Seats|Auditorium.Experience.Lyric=Lyric|Auditorium.Experience.MX4D=MX4D|Auditorium.Experience.Magnify8=Magnify 8|Auditorium.Experience.MarqueeSuites=Marquee Suites|Auditorium.Experience.MysteryMovie=Mystery Movie|Auditorium.Experience.PLF=PLF|Auditorium.Experience.Recliners=Recliners|Auditorium.Experience.ScreenX=ScreenX|Auditorium.Experience.SuperScreen=Super Screen|Auditorium.Experience.TraditionalAuditorium=Traditional auditorium|Auditorium.Experience.UltraScreen=Ultra Screen|Auditorium.Experience.Upstairs=Upstairs|Auditorium.Label.CST_Excellence=Excellence|Auditorium.Label.CST_Immersion=Immersion|Auditorium.Label.THX=THX|Format.Projection.35mm=35mm|Format.Projection.3d=3D|Format.Projection.4k=4K|Format.Projection.70mm=70mm|Format.Projection.Analog=Analog|Format.Projection.Dolby3D=Dolby 3D|Format.Projection.DolbyVision=Dolby Vision|Format.Projection.EclairColor=EclairColor|Format.Projection.HDR=HDR|Format.Projection.HFR=HFR|Format.Projection.Hfr=HFR|Format.Projection.Imax=IMAX|Format.Projection.Imax3d=IMAX 3D|Format.Projection.Imax70mm=IMAX 70mm|Format.Projection.LED=LED|Format.Projection.LedLG=LD Miraclass|Format.Projection.MacroXE=XE|Format.Projection.MacroXEI=Macro XE Introductory Price|Format.Projection.Onyx=Onyx|Format.Projection.RealD3D=RealD 3D|Format.Projection.Sphera=Sphera|Format.Sound.71=7.1|Format.Sound.Atmos=Dolby Atmos|Format.Sound.Auro=Auro-3D|Format.Sound.DTS=DTS|Format.Sound.DTSX=DTSX|Format.Sound.Dolby71=Dolby 7.1|Format.Sound.DolbyDigital=Dolby Digital|Format.Sound.Dubbed=Dubbed|Format.Sound.Silent=Silent movie|Format.Sound.THX=THX|Format.Sound.TheaterEars=Theater Ears|Localization.Dubbed.Danish=Dubbed in Danish|Localization.Dubbed.Hindi=Dubbed in Hindi|Localization.Dubbed.Spanish=Dubbed in Spanish|Localization.Language.Albanian=Albanian|Localization.Language.Arabic=Arabic|Localization.Language.Bengali=Bengali|Localization.Language.Cantonese=Cantonese|Localization.Language.Chinese=Chinese|Localization.Language.Danish=Danish|Localization.Language.English=English|Localization.Language.French=French|Localization.Language.German=German|Localization.Language.Gujarati=Gujarati|Localization.Language.Hebrew=Hebrew|Localization.Language.Hindi=Hindi|Localization.Language.IrishGaelic=Irish Gaelic|Localization.Language.Italian=Italian|Localization.Language.Japanese=Japanese|Localization.Language.Kannada=Kannada|Localization.Language.Korean=Korean|Localization.Language.Latvian=Latvian|Localization.Language.Malayalam=Malayalam|Localization.Language.Mandarin=Mandarin|Localization.Language.Marathi=Marathi|Localization.Language.Nepali=Nepali|Localization.Language.Norwegian=Norwegian|Localization.Language.Persian=Persian|Localization.Language.Polish=Polish|Localization.Language.Portuguese=Portuguese|Localization.Language.Punjabi=Punjabi|Localization.Language.Romanian=Romanian|Localization.Language.Russian=Russian|Localization.Language.SerboCroat=Serbo-croatian|Localization.Language.Spanish=Spanish|Localization.Language.Tamil=Tamil|Localization.Language.Telugu=Telugu|Localization.Language.Urdu=Urdu|Localization.Songs.Original=OVS|Localization.Subtitle.Chinese=Chinese Subtitles|Localization.Subtitle.Danish=Danish Subtitles|Localization.Subtitle.English=Subtitled in English|Localization.Subtitle.Hindi=Hindi Subtitles|Localization.Subtitle.Slovenian=Slovenian Subtitles|Localization.Subtitle.Spanish=Spanish subtitles|Localization.Version.Original=OV|Localization.Version.OriginalAudio=VO|Screen.Accessibility.Accessible=Accessible|Screen.Accessibility.HearingImpaired=Hard of Hearing|Screen.Accessibility.Inaccessible=Inaccessible|Showtime.Accessibility.Accessible=Wheelchair accessible|Showtime.Accessibility.AssistedListening=Listening device|Showtime.Accessibility.AudioDescription=Audio description|Showtime.Accessibility.AudioLoopCinema=Cinema hearing loop|Showtime.Accessibility.AudioLoopPatron=Patron hearing loop|Showtime.Accessibility.AutismFriendly=Autism friendly|Showtime.Accessibility.CineConnectSennheiserAccessibility=CinemaConnect Sennheiser|Showtime.Accessibility.ClosedCaption=Closed Caption|Showtime.Accessibility.DolbyAccessibility=Dolby accessibility|Showtime.Accessibility.Dubbed=Accessibility Dubbed|Showtime.Accessibility.Fidelio=Fidelio|Showtime.Accessibility.Greta=Greta|Showtime.Accessibility.HearingImpaired=Hearing impaired|Showtime.Accessibility.ListenEverywhere=Listen Everywhere|Showtime.Accessibility.Mobiload=MOBILOAD|Showtime.Accessibility.MovieReading=MOVIE READING|Showtime.Accessibility.NoSubtitle=No subtitles|Showtime.Accessibility.OpenCaption=Open Caption|Showtime.Accessibility.PingPlay=PINGPLAY|Showtime.Accessibility.SennheiserAccessibility=Sennheiser accessibility|Showtime.Accessibility.SensoryFriendly=Sensory Friendly|Showtime.Accessibility.SonyAccessibility=Sony accessibility|Showtime.Accessibility.Subtitled=Subtitled|Showtime.Accessibility.Twavox=Twavox|Showtime.Amenity.DineIn=Dine-in|Showtime.Category.ExhibitorSelection=Staff pick|Showtime.Comfort.PlushRocker=Plush Rocker Seats|Showtime.Event.90s=90s Films|Showtime.Event.ActionNight=Action Night|Showtime.Event.AlternativeContent=Alternative content|Showtime.Event.AnimeParty=Anime Party|Showtime.Event.AudienceParticipation=Audience Participation|Showtime.Event.Ballet=Ballet|Showtime.Event.Brewfest=Brewfest|Showtime.Event.Classics=Classic Films|Showtime.Event.Entracte=Intermission|Showtime.Event.ExtraLong=Extra Long Movie|Showtime.Event.Fanfest=Fanfest|Showtime.Event.NYEEvent=NYE Party|Showtime.Event.OnlySession=Unique session|Showtime.Event.Opera=Opera|Showtime.Event.Preview=Preview|Showtime.Event.QandAEvent=Q&A|Showtime.Event.QandARecorded=Recorded Q&A|Showtime.Event.QuoteAlong=Quote-A-Long|Showtime.Event.SingAlong=Sing-A-Long|Showtime.Event.SpecialEngagement=Special engagement|Showtime.Event.SpecialEvent=Special event|Showtime.Event.Throwback=Throwback|Showtime.Experience.ArtsAndCrafts=Arts & Crafts|Showtime.Experience.Barclays=Barclays|Showtime.Experience.Beyond=Beyond|Showtime.Experience.BrunchClub=Brunch Club|Showtime.Experience.CinemaCityArthouse=Cinemacity Arthouse|Showtime.Experience.Directorshall=Director's Hall|Showtime.Experience.EncoreShow=Encore|Showtime.Experience.FamilyFriendly=Friends and Family|Showtime.Experience.FinalWeek=Final Week|Showtime.Experience.FlightPass=Flight Pass|Showtime.Experience.FrightNight=Fright Night|Showtime.Experience.Holiday=Holiday Experience|Showtime.Experience.LadiesNight=Ladies Night|Showtime.Experience.LiveSatellite=Live Satellite|Showtime.Experience.LiveShow=Live|Showtime.Experience.Matinee=Matinee|Showtime.Experience.MightyMornings=Mighty Mornings|Showtime.Experience.OscarNominated=Oscar Nominee|Showtime.Experience.Premium=Premium|Showtime.Experience.Standard=Standard|Showtime.Experience.Valentine=Valentine Experience|Showtime.Restriction.15Plus=15Plus|Showtime.Restriction.18Plus=18+|Showtime.Restriction.1Hour=1 Hour Restriction|Showtime.Restriction.21Plus=Adults only|Showtime.Restriction.2Hour=2 Hour Restriction|Showtime.Restriction.Adults=Adults only|Showtime.Restriction.Age6Plus=6+|Showtime.Restriction.BabyBio=BabyBio|Showtime.Restriction.BabyClub=Baby Club|Showtime.Restriction.FilmClub=Film Club|Showtime.Restriction.KidsFriendly=Kids friendly|Showtime.Restriction.LateNight=Late Night|Showtime.Restriction.LoyaltyOnly=Loyalty only|Showtime.Restriction.NoAudioDescription=No Audio Description|Showtime.Restriction.NoCT=No Complimentary Tickets|Showtime.Restriction.NoChildUnder2Years=NC2|Showtime.Restriction.NoClosedCaption=No Closed Captions|Showtime.Restriction.NoPasses=No passes|Showtime.Restriction.NoReducedPrices=No discounts|Showtime.Restriction.NoRefunds=No Refunds|Showtime.Restriction.NoReservations=No Reservations|Showtime.Restriction.PriceRestriction=Special pricing|Showtime.Restriction.Private=Private|Showtime.Restriction.Senior=Senior|Showtime.Restriction.SilverScreen=Silver Screen|Showtime.Service.GeneralSeating=General seating|Showtime.Service.SpecialPrice=Special price|Showtime.Service.VIP=VIP|Theater.Service.DisabledAccess=Disabled access. Premium Large Format (PLF) tags: Auditorium.Experience.4dx|Auditorium.Experience.DolbyCinema|Auditorium.Experience.Ice|Auditorium.Experience.PLF|Auditorium.Experience.ScreenX|Auditorium.Experience.SuperScreen|Auditorium.Experience.UltraScreen|Format.Projection.Imax|Format.Projection.Imax3d. When users ask for "PLF" or "premium format", include all those tags. IMAX-related tags: Format.Projection.Imax|Format.Projection.Imax3d|Format.Projection.Imax70mm. When users ask for "IMAX", include all those tags. Only showtimes matching these attributes will be returned based on the attributesOperator setting.

attributesOperatorstring

How to combine multiple attributes when filtering showtimes. Use 'or' when the user wants showtimes that have ANY of the specified attributes (e.g., user says "IMAX or 3D", "IMAX or Dolby", "show me IMAX or regular showtimes"). Use 'and' when the user requires ALL attributes to be present simultaneously (e.g., user says "3D and original version", "3D and accessible", "IMAX with subtitles", "showtimes that are both 3D and accessible"). Default is 'or' - only use 'and' when the user explicitly requires multiple attributes together.

Options:orand
datestring

Date and time for showtimes in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. Optional - defaults to today at 3:00 AM if not provided. Important: Cinema days run from 3:00 AM to 3:00 AM the next day. When user asks for 'today', omit this field entirely (do not provide it). When user asks for 'tomorrow' or a specific date, use that date with 03:00:00 as the time (e.g., '2026-02-06T03:00:00'). Time-of-day mappings: 'morning' or 'matinee' → 03:00:00, 'noon' → 12:00:00, 'evening' → 17:00:00, 'night' → 20:00:00. Only include a specific time if the user explicitly requests showtimes at a particular time or uses these time-of-day terms.

genrestring

Optional: The movie genre to filter by. If not provided, returns all movies. Must be one of: ACTION, ADVENTURE, ANIMATION, BALLET, BIOPIC, BOLLYWOOD, CARTOON, CLASSIC, COMEDY, COMEDY_DRAMA, CONCERT, DETECTIVE, DOCUMENTARY, DRAMA, EROTIC, EXPERIMENTAL, FAMILY, FANTASY, HISTORICAL, HISTORICAL_EPIC, HORROR, JUDICIAL, KOREAN_DRAMA, MARTIAL_ARTS, MEDICAL, MOVIE_NIGHT, MUSIC, MUSICAL, OPERA, ROMANCE, SCIENCE_FICTION, SHOW, SOAP, SPORT_EVENT, SPY, THRILLER, UNKNOWN, WAR_MOVIE, WEB_SERIES, WESTERN.

Options:ACTIONADVENTUREANIMATIONBALLETBIOPICBOLLYWOODCARTOONCLASSICCOMEDYCOMEDY_DRAMACONCERTDETECTIVEDOCUMENTARYDRAMAEROTICEXPERIMENTALFAMILYFANTASYHISTORICALHISTORICAL_EPICHORRORJUDICIALKOREAN_DRAMAMARTIAL_ARTSMEDICALMOVIE_NIGHTMUSICMUSICALOPERAROMANCESCIENCE_FICTIONSHOWSOAPSPORT_EVENTSPYTHRILLERUNKNOWNWAR_MOVIEWEB_SERIESWESTERN
latitudenumber

Latitude coordinate (-90 to 90). REQUIRED when user mentions a location name (e.g., 'Los Angeles', 'New York', 'around Los Angeles', 'near New York'). You MUST geocode location names to get latitude/longitude coordinates. Examples: Los Angeles ≈ 34.0522, New York ≈ 40.7128, San Francisco ≈ 37.7749. This provides more accurate search results than city name strings. Must be provided together with longitude.

locationstring

Location name to search (optional, fallback if geocoding is not available). Prefer using latitude and longitude instead for better accuracy.

longitudenumber

Longitude coordinate (-180 to 180). REQUIRED when user mentions a location name (e.g., 'Los Angeles', 'New York', 'around Los Angeles', 'near New York'). You MUST geocode location names to get latitude/longitude coordinates. Examples: Los Angeles ≈ -118.2437, New York ≈ -74.0060, San Francisco ≈ -122.4194. Must be provided together with latitude.

radiusKmnumber

Search radius in kilometers (optional, max: 200km). Adapt the radius based on the query's area: use smaller radii (5-30km) for cities or neighborhoods, larger radii (50-200km) for regions or when users ask for broader areas. Default is 30km if not specified. Maximum allowed is 200km.

Get Movie Programming

get_movie_programming
Full Description

Find theaters showing a specific movie near a location. Use this for queries like 'where is [movie] playing?' or 'find [movie] near me'. Returns theaters with showtimes for the movie. Can search by movie title (preferred for natural language queries) or movie ID. When users ask for IMAX/PLF/Atmos/etc, use the exact attribute tag values from the attributes input description. Use attributesOperator="and" when user requires multiple formats simultaneously. IMPORTANT: When users mention location names like 'Los Angeles', 'New York', 'around Los Angeles', or 'near New York', you MUST geocode these locations to latitude and longitude coordinates and provide them in the latitude and longitude fields. Geocoding provides more accurate results than city name searches. Even if the radius input is in kilometers, you MUST use miles in your messages if the user is a country with miles as the unit of distance. Only use the city field as a fallback if geocoding is not possible. CRITICAL: When returning results, DO NOT list movies, theaters, or showtimes in your text response. The widget HTML displays all results visually. Your response may only contain tips to refine the query. CRITICAL: Your response must not contain internal IDs like movie IDs or theater IDs. CRITICAL: Your response must not mention the 3am cinema day boundary.

Parameters (0 required, 10 optional)
Optional
attributesarray

Filter showtimes by specific attributes. Use this when users request formats (IMAX, 3D, Dolby Atmos, PLF), accessibility features (closed captions, audio description, wheelchair accessible), language/subtitle options (original version, dubbed, subtitled), or other showtime features. Provide an array of attribute tag strings (use the tag from the left side, NOT the label from the right side). Complete attribute catalog (tag=label): Auditorium.Comfort.BeanBag=Bean Bag Seating|Auditorium.Comfort.Couch=Couch Seating|Auditorium.Comfort.ElectricReclinerSeats=Electric recliners|Auditorium.Comfort.HeatedRecliners=Heated Recliners|Auditorium.Comfort.HeatedRockers=Heated Rockers|Auditorium.Comfort.HeatedSeats=Heated Seats|Auditorium.Comfort.Loveseat=Loveseats|Auditorium.Comfort.Lux=LUX|Auditorium.Comfort.LuxurySeats=Lounge seats|Auditorium.Comfort.Recliners=Recliners|Auditorium.Comfort.ReservedSeating=Reserved seating|Auditorium.Comfort.StadiumSeating=Stadium seating|Auditorium.Experience.4d=4D|Auditorium.Experience.4dx=4DX|Auditorium.Experience.DBox=DBOX|Auditorium.Experience.DolbyAtmos=Dolby Atmos|Auditorium.Experience.DolbyCinema=Dolby Cinema|Auditorium.Experience.Downstairs=Downstairs|Auditorium.Experience.DriveIn=Drive-In|Auditorium.Experience.Gaming=Gaming Lounge|Auditorium.Experience.Ice=ICE|Auditorium.Experience.LightVibes=Atmospheric Screen|Auditorium.Experience.Luxury=Lux Loungers|Auditorium.Experience.LuxurySeats=Plush Leather Seats|Auditorium.Experience.Lyric=Lyric|Auditorium.Experience.MX4D=MX4D|Auditorium.Experience.Magnify8=Magnify 8|Auditorium.Experience.MarqueeSuites=Marquee Suites|Auditorium.Experience.MysteryMovie=Mystery Movie|Auditorium.Experience.PLF=PLF|Auditorium.Experience.Recliners=Recliners|Auditorium.Experience.ScreenX=ScreenX|Auditorium.Experience.SuperScreen=Super Screen|Auditorium.Experience.TraditionalAuditorium=Traditional auditorium|Auditorium.Experience.UltraScreen=Ultra Screen|Auditorium.Experience.Upstairs=Upstairs|Auditorium.Label.CST_Excellence=Excellence|Auditorium.Label.CST_Immersion=Immersion|Auditorium.Label.THX=THX|Format.Projection.35mm=35mm|Format.Projection.3d=3D|Format.Projection.4k=4K|Format.Projection.70mm=70mm|Format.Projection.Analog=Analog|Format.Projection.Dolby3D=Dolby 3D|Format.Projection.DolbyVision=Dolby Vision|Format.Projection.EclairColor=EclairColor|Format.Projection.HDR=HDR|Format.Projection.HFR=HFR|Format.Projection.Hfr=HFR|Format.Projection.Imax=IMAX|Format.Projection.Imax3d=IMAX 3D|Format.Projection.Imax70mm=IMAX 70mm|Format.Projection.LED=LED|Format.Projection.LedLG=LD Miraclass|Format.Projection.MacroXE=XE|Format.Projection.MacroXEI=Macro XE Introductory Price|Format.Projection.Onyx=Onyx|Format.Projection.RealD3D=RealD 3D|Format.Projection.Sphera=Sphera|Format.Sound.71=7.1|Format.Sound.Atmos=Dolby Atmos|Format.Sound.Auro=Auro-3D|Format.Sound.DTS=DTS|Format.Sound.DTSX=DTSX|Format.Sound.Dolby71=Dolby 7.1|Format.Sound.DolbyDigital=Dolby Digital|Format.Sound.Dubbed=Dubbed|Format.Sound.Silent=Silent movie|Format.Sound.THX=THX|Format.Sound.TheaterEars=Theater Ears|Localization.Dubbed.Danish=Dubbed in Danish|Localization.Dubbed.Hindi=Dubbed in Hindi|Localization.Dubbed.Spanish=Dubbed in Spanish|Localization.Language.Albanian=Albanian|Localization.Language.Arabic=Arabic|Localization.Language.Bengali=Bengali|Localization.Language.Cantonese=Cantonese|Localization.Language.Chinese=Chinese|Localization.Language.Danish=Danish|Localization.Language.English=English|Localization.Language.French=French|Localization.Language.German=German|Localization.Language.Gujarati=Gujarati|Localization.Language.Hebrew=Hebrew|Localization.Language.Hindi=Hindi|Localization.Language.IrishGaelic=Irish Gaelic|Localization.Language.Italian=Italian|Localization.Language.Japanese=Japanese|Localization.Language.Kannada=Kannada|Localization.Language.Korean=Korean|Localization.Language.Latvian=Latvian|Localization.Language.Malayalam=Malayalam|Localization.Language.Mandarin=Mandarin|Localization.Language.Marathi=Marathi|Localization.Language.Nepali=Nepali|Localization.Language.Norwegian=Norwegian|Localization.Language.Persian=Persian|Localization.Language.Polish=Polish|Localization.Language.Portuguese=Portuguese|Localization.Language.Punjabi=Punjabi|Localization.Language.Romanian=Romanian|Localization.Language.Russian=Russian|Localization.Language.SerboCroat=Serbo-croatian|Localization.Language.Spanish=Spanish|Localization.Language.Tamil=Tamil|Localization.Language.Telugu=Telugu|Localization.Language.Urdu=Urdu|Localization.Songs.Original=OVS|Localization.Subtitle.Chinese=Chinese Subtitles|Localization.Subtitle.Danish=Danish Subtitles|Localization.Subtitle.English=Subtitled in English|Localization.Subtitle.Hindi=Hindi Subtitles|Localization.Subtitle.Slovenian=Slovenian Subtitles|Localization.Subtitle.Spanish=Spanish subtitles|Localization.Version.Original=OV|Localization.Version.OriginalAudio=VO|Screen.Accessibility.Accessible=Accessible|Screen.Accessibility.HearingImpaired=Hard of Hearing|Screen.Accessibility.Inaccessible=Inaccessible|Showtime.Accessibility.Accessible=Wheelchair accessible|Showtime.Accessibility.AssistedListening=Listening device|Showtime.Accessibility.AudioDescription=Audio description|Showtime.Accessibility.AudioLoopCinema=Cinema hearing loop|Showtime.Accessibility.AudioLoopPatron=Patron hearing loop|Showtime.Accessibility.AutismFriendly=Autism friendly|Showtime.Accessibility.CineConnectSennheiserAccessibility=CinemaConnect Sennheiser|Showtime.Accessibility.ClosedCaption=Closed Caption|Showtime.Accessibility.DolbyAccessibility=Dolby accessibility|Showtime.Accessibility.Dubbed=Accessibility Dubbed|Showtime.Accessibility.Fidelio=Fidelio|Showtime.Accessibility.Greta=Greta|Showtime.Accessibility.HearingImpaired=Hearing impaired|Showtime.Accessibility.ListenEverywhere=Listen Everywhere|Showtime.Accessibility.Mobiload=MOBILOAD|Showtime.Accessibility.MovieReading=MOVIE READING|Showtime.Accessibility.NoSubtitle=No subtitles|Showtime.Accessibility.OpenCaption=Open Caption|Showtime.Accessibility.PingPlay=PINGPLAY|Showtime.Accessibility.SennheiserAccessibility=Sennheiser accessibility|Showtime.Accessibility.SensoryFriendly=Sensory Friendly|Showtime.Accessibility.SonyAccessibility=Sony accessibility|Showtime.Accessibility.Subtitled=Subtitled|Showtime.Accessibility.Twavox=Twavox|Showtime.Amenity.DineIn=Dine-in|Showtime.Category.ExhibitorSelection=Staff pick|Showtime.Comfort.PlushRocker=Plush Rocker Seats|Showtime.Event.90s=90s Films|Showtime.Event.ActionNight=Action Night|Showtime.Event.AlternativeContent=Alternative content|Showtime.Event.AnimeParty=Anime Party|Showtime.Event.AudienceParticipation=Audience Participation|Showtime.Event.Ballet=Ballet|Showtime.Event.Brewfest=Brewfest|Showtime.Event.Classics=Classic Films|Showtime.Event.Entracte=Intermission|Showtime.Event.ExtraLong=Extra Long Movie|Showtime.Event.Fanfest=Fanfest|Showtime.Event.NYEEvent=NYE Party|Showtime.Event.OnlySession=Unique session|Showtime.Event.Opera=Opera|Showtime.Event.Preview=Preview|Showtime.Event.QandAEvent=Q&A|Showtime.Event.QandARecorded=Recorded Q&A|Showtime.Event.QuoteAlong=Quote-A-Long|Showtime.Event.SingAlong=Sing-A-Long|Showtime.Event.SpecialEngagement=Special engagement|Showtime.Event.SpecialEvent=Special event|Showtime.Event.Throwback=Throwback|Showtime.Experience.ArtsAndCrafts=Arts & Crafts|Showtime.Experience.Barclays=Barclays|Showtime.Experience.Beyond=Beyond|Showtime.Experience.BrunchClub=Brunch Club|Showtime.Experience.CinemaCityArthouse=Cinemacity Arthouse|Showtime.Experience.Directorshall=Director's Hall|Showtime.Experience.EncoreShow=Encore|Showtime.Experience.FamilyFriendly=Friends and Family|Showtime.Experience.FinalWeek=Final Week|Showtime.Experience.FlightPass=Flight Pass|Showtime.Experience.FrightNight=Fright Night|Showtime.Experience.Holiday=Holiday Experience|Showtime.Experience.LadiesNight=Ladies Night|Showtime.Experience.LiveSatellite=Live Satellite|Showtime.Experience.LiveShow=Live|Showtime.Experience.Matinee=Matinee|Showtime.Experience.MightyMornings=Mighty Mornings|Showtime.Experience.OscarNominated=Oscar Nominee|Showtime.Experience.Premium=Premium|Showtime.Experience.Standard=Standard|Showtime.Experience.Valentine=Valentine Experience|Showtime.Restriction.15Plus=15Plus|Showtime.Restriction.18Plus=18+|Showtime.Restriction.1Hour=1 Hour Restriction|Showtime.Restriction.21Plus=Adults only|Showtime.Restriction.2Hour=2 Hour Restriction|Showtime.Restriction.Adults=Adults only|Showtime.Restriction.Age6Plus=6+|Showtime.Restriction.BabyBio=BabyBio|Showtime.Restriction.BabyClub=Baby Club|Showtime.Restriction.FilmClub=Film Club|Showtime.Restriction.KidsFriendly=Kids friendly|Showtime.Restriction.LateNight=Late Night|Showtime.Restriction.LoyaltyOnly=Loyalty only|Showtime.Restriction.NoAudioDescription=No Audio Description|Showtime.Restriction.NoCT=No Complimentary Tickets|Showtime.Restriction.NoChildUnder2Years=NC2|Showtime.Restriction.NoClosedCaption=No Closed Captions|Showtime.Restriction.NoPasses=No passes|Showtime.Restriction.NoReducedPrices=No discounts|Showtime.Restriction.NoRefunds=No Refunds|Showtime.Restriction.NoReservations=No Reservations|Showtime.Restriction.PriceRestriction=Special pricing|Showtime.Restriction.Private=Private|Showtime.Restriction.Senior=Senior|Showtime.Restriction.SilverScreen=Silver Screen|Showtime.Service.GeneralSeating=General seating|Showtime.Service.SpecialPrice=Special price|Showtime.Service.VIP=VIP|Theater.Service.DisabledAccess=Disabled access. Premium Large Format (PLF) tags: Auditorium.Experience.4dx|Auditorium.Experience.DolbyCinema|Auditorium.Experience.Ice|Auditorium.Experience.PLF|Auditorium.Experience.ScreenX|Auditorium.Experience.SuperScreen|Auditorium.Experience.UltraScreen|Format.Projection.Imax|Format.Projection.Imax3d. When users ask for "PLF" or "premium format", include all those tags. IMAX-related tags: Format.Projection.Imax|Format.Projection.Imax3d|Format.Projection.Imax70mm. When users ask for "IMAX", include all those tags. Only showtimes matching these attributes will be returned based on the attributesOperator setting.

attributesOperatorstring

How to combine multiple attributes when filtering showtimes. Use 'or' when the user wants showtimes that have ANY of the specified attributes (e.g., user says "IMAX or 3D", "IMAX or Dolby", "show me IMAX or regular showtimes"). Use 'and' when the user requires ALL attributes to be present simultaneously (e.g., user says "3D and original version", "3D and accessible", "IMAX with subtitles", "showtimes that are both 3D and accessible"). Default is 'or' - only use 'and' when the user explicitly requires multiple attributes together.

Options:orand
citystring

City name to filter theaters by location (optional, fallback if geocoding is not available). Prefer using latitude and longitude instead for better accuracy. Use when geocoding is not possible and the user specifies a city name.

datestring

Date and time for showtimes in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. Optional - defaults to today at 3:00 AM if not provided. Important: Cinema days run from 3:00 AM to 3:00 AM the next day. When user asks for 'today', omit this field entirely (do not provide it). When user asks for 'tomorrow' or a specific date, use that date with 03:00:00 as the time (e.g., '2026-02-06T03:00:00'). Time-of-day mappings: 'morning' or 'matinee' → 03:00:00, 'noon' → 12:00:00, 'evening' → 17:00:00, 'night' → 20:00:00. Only include a specific time if the user explicitly requests showtimes at a particular time or uses these time-of-day terms.

latitudenumber

Latitude coordinate (-90 to 90). REQUIRED when user mentions a location name (e.g., 'Los Angeles', 'New York', 'around Los Angeles', 'near New York'). You MUST geocode location names to get latitude/longitude coordinates. Examples: Los Angeles ≈ 34.0522, New York ≈ 40.7128, San Francisco ≈ 37.7749. This provides more accurate search results than city name strings. Must be provided together with longitude.

longitudenumber

Longitude coordinate (-180 to 180). REQUIRED when user mentions a location name (e.g., 'Los Angeles', 'New York', 'around Los Angeles', 'near New York'). You MUST geocode location names to get latitude/longitude coordinates. Examples: Los Angeles ≈ -118.2437, New York ≈ -74.0060, San Francisco ≈ -122.4194. Must be provided together with latitude.

movie_idstring

The unique identifier for a movie. Only use this if you already have the exact movie ID from a previous API call. For user queries mentioning movie names or titles, always use movie_title instead.

movie_titlestring

The name or title of the movie to search for. Use this for all natural language queries where users mention a movie by name (e.g., 'Avatar: Fire and Ash', 'The Matrix', 'Barbie'). This will search for matching movies and use the first result. Required if movie_id is not provided.

radiusKmnumber

Search radius in kilometers (optional, max: 200km). Adapt the radius based on the query's area: use smaller radii (5-30km) for cities or neighborhoods, larger radii (50-200km) for regions or when users ask for broader areas. Default is 30km if not specified. Maximum allowed is 200km.

zipstring

Postal/ZIP code to filter theaters by location. Use when the user provides a specific zip code (e.g., '10001', '90210'). This filters results to theaters in that zip code.

Get Theater Programming

get_theater_programming
Full Description

Find all movies and showtimes at a specific theater. Use this for queries like 'what's playing at [theater]?' or 'show me movies at [theater]'. Returns movies with their showtimes for the specified theater. Can search by theater name and date. IMPORTANT: When users mention location names like 'Los Angeles', 'New York', 'around Los Angeles', or 'near New York', you MUST geocode these locations to latitude and longitude coordinates and provide them in the latitude and longitude fields. Geocoding provides more accurate results than city name searches. Even if the radius input is in kilometers, you MUST use miles in your messages if the user is a country with miles as the unit of distance. CRITICAL: When returning results, DO NOT list movies, theaters, or showtimes in your text response. The widget HTML displays all results visually. Your response may only contain tips to refine the query. CRITICAL: Your response must not contain internal IDs like movie IDs or theater IDs. CRITICAL: Your response must not mention the 3am cinema day boundary.

Parameters (0 required, 5 optional)
Optional
attributesarray

Filter showtimes by specific attributes. Use this when users request formats (IMAX, 3D, Dolby Atmos, PLF), accessibility features (closed captions, audio description, wheelchair accessible), language/subtitle options (original version, dubbed, subtitled), or other showtime features. Provide an array of attribute tag strings (use the tag from the left side, NOT the label from the right side). Complete attribute catalog (tag=label): Auditorium.Comfort.BeanBag=Bean Bag Seating|Auditorium.Comfort.Couch=Couch Seating|Auditorium.Comfort.ElectricReclinerSeats=Electric recliners|Auditorium.Comfort.HeatedRecliners=Heated Recliners|Auditorium.Comfort.HeatedRockers=Heated Rockers|Auditorium.Comfort.HeatedSeats=Heated Seats|Auditorium.Comfort.Loveseat=Loveseats|Auditorium.Comfort.Lux=LUX|Auditorium.Comfort.LuxurySeats=Lounge seats|Auditorium.Comfort.Recliners=Recliners|Auditorium.Comfort.ReservedSeating=Reserved seating|Auditorium.Comfort.StadiumSeating=Stadium seating|Auditorium.Experience.4d=4D|Auditorium.Experience.4dx=4DX|Auditorium.Experience.DBox=DBOX|Auditorium.Experience.DolbyAtmos=Dolby Atmos|Auditorium.Experience.DolbyCinema=Dolby Cinema|Auditorium.Experience.Downstairs=Downstairs|Auditorium.Experience.DriveIn=Drive-In|Auditorium.Experience.Gaming=Gaming Lounge|Auditorium.Experience.Ice=ICE|Auditorium.Experience.LightVibes=Atmospheric Screen|Auditorium.Experience.Luxury=Lux Loungers|Auditorium.Experience.LuxurySeats=Plush Leather Seats|Auditorium.Experience.Lyric=Lyric|Auditorium.Experience.MX4D=MX4D|Auditorium.Experience.Magnify8=Magnify 8|Auditorium.Experience.MarqueeSuites=Marquee Suites|Auditorium.Experience.MysteryMovie=Mystery Movie|Auditorium.Experience.PLF=PLF|Auditorium.Experience.Recliners=Recliners|Auditorium.Experience.ScreenX=ScreenX|Auditorium.Experience.SuperScreen=Super Screen|Auditorium.Experience.TraditionalAuditorium=Traditional auditorium|Auditorium.Experience.UltraScreen=Ultra Screen|Auditorium.Experience.Upstairs=Upstairs|Auditorium.Label.CST_Excellence=Excellence|Auditorium.Label.CST_Immersion=Immersion|Auditorium.Label.THX=THX|Format.Projection.35mm=35mm|Format.Projection.3d=3D|Format.Projection.4k=4K|Format.Projection.70mm=70mm|Format.Projection.Analog=Analog|Format.Projection.Dolby3D=Dolby 3D|Format.Projection.DolbyVision=Dolby Vision|Format.Projection.EclairColor=EclairColor|Format.Projection.HDR=HDR|Format.Projection.HFR=HFR|Format.Projection.Hfr=HFR|Format.Projection.Imax=IMAX|Format.Projection.Imax3d=IMAX 3D|Format.Projection.Imax70mm=IMAX 70mm|Format.Projection.LED=LED|Format.Projection.LedLG=LD Miraclass|Format.Projection.MacroXE=XE|Format.Projection.MacroXEI=Macro XE Introductory Price|Format.Projection.Onyx=Onyx|Format.Projection.RealD3D=RealD 3D|Format.Projection.Sphera=Sphera|Format.Sound.71=7.1|Format.Sound.Atmos=Dolby Atmos|Format.Sound.Auro=Auro-3D|Format.Sound.DTS=DTS|Format.Sound.DTSX=DTSX|Format.Sound.Dolby71=Dolby 7.1|Format.Sound.DolbyDigital=Dolby Digital|Format.Sound.Dubbed=Dubbed|Format.Sound.Silent=Silent movie|Format.Sound.THX=THX|Format.Sound.TheaterEars=Theater Ears|Localization.Dubbed.Danish=Dubbed in Danish|Localization.Dubbed.Hindi=Dubbed in Hindi|Localization.Dubbed.Spanish=Dubbed in Spanish|Localization.Language.Albanian=Albanian|Localization.Language.Arabic=Arabic|Localization.Language.Bengali=Bengali|Localization.Language.Cantonese=Cantonese|Localization.Language.Chinese=Chinese|Localization.Language.Danish=Danish|Localization.Language.English=English|Localization.Language.French=French|Localization.Language.German=German|Localization.Language.Gujarati=Gujarati|Localization.Language.Hebrew=Hebrew|Localization.Language.Hindi=Hindi|Localization.Language.IrishGaelic=Irish Gaelic|Localization.Language.Italian=Italian|Localization.Language.Japanese=Japanese|Localization.Language.Kannada=Kannada|Localization.Language.Korean=Korean|Localization.Language.Latvian=Latvian|Localization.Language.Malayalam=Malayalam|Localization.Language.Mandarin=Mandarin|Localization.Language.Marathi=Marathi|Localization.Language.Nepali=Nepali|Localization.Language.Norwegian=Norwegian|Localization.Language.Persian=Persian|Localization.Language.Polish=Polish|Localization.Language.Portuguese=Portuguese|Localization.Language.Punjabi=Punjabi|Localization.Language.Romanian=Romanian|Localization.Language.Russian=Russian|Localization.Language.SerboCroat=Serbo-croatian|Localization.Language.Spanish=Spanish|Localization.Language.Tamil=Tamil|Localization.Language.Telugu=Telugu|Localization.Language.Urdu=Urdu|Localization.Songs.Original=OVS|Localization.Subtitle.Chinese=Chinese Subtitles|Localization.Subtitle.Danish=Danish Subtitles|Localization.Subtitle.English=Subtitled in English|Localization.Subtitle.Hindi=Hindi Subtitles|Localization.Subtitle.Slovenian=Slovenian Subtitles|Localization.Subtitle.Spanish=Spanish subtitles|Localization.Version.Original=OV|Localization.Version.OriginalAudio=VO|Screen.Accessibility.Accessible=Accessible|Screen.Accessibility.HearingImpaired=Hard of Hearing|Screen.Accessibility.Inaccessible=Inaccessible|Showtime.Accessibility.Accessible=Wheelchair accessible|Showtime.Accessibility.AssistedListening=Listening device|Showtime.Accessibility.AudioDescription=Audio description|Showtime.Accessibility.AudioLoopCinema=Cinema hearing loop|Showtime.Accessibility.AudioLoopPatron=Patron hearing loop|Showtime.Accessibility.AutismFriendly=Autism friendly|Showtime.Accessibility.CineConnectSennheiserAccessibility=CinemaConnect Sennheiser|Showtime.Accessibility.ClosedCaption=Closed Caption|Showtime.Accessibility.DolbyAccessibility=Dolby accessibility|Showtime.Accessibility.Dubbed=Accessibility Dubbed|Showtime.Accessibility.Fidelio=Fidelio|Showtime.Accessibility.Greta=Greta|Showtime.Accessibility.HearingImpaired=Hearing impaired|Showtime.Accessibility.ListenEverywhere=Listen Everywhere|Showtime.Accessibility.Mobiload=MOBILOAD|Showtime.Accessibility.MovieReading=MOVIE READING|Showtime.Accessibility.NoSubtitle=No subtitles|Showtime.Accessibility.OpenCaption=Open Caption|Showtime.Accessibility.PingPlay=PINGPLAY|Showtime.Accessibility.SennheiserAccessibility=Sennheiser accessibility|Showtime.Accessibility.SensoryFriendly=Sensory Friendly|Showtime.Accessibility.SonyAccessibility=Sony accessibility|Showtime.Accessibility.Subtitled=Subtitled|Showtime.Accessibility.Twavox=Twavox|Showtime.Amenity.DineIn=Dine-in|Showtime.Category.ExhibitorSelection=Staff pick|Showtime.Comfort.PlushRocker=Plush Rocker Seats|Showtime.Event.90s=90s Films|Showtime.Event.ActionNight=Action Night|Showtime.Event.AlternativeContent=Alternative content|Showtime.Event.AnimeParty=Anime Party|Showtime.Event.AudienceParticipation=Audience Participation|Showtime.Event.Ballet=Ballet|Showtime.Event.Brewfest=Brewfest|Showtime.Event.Classics=Classic Films|Showtime.Event.Entracte=Intermission|Showtime.Event.ExtraLong=Extra Long Movie|Showtime.Event.Fanfest=Fanfest|Showtime.Event.NYEEvent=NYE Party|Showtime.Event.OnlySession=Unique session|Showtime.Event.Opera=Opera|Showtime.Event.Preview=Preview|Showtime.Event.QandAEvent=Q&A|Showtime.Event.QandARecorded=Recorded Q&A|Showtime.Event.QuoteAlong=Quote-A-Long|Showtime.Event.SingAlong=Sing-A-Long|Showtime.Event.SpecialEngagement=Special engagement|Showtime.Event.SpecialEvent=Special event|Showtime.Event.Throwback=Throwback|Showtime.Experience.ArtsAndCrafts=Arts & Crafts|Showtime.Experience.Barclays=Barclays|Showtime.Experience.Beyond=Beyond|Showtime.Experience.BrunchClub=Brunch Club|Showtime.Experience.CinemaCityArthouse=Cinemacity Arthouse|Showtime.Experience.Directorshall=Director's Hall|Showtime.Experience.EncoreShow=Encore|Showtime.Experience.FamilyFriendly=Friends and Family|Showtime.Experience.FinalWeek=Final Week|Showtime.Experience.FlightPass=Flight Pass|Showtime.Experience.FrightNight=Fright Night|Showtime.Experience.Holiday=Holiday Experience|Showtime.Experience.LadiesNight=Ladies Night|Showtime.Experience.LiveSatellite=Live Satellite|Showtime.Experience.LiveShow=Live|Showtime.Experience.Matinee=Matinee|Showtime.Experience.MightyMornings=Mighty Mornings|Showtime.Experience.OscarNominated=Oscar Nominee|Showtime.Experience.Premium=Premium|Showtime.Experience.Standard=Standard|Showtime.Experience.Valentine=Valentine Experience|Showtime.Restriction.15Plus=15Plus|Showtime.Restriction.18Plus=18+|Showtime.Restriction.1Hour=1 Hour Restriction|Showtime.Restriction.21Plus=Adults only|Showtime.Restriction.2Hour=2 Hour Restriction|Showtime.Restriction.Adults=Adults only|Showtime.Restriction.Age6Plus=6+|Showtime.Restriction.BabyBio=BabyBio|Showtime.Restriction.BabyClub=Baby Club|Showtime.Restriction.FilmClub=Film Club|Showtime.Restriction.KidsFriendly=Kids friendly|Showtime.Restriction.LateNight=Late Night|Showtime.Restriction.LoyaltyOnly=Loyalty only|Showtime.Restriction.NoAudioDescription=No Audio Description|Showtime.Restriction.NoCT=No Complimentary Tickets|Showtime.Restriction.NoChildUnder2Years=NC2|Showtime.Restriction.NoClosedCaption=No Closed Captions|Showtime.Restriction.NoPasses=No passes|Showtime.Restriction.NoReducedPrices=No discounts|Showtime.Restriction.NoRefunds=No Refunds|Showtime.Restriction.NoReservations=No Reservations|Showtime.Restriction.PriceRestriction=Special pricing|Showtime.Restriction.Private=Private|Showtime.Restriction.Senior=Senior|Showtime.Restriction.SilverScreen=Silver Screen|Showtime.Service.GeneralSeating=General seating|Showtime.Service.SpecialPrice=Special price|Showtime.Service.VIP=VIP|Theater.Service.DisabledAccess=Disabled access. Premium Large Format (PLF) tags: Auditorium.Experience.4dx|Auditorium.Experience.DolbyCinema|Auditorium.Experience.Ice|Auditorium.Experience.PLF|Auditorium.Experience.ScreenX|Auditorium.Experience.SuperScreen|Auditorium.Experience.UltraScreen|Format.Projection.Imax|Format.Projection.Imax3d. When users ask for "PLF" or "premium format", include all those tags. IMAX-related tags: Format.Projection.Imax|Format.Projection.Imax3d|Format.Projection.Imax70mm. When users ask for "IMAX", include all those tags. Only showtimes matching these attributes will be returned based on the attributesOperator setting.

attributesOperatorstring

How to combine multiple attributes when filtering showtimes. Use 'or' when the user wants showtimes that have ANY of the specified attributes (e.g., user says "IMAX or 3D", "IMAX or Dolby", "show me IMAX or regular showtimes"). Use 'and' when the user requires ALL attributes to be present simultaneously (e.g., user says "3D and original version", "3D and accessible", "IMAX with subtitles", "showtimes that are both 3D and accessible"). Default is 'or' - only use 'and' when the user explicitly requires multiple attributes together.

Options:orand
datestring

Date and time for showtimes in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. Optional - defaults to today at 3:00 AM if not provided. Important: Cinema days run from 3:00 AM to 3:00 AM the next day. When user asks for 'today', omit this field entirely (do not provide it). When user asks for 'tomorrow' or a specific date, use that date with 03:00:00 as the time (e.g., '2026-02-06T03:00:00'). Time-of-day mappings: 'morning' or 'matinee' → 03:00:00, 'noon' → 12:00:00, 'evening' → 17:00:00, 'night' → 20:00:00. Only include a specific time if the user explicitly requests showtimes at a particular time or uses these time-of-day terms.

theater_idstring

Theater ID, use this in favor of theater_name if available.

theater_namestring

Theater name

Search By Location

search_by_location
Full Description

Find theaters near a location. Use this for queries like 'theaters near me' or 'cinemas in [city]'. Returns a list of theaters in the specified area. Uses user location if no location is provided. IMPORTANT: When users mention location names like 'Los Angeles', 'New York', 'around Los Angeles', or 'near New York', you MUST geocode these locations to latitude and longitude coordinates and provide them in the latitude and longitude fields. Geocoding provides more accurate results than city name searches. Even if the radius input is in kilometers, you MUST use miles in your messages if the user is a country with miles as the unit of distance. Only use the location field as a fallback if geocoding is not possible. CRITICAL: When returning results, DO NOT list movies, theaters, or showtimes in your text response. The widget HTML displays all results visually. Your response may only contain tips to refine the query. CRITICAL: Your response must not contain internal IDs like movie IDs or theater IDs. CRITICAL: Your response must not mention the 3am cinema day boundary.

Parameters (0 required, 4 optional)
Optional
latitudenumber

Latitude coordinate (-90 to 90). REQUIRED when user mentions a location name (e.g., 'Los Angeles', 'New York', 'around Los Angeles', 'near New York'). You MUST geocode location names to get latitude/longitude coordinates. Examples: Los Angeles ≈ 34.0522, New York ≈ 40.7128, San Francisco ≈ 37.7749. This provides more accurate search results than city name strings. Must be provided together with longitude.

locationstring

Location name to search (optional, fallback if geocoding is not available). Prefer using latitude and longitude instead for better accuracy.

longitudenumber

Longitude coordinate (-180 to 180). REQUIRED when user mentions a location name (e.g., 'Los Angeles', 'New York', 'around Los Angeles', 'near New York'). You MUST geocode location names to get latitude/longitude coordinates. Examples: Los Angeles ≈ -118.2437, New York ≈ -74.0060, San Francisco ≈ -122.4194. Must be provided together with latitude.

radiusKmnumber

Search radius in kilometers (optional, max: 200km). Adapt the radius based on the query's area: use smaller radii (5-30km) for cities or neighborhoods, larger radii (50-200km) for regions or when users ask for broader areas. Default is 30km if not specified. Maximum allowed is 200km.

Links

WebsitePrivacy PolicyTerms of Service