Service
Designated heritage of South Korea (national treasures, treasures, historic and scenic sites, natural monuments, intangible and folk heritage and the provincial designations) searched by name, type, region or date and read in full with photos, licences and audio narration, plus the month's heritage programmes, from the Korea Heritage Service's public registry.
100.00%30-day uptimeAvg response2226ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-heritage/get-heritage | Reads one designated heritage item in full by its heritage_id: classification, quantity, designation and cancellation dates, address, era, owner, manager, description, main photo and the photo gallery with KOGL licence terms. Use after a search returned a heritage_id and the caller wants the details. Do NOT use to find items (use search-heritage) or for narration (use get-heritage-narration). Returns the item's fields plus classification_path, designated_on, address, era, owner, description and images; an unknown id is NO_DATA. | |
| POST | /v1/korea-heritage/get-heritage-narration | Finds the audio narration (mp3) of one designated heritage item in Korean, English, Japanese or Chinese. Use when someone wants to listen to a guide about an item. Do NOT use for the written description (use get-heritage). Returns the item's name, the language and audio_url; null when the service lists no narration in that language. | |
| POST | /v1/korea-heritage/list-districts | Lists the districts of one region of South Korea with the codes search-heritage takes as district_code. Use when you need a district code, or want to see which districts a region has. Do NOT use to find heritage items; use search-heritage. Returns districts with code and name, including the 00 entry that means the whole region. | |
| POST | /v1/korea-heritage/list-heritage-images | Lists the photos of one designated heritage item with their captions and KOGL licence terms (which types allow commercial use or changes, and whether AI-generated). Use when the caller wants the gallery alone, or needs the licence of each photo before reusing it. Do NOT use to read the item's record (use get-heritage). Returns the item's name and images with sequence, image_url, caption, license, ai_generated, commercial_use_allowed and modification_allowed; an item without photos has an empty list. | |
| POST | /v1/korea-heritage/search-heritage | Finds designated heritage items in South Korea by name, designation type (national treasure, treasure, historic site, natural monument, intangible heritage, provincial designations...), region and district, designation year or last change date, active or cancelled. Use when someone names a heritage item or asks what a region or type has. Do NOT use to read one item in full (use get-heritage) or for programmes and events (use search-heritage-events). Returns heritage rows with heritage_id, name, designation type, region, district, manager, coordinates and last change, one page at a time with total_count and has_more. |
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.
| POST | /v1/korea-heritage/search-heritage-events | Lists the heritage programmes and events of one month in South Korea (night tours, living-heritage programmes, temple and Confucian-academy programmes, old-house stays, world-heritage events...), optionally one type or a title word. Use when someone asks what heritage events are on in a month. Do NOT use for the heritage items themselves (use search-heritage) or for past months, which the service no longer lists. Returns events with event_id, type, title, dates, schedule, venue, region, organizer, contact, audience, fee and link, sorted by start date, one page at a time with total_count and has_more. |