Service
영화진흥위원회 영화관입장권통합전산망(KOBIS)의 일별·주간 박스오피스(매출액, 관객수, 스크린수, 상영횟수)와 영화·영화인·공통코드 데이터베이스를 조회합니다.
99.31%30일 가동률평균 응답776ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-box-office/get-daily-box-office | Reads the top-10 box office chart of South Korean cinemas for one calendar day, with each film's rank, rank change, ticket sales in won, sales share, audience, cumulative totals, screens and showings; optionally only Korean or foreign films, only independent (diversity) or commercial films, or one screening region. Use when someone asks what led the cinemas on a given day. Do NOT use for a whole week (use get-weekly-box-office), for today (the day is not aggregated yet) or for a film's details (use get-movie). Returns the date, currency, attribution and entries in rank order; an empty entries list means the day is not aggregated yet or no film matched the filters. | |
| POST | /v1/korea-box-office/get-movie | Reads one film from the Korean Film Council's registry by its movie_code: Korean, English and original titles, running time in minutes, production year, release date, type, production status, nations, genres, directors, cast with roles, staff with roles, companies with their roles, screening formats and ratings with certificate numbers. Use when someone wants everything about a film whose code came from search-movies or a box office chart. Do NOT use to find a film by name (use search-movies). Returns the film in full; an unknown code answers NO_DATA. | |
| POST | /v1/korea-box-office/get-weekly-box-office | Reads the top-10 box office chart of South Korean cinemas for the week containing a date: the whole week (Monday to Sunday), the weekend (Friday to Sunday, the default) or the weekdays (Monday to Thursday), with the same figures as the daily chart plus the period's dates and week number; optionally only Korean or foreign films, only independent or commercial films, or one region. Use when someone asks about a week's or weekend's leaders. Do NOT use for a single day (use get-daily-box-office) or for a period that has not ended yet, which answers NO_DATA. Returns the period, its first and last day, year, week, currency, attribution and entries in rank order. | |
| POST |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| /v1/korea-box-office/list-codes |
| Lists one of the Korean Film Council's code tables: screening regions (region_code of the box office operations), movie types (type_code of search-movies), nations (nation_code of search-movies) or company roles, each code with its Korean and, where given, English name. Use when you need a code for a filter or want to read what a code means. Do NOT use to find films or people. Returns the kind asked for and its codes in the registry's order. |
| POST | /v1/korea-box-office/search-movies | Searches the Korean Film Council's registry of every film released or registered in South Korea by title, director, release year range, production year range, representative nation code or movie type code, one page at a time; with no criteria it browses the whole registry. Use when someone names a film or asks what was released in a period. Do NOT use for box office figures (use the box office operations) or for a film's cast and staff (use get-movie with its movie_code). Returns movies with movie_code, Korean and English titles, production year, release date, type, production status, nations, genres, directors and companies, with total_count and has_more. |
| POST | /v1/korea-box-office/search-people | Searches the Korean Film Council's registry of directors, actors and crew by name or by a film title in their filmography, one page at a time; with no criteria it browses the whole registry. Use when someone asks about a film-maker or actor or who worked on a film. Do NOT use for a film's own credits (use get-movie). Returns people with people_code, Korean and English names, representative role and filmography titles, with total_count and has_more. |