API Reference
카카오맵 장소 상세
confirm_id로 카카오맵 장소의 상세 정보를 조회합니다.
카카오맵 장소 상세
confirm_id로 메뉴, 태그, 리뷰 수, 사진 수 등 장소 상세 정보를 반환합니다.
엔드포인트
GET /v1/kakaomap-place
Upstream
- Base URL:
https://place-api.map.kakao.com - Path:
[dynamic]
요청 파라미터
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
confirm_id | string | ✅ | - | 카카오맵 confirm_id |
요청 예시
{
"confirm_id": "18085497"
}응답 스키마
아래 스키마는 adapter의 Zod output schema에서 직접 생성됩니다.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"confirm_id": {
"type": "string"
},
"name": {
"type": "string"
},
"category": {
"type": "string"
},
"address": {
"type": "string"
},
"road_address": {
"type": "string"
},
"phone": {
"type": "string"
},
"homepage": {
"type": "string"
},
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"status": {
"type": "string"
},
"review_count": {
"type": "number"
},
"blog_review_count": {
"type": "number"
},
"photo_count": {
"type": "number"
},
"summary": {
"type": "string"
},
"menus": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"price": {
"type": "number"
},
"price_text": {
"type": "string"
},
"description": {
"type": "string"
},
"is_recommend": {
"type": "boolean"
}
},
"required": [
"name"
],
"additionalProperties": false
}
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"confirm_id",
"name",
"lat",
"lng",
"menus",
"tags"
],
"additionalProperties": false
}응답 예시
{
"data": {
"summary": {
"confirm_id": "18085497",
"name": "강남교자 본점",
"category": {
"name": "칼국수,만두"
},
"point": {
"lat": 37.498168,
"lon": 127.027636
},
"address": {
"disp": "서울 강남구 역삼동 820-11",
"road": "서울 강남구 강남대로96길 16"
},
"homepages": [
"https://gangnamgyojahouse.example.com"
],
"phone_numbers": [
{
"tel": "02-123-4567"
}
]
},
"my_store_notice": {
"status": "OPEN"
},
"blog_review": {
"review_count": 18
},
"photos": {
"counts": {
"total": 42
}
},
"menu": {
"menus": {
"items": [
{
"name": "칼국수",
"price": 11000,
"price_text": "11,000원",
"desc": "진한 사골 육수와 쫄깃한 면발",
"is_recommend": true
},
{
"name": "교자만두",
"price": 12000,
"price_text": "12,000원",
"desc": "육즙 가득한 대표 메뉴",
"is_recommend": false
}
]
}
},
"place_add_info": {
"tags": [
"#혼밥",
"#만두맛집",
"#주차가능"
]
},
"kakaomap_review": {
"score_set": {
"review_count": 127
}
}
},
"pagination": null,
"meta": {
"source": "kakaomap-place",
"fetchedAt": "2026-03-24T00:00:00.000Z"
}
}