ODEON

ODEON Cinemas (odeon.co.uk): the chain's UK cinemas with addresses and coordinates, and each cinema's showtimes for a day with format, accessibility attributes, screen, certificate and booking link.

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: odeon
Version: 1.0.0
Reads from: odeon.co.uk

Action	Description	Listed price
`cinemas`	List ODEON's open UK cinemas with their id, address, postcode and coordinates, optionally filtered by name, postcode or location.	Billed per request at your plan's rates
`showtimes`	List one ODEON cinema's showtimes for a day: film, start time, format, accessibility attributes, screen, certificate, runtime, sold-out flag and booking link.	Billed per request at your plan's rates

`cinemas`

List ODEON's open UK cinemas with their id, address, postcode and coordinates, optionally filtered by name, postcode or location.

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

Input

Unknown fields are rejected.

Field	Type	Description
`query`	string	Keep cinemas whose name, address, city or postcode contains this text, ignoring case.
`postcode`	string	Keep cinemas whose postcode starts with this, ignoring case and spaces, such as B2 or SE10 0QJ.
`location`	string	Keep cinemas whose city or address contains this text, ignoring case, such as London.
`limit`	integer	Return at most this many cinemas; omitted, every match. At least 1.

Output

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

Field	Type	Description
`cinemaId`	string	ODEON's cinema id, which showtimes takes.
`name`	string	—
`address`	string	The street address lines, comma-separated.
`city`	string \| null	The town or city; null when the address names none apart from the street.
`postcode`	string \| null	—
`country`	string	ISO 3166-1 alpha-2 country code.
`latitude`	number \| null	—
`longitude`	number \| null	—
`url`	string	The cinema's odeon.co.uk page.
`chain`	string	—

Example

curl https://request.usestring.ai/v1/integrations/odeon/cinemas \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location": "Birmingham"
  }'

data starts with these rows:

[
  {
    "cinemaId": "846",
    "name": "Birmingham Broadway Plaza",
    "address": "220 Ladywood Middleway, Birmingham",
    "city": "Birmingham",
    "postcode": "B16 8LP",
    "country": "GB",
    "latitude": 52.4743,
    "longitude": -1.92085,
    "url": "https://www.odeon.co.uk/cinemas/birmingham-broadway-plaza/",
    "chain": "ODEON"
  },
  {
    "cinemaId": "017",
    "name": "Birmingham New Street",
    "address": "New Street, Birmingham",
    "city": "Birmingham",
    "postcode": "B2 4NU",
    "country": "GB",
    "latitude": 52.4783,
    "longitude": -1.89666,
    "url": "https://www.odeon.co.uk/cinemas/birmingham-new-street/",
    "chain": "ODEON"
  }
]

Requests and billing

Requests: 1 Web Access request per call.
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 ODEON cinema's showtimes for a day: film, start time, format, accessibility attributes, screen, certificate, runtime, sold-out flag and booking link.

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