Search restaurants and check reservation availability on TableCheck. Use when: searching for restaurants by area/cuisine/date (Japan and Singapore), checking available time slots for a specific restaurant (global — any TableCheck restaurant worldwide), or finding direct booking URLs. Search supports keyword queries with geo-filtering. Availability checks work for any restaurant using TableCheck as their booking system, including outside Japan/Singapore (e.g., Sorn Bangkok).
Search restaurants and check reservation availability.
Discover restaurants in Japan or Singapore by keyword, location, cuisine, and date.
python scripts/tablecheck.py search "sushi ginza"
python scripts/tablecheck.py search "京都 フレンチ" --lat 35.0116 --lon 135.7681
python scripts/tablecheck.py search "ラーメン" --lat 35.6896 --lon 139.7003 --date 2026-04-01 --party 4
python scripts/tablecheck.py search "italian" --distance 5 --limit 5
python scripts/tablecheck.py search "chinese" --region singapore --lat 1.3521 --lon 103.8198
| Flag | Default | Description |
|---|
query | (required) | Keywords (Japanese or English) |
--lat/--lon | Tokyo Station | Center point for geo search |
--date | Tomorrow | Date (YYYY-MM-DD) |
--time | 19:00 | Preferred time (HH:MM) |
--party | 2 | Number of guests |
--region | japan | Region: japan or singapore |
--distance | 10 | Search radius in km |
--limit | 10 | Max results |
Each result includes: name_ja, name_en, slug, cuisines, budget_dinner_avg (JPY), budget_lunch_avg, distance_m, availability (time slots), tags, booking_url.
Fetches available time slots for any TableCheck restaurant worldwide using Playwright (headless browser). Works for restaurants in Japan, Singapore, Thailand, and anywhere else TableCheck is used as a reservation system.
python scripts/tablecheck.py availability sorn-fine-southern-cuisine --date 2026-04-01 --party 2
python scripts/tablecheck.py availability le-sputnik --date 2026-04-01 --party 2
The slug is the path segment from tablecheck.com/ja/shops/<slug>/reserve.
Returns: shop name, available_times list, and direct booking_url.
Requires Playwright with Chromium. If not installed locally, falls back to
uvx --with playwright.
| Area | Lat | Lon |
|---|---|---|
| Tokyo Station | 35.6812 | 139.7671 |
| Ginza | 35.6721 | 139.7649 |
| Roppongi | 35.6627 | 139.7325 |
| Shinjuku | 35.6896 | 139.7003 |
| Shibuya | 35.6580 | 139.7014 |
| Kyoto Station | 35.0116 | 135.7681 |
| Osaka Station | 34.7024 | 135.5023 |
| Sapporo Station | 43.0687 | 141.3508 |
| Fukuoka/Hakata | 33.5902 | 130.4207 |
| Naha (Okinawa) | 26.2124 | 127.6809 |
| Area | Lat | Lon |
|---|---|---|
| Orchard Road | 1.3048 | 103.8318 |
| Marina Bay | 1.2814 | 103.8585 |
| Clarke Quay | 1.2884 | 103.8465 |
| Chinatown | 1.2833 | 103.8432 |
The search API token is auto-fetched from TableCheck's frontend JS bundle and cached for 24h. If authentication fails, the script auto-refreshes the token and retries. No manual token management needed.
booking_url