CatchTable APIapp.catchtable.co.kr ↗
Search Korean restaurants on CatchTable, check 14-day reservation availability, and retrieve menus, hours, and pricing via 3 structured endpoints.
What is the CatchTable API?
The CatchTable API gives developers access to restaurant data from app.catchtable.co.kr across 3 endpoints. Use search_restaurants to run keyword searches returning ratings, pricing, and a 14-day booking calendar per result, get_restaurant to pull full menu and facility details for a single venue, and get_availability to check which party sizes can be booked on each date within the next two weeks.
curl -X POST 'https://api.parse.bot/scraper/b37c6a63-ffec-4086-91ed-1c90e961da9c/search_restaurants' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"page": "1",
"size": "5",
"keyword": "스시"
}'Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace app-catchtable-co-kr-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: CatchTable SDK — bounded, re-runnable; every call capped."""
from parse_apis.app_catchtable_co_kr_api import CatchTable, RestaurantNotFound
client = CatchTable()
# Search for sushi restaurants — limit caps total items fetched.
for restaurant in client.restaurant_summaries.search(keyword="스시", limit=3):
print(restaurant.name, restaurant.area, restaurant.rating)
# Drill-down: take one hit, then navigate to full details via the summary.
hit = client.restaurant_summaries.search(keyword="스시", limit=1).first()
try:
full = hit.details()
print(full.name, full.address, full.phone)
except RestaurantNotFound as e:
print("not found:", e.shop_ref)
# Check availability for that restaurant.
for slot in full.availability.list(limit=3):
print(slot.date, slot.available_status, slot.available_person_counts)
print("exercised: restaurant_summaries.search / details / availability.list")
Full-text search for restaurants by name or cuisine keyword. Results include basic info, pricing, ratings, and a 14-day reservation availability calendar per restaurant. Each result carries the restaurant's booking page URL. Results are auto-iterated across pages.
| Param | Type | Description |
|---|---|---|
| area | string | Optional area/region filter tag. Values are site-defined region codes from CatchTable's filter system. |
| page | integer | Page number (1-based). |
| size | integer | Number of results per page (max 30). |
| keywordrequired | string | Search keyword — restaurant name, cuisine type, or food name (Korean text, e.g. '스시', '파스타', '강남'). |
{
"type": "object",
"fields": {
"page": "integer",
"size": "integer",
"has_more": "boolean",
"restaurants": "array of restaurant summaries with availability",
"total_count": "integer"
},
"sample": {
"data": {
"page": 1,
"size": 5,
"has_more": true,
"restaurants": [
{
"area": "부산 마린시티",
"name": "스시이마",
"rating": 5,
"latitude": 35.15934,
"shop_ref": "gXfFct9_aZJWLaqiB8isdQ",
"food_kind": "스시오마카세",
"longitude": 129.1442096,
"url_alias": "sushiima",
"booking_url": "https://app.catchtable.co.kr/ct/shop/sushiima",
"review_count": 504,
"max_party_size": 8,
"min_party_size": 1,
"lunch_price_text": "",
"operation_status": "BEFORE_OPEN",
"dinner_price_text": "저녁 21만원",
"daily_availability": [
{
"date": "2026-07-16",
"available_status": "AVAILABLE",
"available_person_counts": [
1,
2,
3
]
}
],
"operation_end_time": "21:00",
"operation_start_time": "18:00"
}
],
"total_count": 1345
},
"status": "success"
}
}About the CatchTable API
Search and Discovery
The search_restaurants endpoint accepts a required keyword parameter — restaurant name, cuisine type, or dish name in Korean (e.g. 스시, 파스타) — and an optional area filter using CatchTable's region codes. Results are paginated (up to 30 per page via the size param) and include total_count, has_more, and an array of restaurant summaries. Each summary already embeds a 14-day availability snapshot alongside basic fields like rating, food kind, and a direct booking page URL.
Restaurant Detail
Once you have a shop_ref from search results, get_restaurant returns the full profile: name, name_en, address, latitude, phone, rating, food_kind, area, and an array of menus objects each carrying name, price, and description. This is the right endpoint to power venue detail pages or to build a local menu index.
Availability Checking
get_availability takes the same shop_ref and returns a daily_slots array covering 14 days. Each day carries a status — one of AVAILABLE, CLOSED, DAY_OFF, AFTER_DEADLINE, or PHONE_INQUIRY — plus the party sizes bookable on that date. The response also includes booking_url so you can link users directly to CatchTable's reservation flow. This endpoint is useful for filtering search results to venues that actually have open slots before surfacing them to end users.
The CatchTable API is a managed, monitored endpoint for app.catchtable.co.kr — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when app.catchtable.co.kr changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official app.catchtable.co.kr API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a restaurant discovery app filtered by cuisine keyword and Seoul district using
areaandkeywordparams - Display real-time 14-day booking calendars on a travel itinerary platform using
get_availability - Aggregate menu data and pricing across Korean fine-dining venues using the
menusarray fromget_restaurant - Alert users when a previously full restaurant opens availability by polling
daily_slotsstatuses - Enrich a maps or geo app with restaurant ratings, addresses, and latitude coordinates from
get_restaurant - Filter search results to only AVAILABLE dates before displaying venues, reducing dead-end reservations for users
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does CatchTable have an official public developer API?+
What availability statuses does `get_availability` return, and what do they mean?+
daily_slots entries carry one of five statuses: AVAILABLE means the date has open bookable slots; CLOSED means the restaurant is not open that day; DAY_OFF is a designated rest day; AFTER_DEADLINE means the booking cutoff has passed; and PHONE_INQUIRY means reservations for that date must be made by phone rather than online.Does the API return user reviews or individual review text?+
rating values per restaurant but does not return individual review text, review counts, or reviewer profiles. You can fork this API on Parse and revise it to add a reviews endpoint if that data is needed.Is coverage limited to restaurants in South Korea?+
keyword parameter expects Korean text for reliable results, and area values correspond to CatchTable's Korean regional filter tags.Can I retrieve time-slot-level availability (specific reservation times within a day)?+
get_availability returns date-level data — available dates and bookable party sizes per day — but does not break down individual time slots within a day. You can fork this API on Parse and revise it to add a time-slot endpoint for finer-grained scheduling data.