본문 영역으로 바로가기
  • 생성일 : 2025.08.25
  • 수정일 : 2025.10.20
콘텐츠 정보 조회

API 개요

비짓서울 API의 콘텐츠 정보 조회 API는 서울 관광 콘텐츠의 상세 정보를 제공하는 핵심 서비스입니다.
이 API는 콘텐츠 목록 조회 API와 함께 사용되어, 먼저 목록에서 관심 있는 콘텐츠를 찾은 후 해당 콘텐츠의 상세 정보를 조회하는 방식으로 활용됩니다.

요청 방법

HTTP 요청
GET /api/v1/contents/info
Host: api-call.visitseoul.net
VISITSEOUL-API-KEY: [발급받은 API 키]
Accept: application/json;charset=UTF-8
cURL 예시
curl -X 'POST' \
  'https://api-call.visitseoul.net/api/v1/contents/info' \
  -H 'Accept: application/json;charset=UTF-8' \
  -H 'VISITSEOUL-API-KEY: [발급받은 API 키]' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -d '{
     "cid": "KOPsrn1p5"
  }'

파라미터 : 콘텐츠 정보 조회 API는 콘텐츠 CID를 필수로 제공해야 합니다.

파라미터명,타입,필수여부,설명이 있는 파라미터
파라미터명 타입 필수여부 설명
cid string 필수 콘텐츠 일련번호 (예: "KOPsrn1p5")

응답 구조

성공 응답(200)
{
  "data": {
    "cid": "KOPsrn1p5",
    "lang_code_id": "ko",
    "com_ctgry_sn": "Cg1x6l1",
    "cate_depth": [
      " 문화관광 ",
      "전시시설"
    ],
    "multi_lang_list": "ko:KOPsrn1p5,en:ENPsrn1p5,ja:JPPsrn1p5,zh-CN:CNPsrn1p5,zh-TW:TCPsrn1p5",
    "main_img": "https://api.visitseoul.net/이미지경로/파일명",
    "relate_img": [
     "https://api.visitseoul.net/이미지경로/파일명",
     "https://api.visitseoul.net/이미지경로/파일명",
     "https://api.visitseoul.net/이미지경로/파일명"
    ],
    "post_sj": "서울 지하철 개통 50주년 기념 전시 <서울의 지하철>",
    "sumry": "서울역사박물관X서울교통공사 공동 개최 기획전시 <서울의 지하철>         ",
    "schdul_info_bgnde": "2024.08.09",
    "schdul_info_endde": "2024.11.03",
    "creat_dt_text": "2024.08.16",
    "updt_dt_text": "2024.10.30",
    "tag": [
      "서울역사박물관",
      "서울교통공사",
      "전시회",
      "무료전시",
      "광화문전시",
      "지하철",
      "대중교통"
    ],
    "extra": {
      "cmmn_telno": "02-724-0274",
      "cmmn_hmpg_url": "https://museum.seoul.go.kr/",
      "cmmn_use_time": "화요일 ~ 일요일 09:00~18:00 (입장마감 17:30) \r\n※매주 금요일 21:00까지 연장운영",
      "cmmn_important": "영어, 중국어, 일본어 해설 가능",
      "disabled_facility": [
        "장애인 전용 주차장",
        "접근가능",
        "엘리베이터",
        "장애인 안내(휠체어 대여 및 기타)",
        "장애인화장실"
      ],
      "closed_days": "공휴일을 제외한 매주 월요일, 1월 1일 \r\n※월요일이 휴일인 경우 정상개관 "
    },
    "traffic": {
      "adres": "서울 종로구 신문로2가 2-1",
      "new_zip_code": "03177",
      "new_adres": "서울 종로구 새문안로 55 (신문로2가, 서울역사박물관)",
      "map_position_x": "126.97107522045",
      "map_position_y": "37.5704968494713",
      "subway_info": "5호선 광화문역 7번 출구에서 약 462m (도보 7분)"
    },
    "tourist": {
      "guidance_service": "ul",
      "safe_mng": "ul"
    },
    "post_desc": "1974년 8월 15일 광복 29주년을 기념하는 날, 우리나라 최초의 지하철 '종로선'이 개통되었고, 그로부터 우리는 50년에 이르는 지하철 시대를 살아오고 있습니다. 서울을 오가는 사람이면 누구나 타봤을 서울 지하철은 우리를 정체 없이 학교와 직장으로 날라주는 편리한 대중교통수단임을 넘어서 '현대 생활의 새로운 시대'를 열어간 매개체였습니다. 우리 모두에게 처음이었던 지하철은 새 시대에 대한 경험을 함께 쌓으며 우리의 의식과 생활·문화 양식, 도시 모습을 서서히 바꿔나갔습니다. 지하철은 도시 노동자들을 실어 나르는 통근열차이자 누구나 쉽게 이동하고 약속시간을 지킬 수 있게 한 교통수단이었으며, 만남의 장소이자 소비공간이었습니다. 사람들이 부대끼는 사회적 공간으로 공동체 의식과 동시에 외로움을 키워간 곳이기도 했습니다. 나아가 도시공간과 생활권을 새롭게 재편하였으며, 어디서나 접할 수 있는 쾌적한 문화공간으로 사람들의 문화 향유를 확대하였습니다."
  },
  "result_code": 200,
  "result_message": "OK"
}
응답 필드 설명
필드명,타입,설명이 있는 응답 필드 설명
필드명 타입 설명
cid string 콘텐츠 고유 ID
lang_code_id string 현재 언어 코드
com_ctgry_sn string 카테고리 일련번호
cate_depth array 카테고리 경로
multi_lang_list string 다국어 버전 목록
relate_img array 관련 이미지 URL 목록
post_sj string 콘텐츠 제목
sumry string 콘텐츠 요약 설명
creat_dt_text string 생성일시
updt_dt_text string 수정일시
tag array 태그
extra object 상세 정보
cmmn_telno string 전화번호
cmmn_hmpg_url string 홈페이지 URL
cmmn_hmpg_lang array 홈페이지 운영 언어
cmmn_use_time string 이용시간
cmmn_important string 이것만은 꼭!
trrsrt_use_chrge string 이용요금 (F: 무료, C: 유료)
trrsrt_use_chrge_guidance string 이용요금 및 할인 안내
business_days string 영업일
closed_days string 휴무일
traffic object 교통 및 위치 정보
adres string 구 주소
adres2 string 상세 주소/건물명
new_zip_code string 우편번호
new_adres string 신 주소 (도로명 주소)
map_position_x string 지도 X 좌표 (경도)
map_position_y string 지도 Y 좌표 (위도)
subway_info string 지하철 교통 정보
post_desc string 콘텐츠 상세 설명 (HTML 형식)
"
처음으로 이동