Cinemark APIcinemark.cl ↗

"""
Cinemark Chile API - Usage Example

Get your API key from: https://parse.bot/settings
"""
import requests
import os


class ParseClient:
    """Client for Cinemark Chile API."""

    def __init__(self, api_key=None):
        self.api_key = api_key or os.getenv("PARSE_API_KEY")
        self.base_url = "https://api.parse.bot"
        self.scraper_id = "c41820e7-6833-4249-9478-8e3e925c3114"

    def _call(self, endpoint, method="POST", **params):
        """Make API call."""
        url = f"{self.base_url}/scraper/{self.scraper_id}/{endpoint}"
        headers = {
            "X-API-Key": self.api_key,
            "Content-Type": "application/json",
        }
        payload = dict(params)
        if method.upper() == "GET":
            response = requests.get(url, headers=headers, params=payload)
        else:
            response = requests.post(url, headers=headers, json=payload)
        response.raise_for_status()
        data = response.json()
        return data

    def get_cinemas(self):
        """Get a list of all Cinemark cinemas in Chile with their addresses, locations, available formats, and room counts. Returns all theaters regardless of location."""
        return self._call("get_cinemas", method="GET")

    def get_movies_now_showing(self, cinema_id):
        """Get the currently showing movies and showtimes for a specific cinema, grouped by date and movie. Each movie entry includes its sessions with times, formats, seat availability, and room numbers."""
        return self._call("get_movies_now_showing", method="GET", cinema_id=cinema_id)

    def get_movie_details(self, slug):
        """Get detailed information for a specific movie including synopsis, cast, genres, available formats, versions, languages, and trailer URL. The slug is available from get_movies results. Returns the movie object directly."""
        return self._call("get_movie_details", method="GET", slug=slug)

    def get_ticket_prices(self, cinema_id, showtime_id):
        """Get ticket types and prices for a specific showtime session."""
        return self._call("get_ticket_prices", method="GET", cinema_id=cinema_id, showtime_id=showtime_id)

    def get_releases(self, date=None):
        """Get movies available for presale or coming soon. Returns movies with status PRESALE or COMING_SOON from the full movies catalog. Optionally filter by opening date."""
        return self._call("get_releases", method="GET", date=date)

    def get_confiteria(self, cinema_id):
        """Get the snack bar / concessions menu items for a specific cinema. Returns categories of items (Combos, Coleccionables, Rellenos, etc.) with prices in cents, descriptions, and modifier options."""
        return self._call("get_confiteria", method="GET", cinema_id=cinema_id)

    def get_promotions(self):
        """Get current promotions and discounts available at Cinemark Chile cinemas. Each promotion includes title, description, image, validity dates, applicable theater IDs, and terms."""
        return self._call("get_promotions", method="GET")

    def get_muvi_club_info(self):
        """Get Muvi Club loyalty program information and benefits."""
        return self._call("get_muvi_club_info", method="GET")

    def get_movies(self, status=None):
        """Get all movies currently available at Cinemark Chile including those showing now, in presale, and coming soon. Optionally filter by status. Each movie includes id, slug, title, status, openingDate, runTime, posterUrl, rating, formats, and languages."""
        return self._call("get_movies", method="GET", status=status)

    def get_showtimes(self, theater_id, date=None):
        """Get showtimes for a specific theater. Returns all available sessions for the next several days, including movie name, session time, format, language, room, and seat availability. May return an empty array if no showtimes are currently published."""
        return self._call("get_showtimes", method="GET", theater_id=theater_id, date=date)

    def get_formats(self):
        """Get available cinema formats at Cinemark Chile (2D, 3D, IMAX, DBOX, XD, PALCO, PREMIER, PLAY) with descriptions, images, and feature flags."""
        return self._call("get_formats", method="GET")


if __name__ == "__main__":
    client = ParseClient()

    result = client.get_cinemas()
    print("get_cinemas:", result)

    result = client.get_movies_now_showing(cinema_id="<The numeric ID of the cinema (>")
    print("get_movies_now_showing:", result)

    result = client.get_movie_details(slug="<The URL slug of the movie (e.g>")
    print("get_movie_details:", result)

    result = client.get_ticket_prices(cinema_id="<The unique ID of the cinema.>", showtime_id="<The unique ID of the showtime >")
    print("get_ticket_prices:", result)

    result = client.get_releases(date="<Filter releases by opening dat>")
    print("get_releases:", result)

    result = client.get_confiteria(cinema_id="<The numeric ID of the cinema (>")
    print("get_confiteria:", result)

    result = client.get_promotions()
    print("get_promotions:", result)

    result = client.get_muvi_club_info()
    print("get_muvi_club_info:", result)

    result = client.get_movies(status="<Filter movies by status. Accep>")
    print("get_movies:", result)

    result = client.get_showtimes(theater_id="<Numeric theater ID from get_ci>", date="<Date to filter showtimes for i>")
    print("get_showtimes:", result)

    result = client.get_formats()
    print("get_formats:", result)