API Reference
카카오맵 장소 리뷰
카카오맵 장소의 리뷰를 페이지네이션으로 조회합니다.
카카오맵 장소 리뷰
카카오 리뷰와 블로그 리뷰를 통합하여 반환합니다.
엔드포인트
GET /v1/kakaomap-place-reviews
Upstream
- Base URL:
https://place-api.map.kakao.com - Path:
[dynamic]
요청 파라미터
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
confirm_id | string | ✅ | - | 카카오맵 confirm_id |
page | integer | ❌ | - | 페이지 |
include_blog | boolean | ❌ | - | 블로그 리뷰 포함 여부 |
요청 예시
{
"confirm_id": "18085497",
"page": 1,
"include_blog": true
}응답 스키마
아래 스키마는 adapter의 Zod output schema에서 직접 생성됩니다.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"reviews": {
"type": "array",
"items": {
"type": "object",
"properties": {
"author": {
"type": "string"
},
"rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"content": {
"type": "string"
},
"date": {
"type": "string"
}
},
"required": [
"author",
"rating",
"content",
"date"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
}
},
"required": [
"reviews",
"total"
],
"additionalProperties": false
}응답 예시
{
"data": {
"score_set": {
"review_count": 2
},
"reviews": [
{
"star_rating": 5,
"contents": "칼국수 국물이 진하고 만두가 정말 맛있어요.",
"registered_at": "2026-03-21T18:10:00+09:00",
"meta": {
"owner": {
"nickname": "미식가A"
}
}
},
{
"star_rating": 4,
"contents": "웨이팅이 있었지만 회전이 빨라 괜찮았습니다.",
"registered_at": "2026-03-20T12:40:00+09:00",
"meta": {
"owner": {
"nickname": "직장인B"
}
}
}
],
"blog_reviews": {
"review_count": 1,
"reviews": [
{
"title": "강남역 점심 추천",
"contents": "교자와 칼국수 조합이 훌륭했고 가성비도 좋았습니다.",
"author": "푸드블로거C",
"registered_at": "2026-03-19T09:00:00+09:00"
}
]
}
},
"pagination": null,
"meta": {
"source": "kakaomap-place-reviews",
"fetchedAt": "2026-03-24T00:00:00.000Z"
}
}