Vue

Vue cinemas in the UK and Ireland (myvue.com): venues with address and coordinates, each venue's showtimes for a day, and a showtime's seat map with seat status and area prices.

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: vue
Version: 1.0.0
Reads from: myvue.com

Action	Description	Listed price
`cinemas`	List Vue cinemas in the UK and Ireland with street address, country and coordinates in one API request. Set includePostcode for city, postcode and full address. Filter by name with query or location, or by postcode district, and cap with limit.	Billed per request at your plan's rates
`showtimes`	List one Vue cinema's performances for a day: film, start time with UTC offset, format, features such as EPIC, Dolby Atmos, audio description or subtitles, screen, booking link, sold-out flag, certificate and running time. Give a cinema id from cinemas or a myvue.com cinema page URL, and optionally a film.	Billed per request at your plan's rates
`seats`	Read one Vue performance's seat map without starting a booking: every seat with its row, number, seating area, type (standard, premium, sofa, wheelchair, companion), status and the area's standard price. Give a showtime id from showtimes or the performance's myvue.com booking URL.	Billed per request at your plan's rates

`cinemas`

List Vue cinemas in the UK and Ireland with street address, country and coordinates in one API request. Set includePostcode for city, postcode and full address. Filter by name with query or location, or by postcode district, and cap with limit.

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

Input

Unknown fields are rejected.

Field	Type	Description
`query`	string	Keep cinemas whose name contains this text, case-insensitive, such as london or islington.
`location`	string	A town or area to match against cinema names, the same as query; both must match when both are given.
`postcode`	string	Keep cinemas in this postcode district or area: a full postcode (B7 5SA), an outward code (B7), an area (B), or an Irish Eircode or its routing key (D22). Reads candidate venue pages until limit matches are found; may read every cinema.
`includePostcode`	boolean	Read returned venue pages for city, postcode and full address. Defaults to false: one API request returns street lines and coordinates, with city and postcode empty. A postcode filter also enables these details.
`limit`	integer	The most cinemas to return, 1 to 100. Defaults to 20. From 1 to 100.

Output

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

Field	Type	Description
`cinemaId`	string	Vue's venue id, which showtimes takes.
`name`	string	The venue's name as Vue lists it, such as London - Islington (Angel Central)
`address`	string	The venue's street address, its lines joined with commas.
`city`	string	The address's town or city line; empty unless includePostcode or a postcode filter is given.
`postcode`	string	The postcode, or Eircode in Ireland; empty unless includePostcode or a postcode filter is given.
`country`	string	ISO 3166-1 alpha-2 country code: GB or IE.
`latitude`	number \| null	null when the venue API carries no coordinates.
`longitude`	number \| null	null when the venue API carries no coordinates.
`url`	string	The venue's what's-on page on myvue.com.
`chain`	string	Always vue.

Example

curl https://request.usestring.ai/v1/integrations/vue/cinemas \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "london",
    "limit": 3
  }'

data starts with these rows:

[
  {
    "cinemaId": "10031",
    "name": "London - Finchley Road (02 Centre)",
    "address": "O2 Centre, 255 Finchley Road",
    "city": "",
    "postcode": "",
    "country": "GB",
    "latitude": 51.54813782114732,
    "longitude": -0.181879480467445,
    "url": "https://www.myvue.com/cinema/finchley-road/whats-on",
    "chain": "vue"
  },
  {
    "cinemaId": "10046",
    "name": "London - Fulham Broadway",
    "address": "Fulham Broadway Retail Centre, Fulham Road",
    "city": "",
    "postcode": "",
    "country": "GB",
    "latitude": 51.48037878906572,
    "longitude": -0.194112517502636,
    "url": "https://www.myvue.com/cinema/fulham-broadway/whats-on",
    "chain": "vue"
  },
  {
    "cinemaId": "10032",
    "name": "London - Islington (Angel Central)",
    "address": "Angel Central, 36 Parkfield Street",
    "city": "",
    "postcode": "",
    "country": "GB",
    "latitude": 51.53434378540068,
    "longitude": -0.105967174056494,
    "url": "https://www.myvue.com/cinema/islington/whats-on",
    "chain": "vue"
  }
]

Requests and billing

Requests: 1–101 Web Access requests 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 Vue cinema's performances for a day: film, start time with UTC offset, format, features such as EPIC, Dolby Atmos, audio description or subtitles, screen, booking link, sold-out flag, certificate and running time. Give a cinema id from cinemas or a myvue.com cinema page URL, and optionally a film.

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

Input

Unknown fields are rejected.

Field	Type	Description
`cinemaId`	string	Required. A Vue cinema id from cinemas, such as 10032, or a myvue.com /cinema/<name>/ page URL. At least 1 character.
`date`	string	The day to list, YYYY-MM-DD. Defaults to today in the UK. Matches `^\d{4}-\d{2}-\d{2}$`.
`filmId`	string	Keep only this film: Vue's film id, such as HO00020288, or its myvue.com /film/<name> page URL.

Output

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

Field	Type	Description
`showtimeId`	string	<cinemaId>-<sessionId>, which seats takes.
`cinemaId`	string	—
`filmId`	string	Vue's film id.
`filmTitle`	string	—
`startTime`	string	RFC 3339, with the venue's UTC offset.
`format`	string	The projection format: 2D, 3D, IMAX, 4DX or ScreenX.
`attributes`	string[]	The performance's other features as Vue lists them, lower-cased, such as epic, dolby atmos, laser, audio described, subtitled or over 18s.
`screen`	string	The screen's name, such as Screen 4 or EPIC.
`bookingUrl`	string	The performance's booking page on myvue.com.
`soldOut`	boolean	—
`rating`	string \| null	The film's BBFC (or Irish IFCO) certificate, such as 12A; null when Vue shows none.
`runtimeMinutes`	integer \| null	null when Vue does not know the running time.

Example

curl https://request.usestring.ai/v1/integrations/vue/showtimes \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cinemaId": "10032",
    "date": "2026-10-31"
  }'

data starts with these rows:

[
  {
    "showtimeId": "10032-404763",
    "cinemaId": "10032",
    "filmId": "HO00020288",
    "filmTitle": "Clayface",
    "startTime": "2026-10-31T11:00:00+00:00",
    "format": "2D",
    "attributes": ["dolby atmos", "hdr by barco", "biggest screen", "epic", "single seat", "ultra lux and lux"],
    "screen": "EPIC",
    "bookingUrl": "https://www.myvue.com/book-tickets/summary/10032/HO00020288/404763",
    "soldOut": false,
    "rating": "18",
    "runtimeMinutes": 108
  },
  {
    "showtimeId": "10032-404660",
    "cinemaId": "10032",
    "filmId": "HO00020288",
    "filmTitle": "Clayface",
    "startTime": "2026-10-31T18:00:00+00:00",
    "format": "2D",
    "attributes": ["laser", "single seat"],
    "screen": "Screen 2",
    "bookingUrl": "https://www.myvue.com/book-tickets/summary/10032/HO00020288/404660",
    "soldOut": false,
    "rating": "18",
    "runtimeMinutes": 108
  },
  {
    "showtimeId": "10032-404736",
    "cinemaId": "10032",
    "filmId": "HO00020288",
    "filmTitle": "Clayface",
    "startTime": "2026-10-31T20:30:00+00:00",
    "format": "2D",
    "attributes": ["laser", "single seat", "ultra lux and lux"],
    "screen": "Screen 7",
    "bookingUrl": "https://www.myvue.com/book-tickets/summary/10032/HO00020288/404736",
    "soldOut": false,
    "rating": "18",
    "runtimeMinutes": 108
  }
]

Requests and billing

Requests: 1–2 Web Access requests 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.

`seats`

Read one Vue performance's seat map without starting a booking: every seat with its row, number, seating area, type (standard, premium, sofa, wheelchair, companion), status and the area's standard price. Give a showtime id from showtimes or the performance's myvue.com booking URL.

POST https://request.usestring.ai/v1/integrations/vue/seats

Input

Unknown fields are rejected.

Field	Type	Description
`showtimeId`	string	Required. A showtime id from showtimes, such as 10032-404763, or the performance's myvue.com /book-tickets/ URL. At least 1 character.

Output

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

Field	Type	Description
`showtimeId`	string	—
`seatId`	string	The seat's id in Vue's seat map: area category, area, row and column.
`row`	string	The row's label, such as A.
`number`	string	The seat's label within its row, such as 12, or WB1 for a wheelchair bay.
`area`	string	The seating area's name, such as Lux or Ultra Lux.
`type`	string	standard, premium (a large-seat area), sofa, wheelchair or companion.
`status`	string	available, sold, reserved (held by another booking in progress) or unavailable.
`price`	number \| null	The area's standard adult price, before Vue's online booking fee; null when the area shows none.
`currency`	string	The price's ISO currency code: GBP or EUR.

Example

curl https://request.usestring.ai/v1/integrations/vue/seats \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "showtimeId": "10032-404763"
  }'

data starts with these rows:

[
  {
    "showtimeId": "10032-404763",
    "seatId": "0000000013_001_007_021",
    "row": "A",
    "number": "1",
    "area": "Lux Super Saver",
    "type": "standard",
    "status": "available",
    "price": 12.99,
    "currency": "GBP"
  },
  {
    "showtimeId": "10032-404763",
    "seatId": "0000000013_001_007_020",
    "row": "A",
    "number": "2",
    "area": "Lux Super Saver",
    "type": "standard",
    "status": "available",
    "price": 12.99,
    "currency": "GBP"
  },
  {
    "showtimeId": "10032-404763",
    "seatId": "0000000013_001_007_019",
    "row": "A",
    "number": "3",
    "area": "Lux Super Saver",
    "type": "standard",
    "status": "available",
    "price": 12.99,
    "currency": "GBP"
  }
]

Requests and billing

Requests: 2 Web Access requests 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.

On this page