API Reference
CatchTable 매장 상세
캐치테이블 shop_ref로 매장 상세 정보를 조회합니다.
CatchTable 매장 상세
shop_ref로 특정 매장의 이름, 주소, 평점, 이미지 등 상세 정보를 반환합니다.
엔드포인트
GET /v1/catchtable-shop
Upstream
- Base URL:
https://ct-api.catchtable.co.kr - Path:
[dynamic]
요청 파라미터
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
shop_ref | string | ✅ | - | Catchtable shop ref |
include_reviews | boolean | ❌ | false | - |
review_limit | integer | ❌ | 5 | - |
요청 예시
{
"shop_ref": "shop-1",
"include_reviews": false,
"review_limit": 5
}응답 스키마
아래 스키마는 adapter의 Zod output schema에서 직접 생성됩니다.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"shopRef": {
"type": "string"
},
"shopName": {
"type": "string"
},
"foodKind": {
"type": "string"
},
"address": {
"type": "string"
},
"phone": {
"type": "string"
},
"description": {
"type": "string"
},
"images": {
"type": "array",
"items": {
"type": "string"
}
},
"avgRating": {
"type": "number"
},
"reviewCount": {
"type": "number"
}
},
"required": [
"shopRef",
"shopName",
"foodKind",
"address",
"avgRating",
"reviewCount"
],
"additionalProperties": false
}응답 예시
{
"data": {
"shopRef": "shop-1",
"shopName": "스시 오마카세",
"foodKind": "일식",
"address": "서울 강남구 테헤란로 1",
"phone": "02-123-4567",
"description": "계절 코스 전문점",
"images": [
"https://image.example.com/1.jpg"
],
"avgRating": 4.8,
"reviewCount": 128
},
"pagination": null,
"meta": {
"source": "catchtable-shop",
"fetchedAt": "2026-03-24T00:00:00.000Z"
}
}