Cineworld

Cineworld's UK and Ireland cinemas, with address and coordinates; one cinema's showtimes on a day, with film, start time, format, attributes, screen, sold-out flag, certificate, runtime and booking link; and one performance's seat plan with live availability and price.

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

Action	Description	Listed price
`cinemas`	List Cineworld's cinemas in the UK and Ireland: id, name, street address, city, postcode, country, coordinates and page URL. Filter by text, postcode prefix or place name, and cap the count with limit.	Billed per request at your plan's rates
`showtimes`	List one Cineworld cinema's showtimes on a day: film id and title, start time with the UK offset, format (2D, 3D, IMAX, 4DX, ScreenX, Superscreen), attributes such as subtitled or audio described, screen, sold-out flag, certificate, runtime and booking link. Give a cinemaId from cinemas; the day defaults to today in the UK.	Billed per request at your plan's rates
`seats`	Read one Cineworld performance's seat plan with live availability: every seat's row, number, area, type (standard, wheelchair, companion, sofa) and status (available, sold, reserved, unavailable), with the area's adult ticket price in GBP. Read-only: it never starts a booking or holds a seat. Give a showtimeId from showtimes or its booking URL.	Billed per request at your plan's rates

`cinemas`

List Cineworld's cinemas in the UK and Ireland: id, name, street address, city, postcode, country, coordinates and page URL. Filter by text, postcode prefix or place name, and cap the count with limit.

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

Input

Unknown fields are rejected.

Field	Type	Description
`query`	string	Keeps cinemas whose name, address, city or postcode contains this text, ignoring case.
`postcode`	string	Keeps cinemas whose postcode starts with this, ignoring case and spaces, such as M1 or AB24 5EN.
`location`	string	Keeps cinemas whose city or name contains this place name, ignoring case, such as London.
`limit`	integer	The most cinemas to return; all that match when omitted. At least 0.

Output

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

Field	Type	Description
`cinemaId`	string	The cinema's id, which showtimes takes.
`name`	string	—
`address`	string	The street address lines, comma-separated.
`city`	string	—
`postcode`	string	—
`country`	string	ISO 3166-1 alpha-2 country code, read from the postcode: GB, IE (an Eircode) or JE (Jersey)
`latitude`	number \| null	—
`longitude`	number \| null	—
`url`	string	The cinema's page on web.cineworld.co.uk.
`chain`	string	—

Example

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

data starts with these rows:

[
  {
    "cinemaId": "077",
    "name": "Greenwich O2",
    "address": "The O2, Peninsula Square",
    "city": "Greenwich, London",
    "postcode": "SE10 0AX",
    "country": "GB",
    "latitude": 51.5033988952637,
    "longitude": 0.00490000005811453,
    "url": "https://web.cineworld.co.uk/sites/077",
    "chain": "Cineworld"
  },
  {
    "cinemaId": "103",
    "name": "Leicester Square",
    "address": "5-6 Leicester Square",
    "city": "London",
    "postcode": "WC2H 7NA",
    "country": "GB",
    "latitude": 51.5111999511719,
    "longitude": -0.129600003361702,
    "url": "https://web.cineworld.co.uk/sites/103",
    "chain": "Cineworld"
  },
  {
    "cinemaId": "066",
    "name": "Wandsworth",
    "address": "Southside Shopping Centre, Wandsworth High Street",
    "city": "London",
    "postcode": "SW18 4TF",
    "country": "GB",
    "latitude": 51.4541015625,
    "longitude": -0.192900002002716,
    "url": "https://web.cineworld.co.uk/sites/066",
    "chain": "Cineworld"
  }
]

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.

`showtimes`

List one Cineworld cinema's showtimes on a day: film id and title, start time with the UK offset, format (2D, 3D, IMAX, 4DX, ScreenX, Superscreen), attributes such as subtitled or audio described, screen, sold-out flag, certificate, runtime and booking link. Give a cinemaId from cinemas; the day defaults to today in the UK.

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

Input

Unknown fields are rejected.

Field	Type	Description
`cinemaId`	string	Required. A cinemaId from cinemas, such as 022, or the cinema's web.cineworld.co.uk/sites/ 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	Keeps only this film's showtimes, by the filmId a showtime row carries.

Output

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

Field	Type	Description
`showtimeId`	string	The performance's id, which seats takes.
`cinemaId`	string	—
`filmId`	string	—
`filmTitle`	string	—
`startTime`	string	When the performance starts, RFC 3339 with the cinema's UK offset.
`format`	string	The screen experience and projection: 2D, 3D, IMAX, IMAX 3D, 4DX, 4DX 3D, ScreenX, ScreenX 3D, Superscreen, Superscreen 3D or Infinity Vision.
`attributes`	string[]	The performance's other attributes in lower case, such as subtitled, audio described, laser projection or classic films.
`screen`	string \| null	The auditorium's name, such as Screen 5 or IMAX; null when the site lists none.
`bookingUrl`	string	The performance's seat selection page on web.cineworld.co.uk.
`soldOut`	boolean	Whether the site reports the performance sold out.
`rating`	string \| null	The film's certificate, such as 12A; null when the site has none.
`runtimeMinutes`	integer \| null	The film's running time; null when the site has none.

Example

curl https://request.usestring.ai/v1/integrations/cineworld/showtimes \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cinemaId": "022",
    "date": "2026-11-02"
  }'

data starts with these rows:

[
  {
    "showtimeId": "022-203585",
    "cinemaId": "022",
    "filmId": "HO00015517",
    "filmTitle": "Whalefall",
    "startTime": "2026-11-02T11:10:00+00:00",
    "format": "2D",
    "attributes": [],
    "screen": "Screen 5",
    "bookingUrl": "https://web.cineworld.co.uk/order/showtimes/022-203585/seats",
    "soldOut": false,
    "rating": "15",
    "runtimeMinutes": 106
  },
  {
    "showtimeId": "022-203605",
    "cinemaId": "022",
    "filmId": "HO00015169",
    "filmTitle": "Resident Evil (2026)",
    "startTime": "2026-11-02T11:10:00+00:00",
    "format": "2D",
    "attributes": [],
    "screen": "Screen 9",
    "bookingUrl": "https://web.cineworld.co.uk/order/showtimes/022-203605/seats",
    "soldOut": false,
    "rating": "15",
    "runtimeMinutes": 94
  },
  {
    "showtimeId": "022-202757",
    "cinemaId": "022",
    "filmId": "HO00015608",
    "filmTitle": "Wicker",
    "startTime": "2026-11-02T11:20:00+00:00",
    "format": "2D",
    "attributes": [],
    "screen": "Screen 4",
    "bookingUrl": "https://web.cineworld.co.uk/order/showtimes/022-202757/seats",
    "soldOut": false,
    "rating": "15",
    "runtimeMinutes": 105
  }
]

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.

`seats`

Read one Cineworld performance's seat plan with live availability: every seat's row, number, area, type (standard, wheelchair, companion, sofa) and status (available, sold, reserved, unavailable), with the area's adult ticket price in GBP. Read-only: it never starts a booking or holds a seat. Give a showtimeId from showtimes or its booking URL.

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

Input

Unknown fields are rejected.

Field	Type	Description
`showtimeId`	string	Required. A performance's showtimeId from showtimes, such as 022-203528, or its web.cineworld.co.uk/order/showtimes/ booking 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 the auditorium's seat plan.
`row`	string	The row's label, such as H.
`number`	string	The seat's label within its row.
`area`	string	The seating area's name, such as Standard or Superior.
`type`	string	standard, wheelchair, companion, sofa, or another kind in lower case.
`status`	string	available, sold, reserved (held back by the cinema) or unavailable (broken or blocked)
`price`	number \| null	The area's standard adult ticket price, tax included and booking fee excluded; null when the site lists none.
`currency`	string \| null	The price's ISO currency code; null with no price.

Example

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

data starts with these rows:

[
  {
    "showtimeId": "022-203585",
    "seatId": "1_1_1",
    "row": "K",
    "number": "34",
    "area": "Standard",
    "type": "standard",
    "status": "available",
    "price": 7.49,
    "currency": "GBP"
  },
  {
    "showtimeId": "022-203585",
    "seatId": "1_1_2",
    "row": "K",
    "number": "33",
    "area": "Standard",
    "type": "standard",
    "status": "available",
    "price": 7.49,
    "currency": "GBP"
  },
  {
    "showtimeId": "022-203585",
    "seatId": "1_1_3",
    "row": "K",
    "number": "32",
    "area": "Standard",
    "type": "standard",
    "status": "available",
    "price": 7.49,
    "currency": "GBP"
  },
  {
    "showtimeId": "022-203585",
    "seatId": "1_1_4",
    "row": "K",
    "number": "31",
    "area": "Standard",
    "type": "standard",
    "status": "available",
    "price": 7.49,
    "currency": "GBP"
  }
]

Requests and billing

Requests: 4 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