Service
Daily and weekly box office charts of South Korean cinemas with sales, audience, screens and showings per film, plus the Korean Film Council's movie, people and code registries, from the Korea Box Office Information System (KOBIS).
98.48%30-day uptimeAvg response776ms
Selecting a row opens the reference for that 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. | |
Issue a sandbox key and make your first reservation.
APIFuse holds the partner credentials. You hold one managed key.
Receive events such as reservation confirmations and delivery updates.
Service outages and gateway errors normalise into one error model.
| /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. |