Also supports countries=HK (plural) - both work.

GET https://international-showtimes.p.rapidapi.com/v5/movies/{tmdb_id}/showtimes?countries=HK

Headers:

Note: The RapidAPI endpoints frequently return errors. Use the direct API instead.

Cinema Chain Booking URLs (fallback when API doesn't provide booking_link)

Chain	Booking URL
MCL Cinemas	https://www.mclcinema.com
Broadway Circuit	https://www.broadwaycinema.com.hk
Golden Harvest	https://www.goldenharvest.com
Emperor Cinemas	https://www.emperorcinemas.com
UA Cinemas	https://www.uacinemas.com.hk
Cinema City	https://www.cinemacity.com.hk
MOViE MOViE	https://www.pacificplace.com.hk/en/entertainment/cinema
Premiere Elements	https://www.premiereelements.com.hk
StagE	https://www.cinema.com.hk
Black Box	https://www.blackbox.com.hk

Display Rules

When user asks "what's playing in Hong Kong" or similar:

Call TMDB: GET /movie/now-playing?region=HK&language=zh-HK
Cache movie list with TMDB IDs
Show numbered list (Chinese title + English title from title and original_title fields)

Format:

香港上映中:

1. [電影中文名] ([英文名])
2. [電影中文名] ([英文名])
3. [電影中文名] ([英文名])
...

When user asks about a specific movie (e.g., "第一套詳細啲", "毒蛇律師2有咩上?"):

Display format:

[TITLE]

簡介: [overview]

上映戲院:
- [Cinema 1]
- [Cinema 2]
- ...

上映日期:
- [Date 1]
- [Date 2]
- ...

When user specifies a cinema OR date (e.g., "MCL", "聽日", "MCL聽日"):

Parse user input to identify:
- Cinema name (match against available cinemas)
- Date (parse relative dates: "今日", "聽日", "後日", or specific date)
Filter showtimes:
- If cinema specified: show only that cinema's showtimes
- If date specified: show only that date's showtimes
- If both: apply both filters
For each date, list all available times

Display format:

[Cinema Name] - [Movie Title]

[Date 1]: [Time 1] | [Time 2] | [Time 3]
[Date 2]: [Time 1] | [Time 2]
...

購票: [booking_link]

When user confirms a specific showtime (e.g., "聽日7點MCL", "我要買飛"):

Response format:

🎫 [Cinema Name] - [Date] [Time]

[booking_link]

[Open in browser]

If user says "book it" without details, ask which cinema and time they prefer.

From /movie/now-playing:

results[]: Array of movies
- id: TMDB movie ID
- title: Chinese title (zh-HK)
- original_title: Original/English title

From /movie/{id}:

From /movies/{tmdb_id}/showtimes:

Match user input against available cinema names (partial match OK):