Cinemark

Cinemark, the US cinema chain: its theatres, by ZIP code, coordinates or name, and each theatre's showtimes for a day.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

Site: cinemark
Version: 1.0.0
Reads from: cinemark.com

Action	Description	Listed price
`cinemas`	List Cinemark's US theatres: around a ZIP code or coordinates, nearest first, or the whole chain, optionally narrowed to those whose name, city, state or ZIP code contains a query. Each row has the theatre id that showtimes takes, its address, coordinates and page URL. Permanently closed theatres are left out.	Billed per request at your plan's rates
`showtimes`	List one Cinemark theatre's showtimes for a day: every performance with its film, local start time, format (2D, XD, 3D, ScreenX, D-BOX, IMAX), accessibility and seating attributes, rating, runtime, whether it is sold out and its seat selection link. Takes a theatre id from cinemas or the theatre's page URL.	Billed per request at your plan's rates

`cinemas`

List Cinemark's US theatres: around a ZIP code or coordinates, nearest first, or the whole chain, optionally narrowed to those whose name, city, state or ZIP code contains a query. Each row has the theatre id that showtimes takes, its address, coordinates and page URL. Permanently closed theatres are left out.

POST https://request.usestring.ai/v1/integrations/cinemark/cinemas

Input

Unknown fields are rejected.

Field	Type	Description
`query`	string	Words every returned theatre's name, city, state or ZIP code contains, such as plano or dine-in.
`postcode`	string	A US ZIP code to search around, nearest first. Matches `^(\d{5})(?:-\d{4})?$`.
`location`	string	Where to search around, nearest first: a US ZIP code, or latitude,longitude in decimal degrees such as 32.78,-96.80.
`radius`	integer	How far from postcode or location to search, in miles, from 1 to 500. Defaults to 50. From 1 to 500.
`limit`	integer	The most theatres to return, from 1 to 400. Defaults to 50. From 1 to 400.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`cinemaId`	string	Cinemark's theatre id, which showtimes takes.
`name`	string	—
`address`	string	The street address.
`city`	string	—
`postcode`	string	The US ZIP code.
`country`	`US`	ISO 3166-1 alpha-2 country code, always US.
`latitude`	number \| null	Null when Cinemark publishes no coordinates.
`longitude`	number \| null	Null when Cinemark publishes no coordinates.
`url`	string	The theatre's page on cinemark.com.
`chain`	`Cinemark`	Always Cinemark.

Example

curl https://request.usestring.ai/v1/integrations/cinemark/cinemas \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postcode": "75093",
    "radius": 10,
    "limit": 5
  }'

data starts with these rows:

[
  {
    "cinemaId": "231",
    "name": "Cinemark West Plano XD and SCREENX",
    "address": "3800 Dallas Parkway",
    "city": "Plano",
    "postcode": "75093",
    "country": "US",
    "latitude": 33.04924,
    "longitude": -96.827987,
    "url": "https://www.cinemark.com/theatres/tx-plano/cinemark-west-plano-xd-and-screenx",
    "chain": "Cinemark"
  },
  {
    "cinemaId": "193",
    "name": "Cinemark Central Plano",
    "address": "1818 Coit Rd",
    "city": "Plano",
    "postcode": "75075",
    "country": "US",
    "latitude": 33.024669,
    "longitude": -96.770036,
    "url": "https://www.cinemark.com/theatres/tx-plano/cinemark-central-plano",
    "chain": "Cinemark"
  },
  {
    "cinemaId": "251",
    "name": "Cinemark Legacy and XD",
    "address": "7201 Central Expy, Suite 100",
    "city": "Plano",
    "postcode": "75025",
    "country": "US",
    "latitude": 33.070886,
    "longitude": -96.691062,
    "url": "https://www.cinemark.com/theatres/tx-plano/cinemark-legacy-and-xd",
    "chain": "Cinemark"
  }
]

Requests and billing

Requests: 1 Web Access request per result page.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`showtimes`

List one Cinemark theatre's showtimes for a day: every performance with its film, local start time, format (2D, XD, 3D, ScreenX, D-BOX, IMAX), accessibility and seating attributes, rating, runtime, whether it is sold out and its seat selection link. Takes a theatre id from cinemas or the theatre's page URL.

POST https://request.usestring.ai/v1/integrations/cinemark/showtimes