Picturehouse

Picturehouse Cinemas (picturehouses.com), the UK cinema chain: its cinemas, each cinema's showtimes for a day, and a showtime's seat map with live availability.

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: picturehouse
Version: 1.0.0
Reads from: picturehouses.com

Action	Description	Listed price
`cinemas`	List Picturehouse cinemas in the UK with their id, name, street address, city, postcode and coordinates, optionally filtered by text, postcode or place. Pass a cinemaId to showtimes for its programme.	Billed per request at your plan's rates
`showtimes`	List one Picturehouse cinema's showtimes for a day: film, start time with the UK offset, format (2D, 3D, 35mm, 70mm), labels such as subtitled or toddler time, screen, BBFC certificate, running time, sold-out flag and booking URL. Give a cinemaId from cinemas or the cinema's page URL; pass a showtimeId to seats for its seat map.	Billed per request at your plan's rates
`seats`	Read one Picturehouse showtime's seat map with each seat's live status: row, seat number, area, seat type (standard, wheelchair, companion) and whether it is available, sold, reserved or out of use. Give a showtimeId from showtimes or its booking URL. Reads only; it starts no booking and holds no seat. Prices are not listed, as Picturehouse quotes them only once a booking starts.	Billed per request at your plan's rates

`cinemas`

List Picturehouse cinemas in the UK with their id, name, street address, city, postcode and coordinates, optionally filtered by text, postcode or place. Pass a cinemaId to showtimes for its programme.

POST https://request.usestring.ai/v1/integrations/picturehouse/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 one, ignoring case and spaces, such as SW4 or SW4 0AT.
`location`	string	Keep cinemas whose city or address contains this place, ignoring case, such as London or Brighton.
`limit`	integer	The most cinemas to return; all that match when omitted. From 1 to 100.

Output

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

Field	Type	Description
`cinemaId`	string	The cinema's Picturehouse id, which showtimes takes.
`name`	string	The cinema's name.
`address`	string	The street address, without city or postcode.
`city`	string	The city or town; empty when the cinema's address gives none.
`postcode`	string	The UK postcode; empty when the cinema's address gives none.
`country`	string	ISO 3166-1 alpha-2 country code.
`latitude`	number \| null	Latitude in degrees.
`longitude`	number \| null	Longitude in degrees.
`url`	string	The cinema's page on picturehouses.com.
`chain`	string	The cinema chain, Picturehouse.

Example

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

data starts with these rows:

[
  {
    "cinemaId": "004",
    "name": "The Ritzy",
    "address": "Brixton Oval, Coldharbour Lane",
    "city": "London",
    "postcode": "SW2 1JG",
    "country": "GB",
    "latitude": 51.4613990783691,
    "longitude": -0.114799998700619,
    "url": "https://www.picturehouses.com/cinema/the-ritzy",
    "chain": "Picturehouse"
  },
  {
    "cinemaId": "009",
    "name": "East Dulwich",
    "address": "116A Lordship Lane",
    "city": "London",
    "postcode": "SE22 8HD",
    "country": "GB",
    "latitude": 51.4564018249512,
    "longitude": -0.0760999992489815,
    "url": "https://www.picturehouses.com/cinema/east-dulwich",
    "chain": "Picturehouse"
  },
  {
    "cinemaId": "010",
    "name": "Hackney Picturehouse",
    "address": "270 Mare Street",
    "city": "London",
    "postcode": "E8 1HE",
    "country": "GB",
    "latitude": 51.5447006225586,
    "longitude": -0.0548000000417232,
    "url": "https://www.picturehouses.com/cinema/hackney-picturehouse",
    "chain": "Picturehouse"
  }
]

Requests and billing

Requests: 1 Web Access request per call, plus up to 1 setup 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 Picturehouse cinema's showtimes for a day: film, start time with the UK offset, format (2D, 3D, 35mm, 70mm), labels such as subtitled or toddler time, screen, BBFC certificate, running time, sold-out flag and booking URL. Give a cinemaId from cinemas or the cinema's page URL; pass a showtimeId to seats for its seat map.

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

Input

Unknown fields are rejected.

Field	Type	Description
`cinemaId`	string	Required. A Picturehouse cinema id from the cinemas action, such as 020, or the cinema's picturehouses.com page URL. At least 1 character.
`date`	string	The day to list, YYYY-MM-DD; today in the UK when omitted. Matches `^\d{4}-\d{2}-\d{2}$`.
`filmId`	string	Keep only this film's showtimes, by the filmId a showtime row gives.

Output

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

Field	Type	Description
`showtimeId`	string	The showtime's id, which seats takes.
`cinemaId`	string	The cinema's Picturehouse id.
`filmId`	string	The film's Picturehouse id.
`filmTitle`	string	The film's title.
`startTime`	string	When the showtime starts, adverts and trailers included, RFC 3339 with the cinema's UTC offset.
`format`	string	The presentation: 2D, 3D, IMAX, 35mm or 70mm.
`attributes`	string[]	The showtime's other labels as Picturehouse names them, such as Subtitled, Toddler Time or Preview.
`screen`	string	The screen's name, such as Screen 2.
`bookingUrl`	string	The showtime's seat selection page on the booking site.
`soldOut`	boolean	Whether every seat is sold.
`rating`	string	The BBFC certificate, such as 12A; empty when the film has none.
`runtimeMinutes`	integer \| null	The film's running time in minutes.

Example

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

data starts with these rows:

[
  {
    "showtimeId": "020-81219",
    "cinemaId": "020",
    "filmId": "HO00018425",
    "filmTitle": "Shaun the Sheep: The Beast of Mossy Bottom",
    "startTime": "2026-11-01T10:45:00Z",
    "format": "2D",
    "attributes": [],
    "screen": "Screen 2",
    "bookingUrl": "https://web.picturehouses.com/order/showtimes/020-81219/seats",
    "soldOut": false,
    "rating": "U",
    "runtimeMinutes": 80
  },
  {
    "showtimeId": "020-81218",
    "cinemaId": "020",
    "filmId": "HO00017475",
    "filmTitle": "The Scarecrows' Wedding",
    "startTime": "2026-11-01T11:00:00Z",
    "format": "2D",
    "attributes": ["Toddler Time"],
    "screen": "Screen 1",
    "bookingUrl": "https://web.picturehouses.com/order/showtimes/020-81218/seats",
    "soldOut": false,
    "rating": "U",
    "runtimeMinutes": 26
  },
  {
    "showtimeId": "020-81224",
    "cinemaId": "020",
    "filmId": "HO00018417",
    "filmTitle": "Pressure",
    "startTime": "2026-11-01T11:20:00Z",
    "format": "2D",
    "attributes": [],
    "screen": "Screen 3",
    "bookingUrl": "https://web.picturehouses.com/order/showtimes/020-81224/seats",
    "soldOut": false,
    "rating": "12A",
    "runtimeMinutes": 100
  }
]

Requests and billing

Requests: 1 Web Access request per call, plus up to 1 setup 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.

`seats`

Read one Picturehouse showtime's seat map with each seat's live status: row, seat number, area, seat type (standard, wheelchair, companion) and whether it is available, sold, reserved or out of use. Give a showtimeId from showtimes or its booking URL. Reads only; it starts no booking and holds no seat. Prices are not listed, as Picturehouse quotes them only once a booking starts.

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

Input

Unknown fields are rejected.

Field	Type	Description
`showtimeId`	string	Required. A showtime id from the showtimes action, such as 020-80704, or its bookingUrl. At least 1 character.

Output

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

Field	Type	Description
`showtimeId`	string	The showtime's id.
`seatId`	string	The seat's id within the screen.
`row`	string	The row's label, such as K.
`number`	string	The seat's label within its row, such as 12.
`area`	string	The seating area, such as Standard or Premium.
`type`	string	The kind of seat: standard, wheelchair, companion, sofa, or the site's own name for another.
`status`	string	available, sold, reserved (held back by the cinema) or unavailable (out of use)

Example

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

data starts with these rows:

[
  {
    "showtimeId": "020-80704",
    "seatId": "1_1_1",
    "row": "K",
    "number": "1",
    "area": "Standard",
    "type": "standard",
    "status": "available"
  },
  {
    "showtimeId": "020-80704",
    "seatId": "1_1_2",
    "row": "K",
    "number": "2",
    "area": "Standard",
    "type": "standard",
    "status": "available"
  },
  {
    "showtimeId": "020-80704",
    "seatId": "1_1_3",
    "row": "K",
    "number": "3",
    "area": "Standard",
    "type": "standard",
    "status": "available"
  }
]

Requests and billing

Requests: 2 Web Access requests per call, plus up to 1 setup 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.

On this page