Shortcut to body area
  • Published : 2025.08.25
  • Edicited : 2025.10.20
Retrieve Content List

API Overview

The content list API of the Visit Seoul API is a core service that systematically provides tourism information about Seoul.
This API allows you to search and retrieve a wide range of tourism content in Seoul, including attractions, restaurants, accommodations, shopping, and festivals, filtered by category, language, or keyword.

Request Method

HTTP Request
POST /api/v1/contents/list
Host: api-call.visitseoul.net
VISITSEOUL-API-KEY: [Your issued API key]
Accept: application/json;charset=UTF-8
cURL Example
curl -X 'POST' \
  'https://api-call.visitseoul.net/api/v1/contents/list' \
  -H 'Accept: application/json;charset=UTF-8' \
  -H 'VISITSEOUL-API-KEY: [Your issued API key]' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -d '{
  "com_ctgry_sn": "Cg1x6l1",
  "lang_code_id": "en",
  "keyword": "Exhibition",
  "sort_type": "latest",
  "page_no": 1
}'

The content list API can include the following parameters, all of which are optional.

Parameter Name,Type,Required,Default Value,Description
Parameter Name Type Required Default Value Description
com_ctgry_sn string Optional - Category serial number (e.g., "Cg1x6l1")
lang_code_id string Optional - Language code (e.g., "ko", "en", "ja", "zh")
keyword string Optional - Search keyword (e.g., "맛집" (restaurants), "명동" (Myeongdong))
sort_type string Optional "latest" Sort order ("latest": newest, "abc": alphabetical)
page_no integer Optional 1 Page number (starts from 1)

Response Structure

Successful Response (200)
{
  "data": [
    {
      "cid": "ENPnd5dx1",
      "lang_code_id": "en",
      "com_ctgry_sn": "Cg1x6l1",
      "cate_depth": [
        " Culture",
        "Cultural Facilities"
      ],
      "multi_lang_list": "ko:KOPsrn1p5,en:ENPsrn1p5,ja:JPPsrn1p5,zh-CN:CNPsrn1p5,zh-TW:TCPsrn1p5",
      "main_img": "https://image_path/image_file",
      "post_sj": "Yoojin Lee Solo Exhibition 《Microclimate Salon – A Dependent Solo Exhibition》",
      "sumry": "An experience that awakens the \"microclimate sense\" through encounters with small lifeforms\r\n",
      "creat_dt_text": "2025.05.26",
      "updt_dt_text": "2025.05.30"
    }
  ],
  "paging": {
    "page_no": 1,
    "page_size": 50,
    "total_count": 11
  },
  "result_code": 200,
  "result_message": "OK"
}
Response Field Descriptions
Field Name,Type,Description
Field Name Type Description
data array
cid string Content unique ID
lang_code_id string Language code
post_ty string Post type
com_ctgry_sn string Category serial number
cate_depth array Category path
multi_lang_list string Multilingual version list
main_img string Main image URL
post_sj string Content title
sumry string Content summary description
creat_dt_text string Creation date
updt_dt_text string Modification date
paging object Paging information
page_no integer Current page number
page_size integer Number of items per page
total_count integer Total number of search results
"
처음으로 이동