k-cinema-bridge
A JSON API providing Korean multiplex (Lotte Cinema, CGV, Megabox) box office and upcoming movie data, enriched with detailed information such as genre, director, and cast from KOBIS (Korean Film Council). Data is automatically refreshed daily at 00:00 UTC.
API Reference
- - Base URL: INLINECODE0
- All endpoints are accessible via
GET requests without authentication. - The
info field may be null, so always perform a null check before accessing it.
| Endpoint | Description |
|---|
| GET /api/boxoffice.json | Combined box office from all sources ({lotte, cgv, megabox}) |
| GET /api/boxoffice/{source}.json |
Box office by source (
BoxOfficeMovie[]) |
| GET /api/upcoming.json | Combined upcoming movies from all sources (
{lotte, cgv, megabox}) |
| GET /api/upcoming/{source}.json | Upcoming movies by source (
UpcomingMovie[]) |
Valid source values: lotte, cgv, INLINECODE11
Data Models
BoxOfficeMovie
CODEBLOCK0
UpcomingMovie
CODEBLOCK1
MovieInfo
CODEBLOCK2
Instructions
Recommending Popular Movies
When the user asks for movie recommendations or what's popular:
- 1. Fetch
GET {BASE_URL}/api/boxoffice.json to retrieve combined box office data from all sources. - Identify movies that appear across multiple sources with low rank values — lower rank means higher popularity.
- Present the top-ranked movies with their title, rating, and genre from
info.genres if available.
Announcing Upcoming Releases
When the user asks about upcoming or soon-to-be-released movies:
- 1. Fetch
GET {BASE_URL}/api/upcoming.json to retrieve combined upcoming movie data. - Filter results by
releaseDate (YYYY-MM-DD) to match the user's requested time range. - Provide details such as genre, directors, and actors from the
info field if available.
Searching by Genre, Director, or Actor
When the user asks about a specific genre, director, or actor:
- 1. Fetch both
GET {BASE_URL}/api/boxoffice.json and GET {BASE_URL}/api/upcoming.json. - Filter results using the
info field:
- Genre: match against
info.genres
- Director: match against
info.directors[].name
- Actor: match against
info.actors[].name
- 3. Always null-check the
info field before accessing nested properties.
Filtering by Audience Rating
When the user asks for age-appropriate movies:
- 1. Use the
rating field to filter. This field is always present and does not require the info field. - Known rating values: "전체 관람가" (All ages), "12세 관람가" (12+), "15세 관람가" (15+), "청소년 관람불가" (Adults only).
Querying a Specific Multiplex
When the user asks about a specific cinema chain:
- 1. Fetch
GET {BASE_URL}/api/boxoffice/{source}.json or GET {BASE_URL}/api/upcoming/{source}.json. - Valid source values:
lotte, cgv, megabox.
Comparing Across Multiplexes
When the user asks to compare rankings between cinema chains:
- 1. Fetch
GET {BASE_URL}/api/boxoffice.json to retrieve combined data. - Find movies with the same
title across different sources and compare their rank values.
Response Guidelines
- - Respond in the same language the user is using.
- When presenting movie lists, include title, rank or release date, rating, and genre when available.
- If
info is null for a movie, present only the base fields (title, rank, rating, posterUrl) without guessing missing details. - When comparing across multiplexes, use a table format for clarity.
k-cinema-bridge
一个提供韩国多厅影院（乐天影院、CGV、Megabox）票房和即将上映电影数据的JSON API，并包含来自KOBIS（韩国电影振兴委员会）的详细信息，如类型、导演和演员阵容。数据每天UTC时间00:00自动刷新。
API参考
- - 基础URL：https://uyeong.github.io/k-cinema-bridge
- 所有端点均可通过GET请求访问，无需认证。
- info字段可能为null，因此在访问前务必进行空值检查。
| 端点 | 描述 |
|---|
| GET /api/boxoffice.json | 所有来源的综合票房数据（{lotte, cgv, megabox}） |
| GET /api/boxoffice/{source}.json |
按来源查询票房数据（BoxOfficeMovie[]） |
| GET /api/upcoming.json | 所有来源的综合即将上映电影数据（{lotte, cgv, megabox}） |
| GET /api/upcoming/{source}.json | 按来源查询即将上映电影数据（UpcomingMovie[]） |
有效来源值：lotte、cgv、megabox
数据模型
BoxOfficeMovie
source: lotte | cgv | megabox
rank: number -- 票房排名（从1开始）
title: string -- 电影名称
rating: string -- 观众评级
posterUrl: string -- 海报图片URL
info?: MovieInfo -- KOBIS详细信息（可能为null）
UpcomingMovie
source: lotte | cgv | megabox
title: string -- 电影名称
rating: string -- 观众评级
posterUrl: string -- 海报图片URL
releaseDate: string -- 上映日期（YYYY-MM-DD，可能为空字符串）
info?: MovieInfo -- KOBIS详细信息（可能为null）
MovieInfo
code, title, englishTitle, originalTitle: string
runtime: string（分钟）
productionYear, openDate（YYYYMMDD）, productionStatus, type: string
nations: string[] -- 制作国家
genres: string[]
directors: {name, englishName}[]
actors: {name, englishName, role, roleEnglish}[]
showTypes: {group, name}[]
companies: {code, name, englishName, part}[]
audits: {number, grade}[]
staff: {name, englishName, role}[]
使用说明
推荐热门电影
当用户询问电影推荐或热门电影时：
- 1. 获取GET {BASE_URL}/api/boxoffice.json以检索所有来源的综合票房数据。
- 识别在多个来源中出现且排名值较低的电影——排名越低表示热度越高。
- 展示排名靠前的电影，包括名称、评级以及info.genres中的类型（如有）。
预告即将上映影片
当用户询问即将上映或即将发布的电影时：
- 1. 获取GET {BASE_URL}/api/upcoming.json以检索综合的即将上映电影数据。
- 根据releaseDate（YYYY-MM-DD）筛选结果，以匹配用户请求的时间范围。
- 提供详细信息，如info字段中的类型、导演和演员（如有）。
按类型、导演或演员搜索
当用户询问特定类型、导演或演员时：
- 1. 同时获取GET {BASEURL}/api/boxoffice.json和GET {BASEURL}/api/upcoming.json。
- 使用info字段筛选结果：
- 类型：匹配info.genres
- 导演：匹配info.directors[].name
- 演员：匹配info.actors[].name
- 3. 在访问嵌套属性前务必对info字段进行空值检查。
按观众评级筛选
当用户询问适龄电影时：
- 1. 使用rating字段进行筛选。该字段始终存在，无需依赖info字段。
- 已知评级值：전체 관람가（全年龄）、12세 관람가（12岁以上）、15세 관람가（15岁以上）、청소년 관람불가（仅限成人）。
查询特定影院
当用户询问特定影院连锁时：
- 1. 获取GET {BASEURL}/api/boxoffice/{source}.json或GET {BASEURL}/api/upcoming/{source}.json。
- 有效来源值：lotte、cgv、megabox。
跨影院比较
当用户要求比较不同影院连锁之间的排名时：
- 1. 获取GET {BASE_URL}/api/boxoffice.json以检索综合数据。
- 查找不同来源中具有相同title的电影，并比较它们的rank值。
响应指南
- - 使用用户使用的相同语言进行回复。
- 展示电影列表时，包括名称、排名或上映日期、评级以及类型（如有）。
- 如果某部电影的info为null，仅展示基本字段（名称、排名、评级、海报URL），不猜测缺失的详细信息。
- 跨影院比较时，使用表格格式以便清晰展示。
