KTO TourAPI CLI

💡 Examples

Browse 관광지 in 강릉

bash scripts/area.sh --area-code 32 --sigungu-code 1 --content-type-id 12 --num 10

Find 음식점 within 500 m of 경복궁 (lng 126.9770, lat 37.5797)

bash scripts/nearby.sh --lng 126.9770 --lat 37.5797 --radius 500 --content-type-id 39

Festival list for May 2026 in Jeju

bash scripts/festival.sh --start 20260501 --end 20260531 --area-code 39

Keyword search for "한옥" stays

bash scripts/search.sh --keyword 한옥 --content-type-id 32 --num 30

Full record (with images) for 경복궁 (contentId 264432)

bash scripts/detail.sh --content-id 264432 --content-type-id 14 --include-images

Ten-day Korea festival calendar for content automation

START=$(date -u +%Y%m%d)
END=$(date -u -v+10d +%Y%m%d 2>/dev/null || date -u -d "+10 days" +%Y%m%d)
bash scripts/festival.sh --start "$START" --end "$END" --num 100 \
  | jq -r '[.title, .eventstartdate, .eventenddate, .addr1] | @tsv'

⚙️ Configuration

1. Register at (Korean OpenData portal, free, no business required). 2. Apply for "한국관광공사_국문 관광정보 서비스_GW" (TourAPI 4.0 / KorService2). Approval is automatic for the dev tier. 3. Copy your Decoding key (the raw, *not* URL-encoded form) and export:

   export TOURAPI_SERVICE_KEY='your_decoded_key_here'
   

4. Optional overrides:

   export TOURAPI_BASE='https://apis.data.go.kr/B551011/KorService2'
   export TOURAPI_MOBILE_OS='ETC'             # ETC|AND|IOS|WIN|WEB
   export TOURAPI_MOBILE_APP='your-app-name'  # any short identifier
   

5. Dependencies: bash, curl, jq (default on macOS / standard Linux).