VISIT SEOUL api

Published : 2025.08.26
Edicited : 2025.10.20

API Overview

Visit Seoul standard content is categorized using its own standard categories.
When retrieving the content list, you can specify a category code to retrieve the content in that category.
Since the category structure does not change frequently, it can be cached for over 24 hours for long-term use.

Request Method

HTTP Request

GET /api/v1/category/list
Host: api-call.visitseoul.net
VISITSEOUL-API-KEY: [Your issued API key]
Accept: application/json;charset=UTF-8

cURL Example

curl -X 'GET’ \
  'https://api-call.visitseoul.net/api/v1/category/list' \
  -H 'Accept: application/json;charset=UTF-8' \
  -H 'VISITSEOUL-API-KEY: [Your issued API key]'

Parameter: None (retrieves all category information)

Response Structure

Successful Response (200)

{
  "data": [
 {
      "com_ctgry_sn": "Ca0o2d4",
      "ctgry_nm": "Culture",
      "ctgry_path": " Culture",
      "ctgry_level": 1,
      "sort_no": 1
    },
    {
      "com_ctgry_sn": "Ce9z7g9",
      "ctgry_nm": "Parks",
      "ctgry_path": " Culture > Parks",
      "ctgry_level": 2,
      "sort_no": 1
    }
  ],
  "result_code": 200,
  "result_message": "OK"
}

Response Field Descriptions

Field Name,Type,Description
Field Name	Type	Description
com_ctgry_sn	string	Category unique code (used when querying content)
ctgry_nm	string	Category name
ctgry_path	string	Category path (displays hierarchical structure)
ctgry_level	integer	Category level (1: Top, 2: Sub, 3: Detail)
sort_no	integer	Sort order