한국관광공사 관광콘텐츠랩 (TourAPI 국문 관광정보)

에이전트가 얻을 수 있는 정보

• title(제목), addr1/addr2(주소), mapx/mapy(좌표), firstimage/firstimage2(대표이미지), contentid/contenttypeid, tel, overview(개요, detail)
  키워드·지역·좌표 기반 관광지 검색, 여행코스·축제·숙박·맛집 후보 정리, 이미지·개요 포함 여행 콘텐츠 생성

활용 사례

• 키워드로 관광지·축제·숙박·음식점 검색
• 지역코드+분류로 관광 목록 조회
• 좌표 반경 내 주변 관광지 탐색
• 콘텐츠ID로 상세 개요·이미지·이용정보 조회

등록 API (4)

인증·비용·약관

에이전트 호출 방법

우리 프록시를 통해 호출합니다. 헤더 X-Agent-Token이 필요합니다. 토큰 발급은 /agencatalog/register/에서 신청 후 승인받습니다. 전체 서비스 목록은 /agencatalog/api/services.json을 참조하세요.

예시: POST /agencatalog/api/call {service:'kto-tour-content-lab', endpoint:'searchKeyword2', params:{keyword:'경복궁'}}

기계용 JSON 스키마

{
  "service": "kto-tour-content-lab",
  "name": "한국관광공사 관광콘텐츠랩 (TourAPI 국문 관광정보)",
  "provider": "한국관광공사",
  "apis": [
    {
      "id": "searchKeyword2",
      "name": "키워드 검색",
      "params": [
        {
          "name": "keyword",
          "required": true,
          "example": "경복궁",
          "desc": "검색 키워드 (1~50자)"
        },
        {
          "name": "contentTypeId",
          "required": false,
          "example": "12",
          "desc": "12 관광지/14 문화시설/15 축제공연행사/25 여행코스/28 레포츠/32 숙박/38 쇼핑/39 음식점"
        },
        {
          "name": "numOfRows",
          "required": false,
          "example": "10"
        },
        {
          "name": "pageNo",
          "required": false,
          "example": "1"
        }
      ]
    },
    {
      "id": "areaBasedList2",
      "name": "지역기반 목록",
      "params": [
        {
          "name": "areaCode",
          "required": true,
          "example": "1",
          "desc": "1 서울/2 인천/3 대전/4 대구/5 광주/6 부산/7 울산/8 세종/31 경기/32 강원/33 충북/34 충남/35 경북/36 경남/37 전북/38 전남/39 제주"
        },
        {
          "name": "contentTypeId",
          "required": false,
          "example": "15"
        },
        {
          "name": "numOfRows",
          "required": false,
          "example": "10"
        },
        {
          "name": "pageNo",
          "required": false,
          "example": "1"
        }
      ]
    },
    {
      "id": "locationBasedList2",
      "name": "위치기반 목록",
      "params": [
        {
          "name": "mapX",
          "required": true,
          "example": "126.98",
          "desc": "경도"
        },
        {
          "name": "mapY",
          "required": true,
          "example": "37.57",
          "desc": "위도"
        },
        {
          "name": "radius",
          "required": false,
          "example": "1000"
        },
        {
          "name": "contentTypeId",
          "required": false,
          "example": "12"
        }
      ]
    },
    {
      "id": "detailCommon2",
      "name": "공통 상세정보",
      "params": [
        {
          "name": "contentId",
          "required": true,
          "example": "126508",
          "desc": "콘텐츠ID (숫자)"
        }
      ]
    }
  ],
  "proxy_call": "POST /agencatalog/api/call",
  "attribution": "출처: 한국관광공사 국문 관광정보 서비스(TourAPI, 공공데이터포털 data.go.kr)"
}

이용 시 주의사항

마지막 확인: 2026-10-13