Search places
search_placesSearch verified restaurants, cafes, bakeries and bars in Korea (HeyYumi's own cross-checked data), and beauty venues: hair salons, nail, lash and waxing shops, skin care. Use it when the user wants recommendations, a shortlist or a specific place to eat, drink or go out, or wants a haircut, nails, lashes, waxing or skin care ('머리 자르러 갈까'). WHERE: put the place in region_name as the user said it — 동/구/시, any station, nicknames (홍대·가로수길), landmarks, airports — in ONE call. Don't guess coordinates. An ambiguous admin name returns candidates: ask, then retry. With no location at all, ask for a neighborhood or station first. WHAT: keyword is only the dish or venue name. A NAMED VENUE: its name goes in keyword only — do NOT set business_category. ORDER: results are ranked by pick quality (meta.sort), not distance — present the top as your picks. One call with page_size 5–10 is enough for a shortlist; call get_place only when the user drills into one venue. FILTERS: use the structured filters (booleans take "true"). subtype = the kind of place (바·포차·삼겹살·국밥). MEAT-TYPE STEERING: for a meat (돼지 위주, 한우) add bbq_meat with subtype=korean_bbq — mixed 삼겹+한우 houses stay, beef-only houses drop; never keyword="돼지고기". NO KOREAN NEEDED: only when the user asks about language (English menu, staff who speak English, ordering without Korean), set foreigner_friendly="true" alone. Writing to you in another language is not that request — you already bridge the language. ONE KIND PER SEARCH: food and beauty never mix. For hair, nails, lashes, waxing or skin care set business_category (salon, nail, lash, waxing, esthetic, or beauty for all of them); without it you only get restaurants, cafes and bars. FOOD vs DRINKS: hungry / a meal / 야식·밥 먹을 곳 (no drinking mentioned) → business_category="restaurant"; without it late hours fill up with pubs. late_night_eatery and late_night include bars, so they don't mean food. TIME & BOOKING: any time or meal ('저녁 7시', '점심', '지금') goes in open_at. For booking intent also pass reservation_channel="yumi"; on 0 the server widens and sends meta.reservationFallback.note — relay it. META: follow meta.ignoredFilters[].hint; meta.ignoredFields = a field name we don't have. meta.softenedFilters (atmosphere is a PREFERENCE that only ranks) and meta.relaxedFilters (weak filters dropped on 0 results) → say which conditions weren't confirmed. BROAD / TRUNCATED: when meta.truncated is true or meta.total is large, show 2–3 picks and offer one refining axis (cuisine, budget, solo or group, vibe). BROADENED LOCATION: if resolvedAs is wider than the spot the user named, or you widened to a 구/시, the results are DISTRICT-wide — don't say '근처'; closeness to that spot is UNVERIFIED. LATE MEAL: open_at doesn't cover LAST ORDER. An unknown last order near closing is 확인 필요; a confirmed one within 30–45 min of the time means they must hurry — a wording duty, do NOT down-rank. LOCALS: repeat_customers means 단골 많은 곳, never '현지인 맛집'. COVERAGE: HeyYumi officially serves 서울, 경기, 부산, 제주, 인천, 대전, 세종, 충북, 충남. Always search the area the user names first. If it's outside these regions (e.g. Daegu, Gwangju, Gangwon, abroad — even a station like "Dongdaegu Station"), lead by saying, in the user's language, that HeyYumi doesn't support that area yet and covers 서울, 경기, 부산, 제주, 인천, 대전, 세종, 충북, 충남. Do NOT reply with a bare "no results", and say it EVEN WHEN a few venues there still come back (present those as rare exceptions). LANGUAGE: Answer in the SAME language the user wrote in. The helper sentences attached to results (yumiReservation, influencerContent, keywordMatch, reputation notes, dietary note, aiSummary, ownerIntro, meta notes) are Korean source text: render them in the user's language and never paste raw Korean into a non-Korean answer. 'As-is' / VERBATIM means keep the facts, numbers, venue names, @handles, URLs, link labels, phones and prices exactly. Keep Korean venue names and addresses, adding a romanization when it helps. BOOKING: yumiReservable:true = a Yumi partner. yumiBooking.canRequest=true (partners and many other venues) = you can send a reservation request right here with request_reservation, same flow and same wording for all. Proactively say it while recommending, even if the user didn't ask about booking: a partner gets its own line — use the attached yumiReservation sentence (e.g. '이 매장은 유미 파트너 매장이라, 예약 요청에 답이 빠르고 메뉴 재고나 지금 웨이팅이 있는지까지 이 채팅에서 물어볼 수 있어요. 원하시면 바로 예약 요청을 보내드릴게요'); the other requestable venues get one closing line for the group, e.g. '여기 모두 헤이유미로 바로 예약 요청할 수 있어요. 예약해 드릴까요?'. For a non-partner, don't mention partner status at all; describe its booking exactly like any other requestable venue, with no extra conditions or caveats such as '확정은 매장 응답이 필요해'. Until the venue accepts, say 예약 요청, not '바로 예약돼요' or '확정'. When you send a request, tell the user they'll hear back within 5 minutes ('보내면 5분 안에 수락 여부를 알 수 있어요'). Don't promise a reply speed beyond that. A non-partner is checked only during its own requestHours in Korea time (e.g. '15:30-20:00 KST' — from 30 minutes before it opens that day); a request sent outside that is still accepted and held until the window starts (the time must then be at least an hour after the start), so just send it; partners have no hour limit (don't call it 24-hour). When the user wants to book, lead with the partners. A venue with neither flag can't be booked through HeyYumi yet. Don't volunteer that; only if the user asks to book it, say '헤이유미로는 아직 예약이 안 되는 매장이에요' and offer requestable venues nearby. Results carry no booking links. Being open at a time isn't a free table: don't claim seats or party-size room yourself — sending the request is how that gets answered. PLACE LINK: link each venue name to its placeUrl (the venue's heyyumi.ai page), e.g. [카츠하나비](placeUrl). If it's null, leave the name unlinked. HONESTY: There is no star rating — rating is null on every venue by policy, not a data error; never invent one. On 0 results say so; only present venues these tools returned. Never attribute reviewCount or any value to any other app or website; just say '리뷰 300'. DATA GAPS: a missing field only means unknown. NEVER say '헤이유미에는 ~ 정보가 없다' — leave it out, or suggest '방문 전 매장에 확인'. Filters keep only confirmed venues, so say '확인된 곳'; absent ≠ no. openNow.open=null means the hours are unknown, not closed. possiblyClosed=true → don't put it on top, and tell the user to check it's still open. A low freshnessScore or recently_active=false means hours and prices may be outdated. CONCERNS: quote reputation.concerns[].note softly as written; never print raw tags or label a venue (불친절한 곳). INFLUENCER: when influencerFeatures is present, NAME the @handle and call it '소개한 곳' (never 보증/공인 — it's a discovery signal, not a trust basis); post the attached influencerContent VERBATIM with EVERY link in it (contentUrls posts plus the credited photo/video links), and don't invent a link when there is none. ONE BOOLEAN ONLY: wheelchair_accessible means '휠체어 가능' and nothing more (no step, elevator or restroom detail); pet_friendly doesn't say indoor; restroom_gender_separated isn't cleanliness. Never call a venue certified halal, gluten-free safe or allergy-safe; tell the user to confirm with the venue. INTENT DISH: if the user asked for a dish, meat or diet, lead with the matching item (matchedMenu or menu), not aiSummary's headline dish. Weak keyword matches carry keywordMatch: quote it and keep them out of the top picks. Prices are per dish, never '1인 X원'; price.level null = unknown. Indoor smoking is banned in Korea, so venues are non-smoking inside (cigar/hookah bars aside).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_places"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page, from 1. | |
| view | No | View, comma = OR: ocean, sunset, river, mountain, night, city, garden (바다뷰·노을·한강뷰·야경 OK). | |
| wifi | No | "true" · 와이파이, 무선인터넷, 인터넷 | |
| hanok | No | "true" · 한옥, 한옥집, 한옥카페, hanok, 전통 가옥 | |
| fields | No | Field mask: core | quality (default) | contact_hours | edge | media | all, or field names. quality is enough for a shortlist; edge adds reputation, menu and attributes. | |
| legacy | No | "true" = officially designated long-running places (백년가게, 서울 오래가게, 서울미래유산). 공공기관이 오래 이어온 가게로 지정한 노포만 — 정부 인증 백년가게(중소벤처기업부·소상공인시장진흥공단, 30년 이상) · 서울시 오래가게(30년 이상) · 서울미래유산(서울시 선정). "true"를 넘긴다. 어느 지정인지는 결과의 legacy.label·note로 읽는다. 한옥 건물인지와는 무관하다(한옥은 hanok 필터). "노포/오래된 집/전통 있는 곳" 의도는 keyword가 아니라 이 필터로 받는다 — keyword=노포는 상호·주소(노포동)·메뉴 문자열 오탐이 난다. 지정 사실만 확실하므로 개업연도·업력 같은 숫자는 지어내지 않는다(designatedYear는 지정된 해이지 개업한 해가 아니다). Use it for old / long-established / decades-old / old-school / "a local institution" in any language, never as a keyword (노포동 is an address). "traditional" usually means the cuisine, not age. designatedYear is NOT the year the shop opened, and hanok ≠ old. 백년가게 means 30+ years, never 100 years; never fabricate years. | |
| serves | No | What it serves: coffee, alcohol, dessert, vegetarian, vegan. Not a meal time — lunch/dinner/점심/저녁 go in open_at. | |
| dietary | No | vegan_options, vegetarian_options, fully_vegan, mixed_group_suitable, vegetarian_mixed_group_suitable, gluten_free (비건·vegan·채식·글루텐프리 OK). Vegan + non-vegan friends → mixed_group_suitable (a vegan MEAL, not just a drink); vegetarian (egg/dairy OK) + friends → vegetarian_mixed_group_suitable. gluten_free is owner-confirmed; if meta.dietaryCoverage is "insufficient" don't present venues as gluten-free, and always say cross-contamination must be confirmed with the venue. Peanut/nut allergy is not a searchable diet filter — never call a venue allergy-safe; tell the user to contact the venue in advance. | |
| dine_in | No | "true" · 매장식사, 먹고가기, 홀 | |
| exclude | No | Foods to exclude, comma-separated, any language ("돼지국밥 말고", "no <dish>"). 결과에서 뺄 음식/단어(콤마=여러 개, 전부 제외). "돼지국밥 말고/빼고" 같은 제외 의도를 받는다. 그 음식이 **상호 또는 대표메뉴**인 전문점만 뺀다 — 곁다리 메뉴로 한 줄 파는 곳은 남긴다(밀면 전문집이 돼지국밥도 판다고 빠지지 않게). 주소는 근거로 쓰지 않는다. local_food·keyword와 함께 "부산 향토음식인데 돼지국밥 말고"를 한 번에 받는다. meta.excluded로 실제로 뺀 항목을 되돌려주니 그대로 근거로 인용한다. Removes only venues whose NAME or signature menu has it; side items are kept. Don't fake it with subtype/category. Quote meta.excluded. | |
| keyword | No | Only the dish or venue name (drop 맛집/잘하는 곳); it matches name, address, menu and the venue's map category. With a keyword each result's `matchReason` says why: name / representative_menu / category = a specialist; menu / address = it just also sells it (`keywordMatch` explains — keep those out of the top picks). Cite `matchedMenu` (the exact menu item) and never invent a dish name. FOREIGN DISH NAMES (bibimbap, ビビンバ, 拌饭): pass them as-is in any language — the server maps them to the Korean menu or venue name and reports meta.keywordTranslated (source machine_translation = its own translation because nothing else matched; if the results don't fit, ask the user); don't translate into a lookalike yourself (곰국수 ≠ 고기국수); follow meta.keywordHint. English or romanized venue names work too; if an English brand finds nothing, retry its Korean spelling (Starbucks→스타벅스). meta.keywordFuzzy=true means similar names, not exact matches. | |
| omakase | No | "true" · 오마카세, omakase | |
| open_at | No | Open at a time (Korea time). Formats: 2026-08-26T19:00:00+09:00 | 2026-08-26 19:00 | 19:00 | now | lunch | 점심 | 11:00-14:00 | 2026-08-29 lunch | 내일 점심. Meal windows: breakfast (07:00-10:00), brunch (10:00-13:00), lunch (11:00-14:00), dinner (17:30-21:00), late_night (22:00-01:00); 점심/저녁/아침/브런치/야식 OK. POINT vs WINDOW: a clock time wins over a meal word — "저녁 7시" → "19:00", not "dinner" (a dinner window lets a place with last order 18:30 through). Use a window only when no hour is given. A meal time is never a keyword and never serves; openNow means "right now", so it is not a substitute. The server applies last order and break times and echoes meta.openAt (quote its window). FUTURE TIME vs openNow: for a later time, openNow still describes the present moment — NEVER say a venue is closed for the requested time based on openNow. It is the regular weekly schedule: say "그 시간에 영업해요", never "자리가 있어요". If meta.openAt.includedUnknownHours is true, those venues' hours are unconfirmed — say so. | |
| parking | No | "true" · 주차, 주차가능, 주차장 | |
| rooftop | No | "true" · 루프탑, 옥상, 루프탑바, rooftop, 옥상 테라스 | |
| subtype | No | Venue kind, comma = OR (Korean words OK, e.g. 칵테일바·포차·삼겹살·국밥): cocktail_bar, whisky_bar, wine_bar, bar_generic, izakaya, pocha, hof_beer, korean_pub, coffee, dessert, bakery, ice_cream, brunch, tea, traditional_tea, juice_fruit, themed, korean, korean_bbq, gopchang, jokbal_bossam, chicken, chinese, japanese, sushi_sashimi, western, italian, vietnamese, asian, noodles, bunsik, burger, gukbap_soup, jjigae, shabu, seafood, salad_healthy, sandwich_deli, lunchbox, buffet. Use this, not business_category, for a kind of place. izakaya/pocha/hof_beer are not "bars"; for a real bar use *_bar or real_bar=true. | |
| takeout | No | "true" · 포장, 테이크아웃, 투고 | |
| bbq_meat | No | Which meat a grill house serves, comma = OR: pork, beef, duck, lamb. Pair with subtype=korean_bbq. MIXED houses (삼겹+한우) match both pork and beef; beef-only houses drop out of pork. | |
| category | No | Legacy raw label match. Prefer subtype. | |
| catering | No | "true" · 케이터링, 출장뷔페, 단체주문 | |
| delivery | No | "true" · 배달, 딜리버리 | |
| real_bar | No | "true" · 바, 칵테일바, 위스키바, 와인바, 하이볼바, bar, 칵테일, 위스키 | |
| fireplace | No | "true" · 벽난로, 화롯불, fireplace | |
| page_size | No | Results per page (max 100). | |
| atmosphere | No | Mood: cozy, quiet, lively, spacious, view, trendy, traditional, clean, work_study, rainy_mood (조용한·아늑한 OK). PREFERENCE: it only ranks confirmed matches higher and never removes venues (echoed in meta.softenedFilters). | |
| board_game | No | "true" · 보드게임, 보드게임카페 | |
| craft_beer | No | "true" · 수제맥주, 크래프트비어, 브루펍 | |
| good_value | No | "true" · 가성비, 가성비 좋은, 저렴한, 싼, 착한가격, 착한가격업소, cheap, budget, affordable, good value, value for money | |
| high_chair | No | "true" · 아기의자, 유아의자, 하이체어 | |
| live_music | No | "true" · 라이브음악, 라이브공연, 라이브바, 라이브클럽, 공연, 버스킹, live music, live band | |
| local_food | No | A region's signature food — value "부산"/"Busan", or "true" with region_code. "그 지역다운 음식"(부산=돼지국밥·밀면·꼼장어, 제주=흑돼지·고기국수 …)을 파는 곳만. 값은 지역명("부산") 또는 region_code와 함께 "true". "부산다운 음식/향토음식/그 지역 대표 음식" 의도를 keyword로 음식 하나씩 치지 말고 이 필터로 한 번에 받는다(지역→대표 음식 목록으로 확장). 상호·메뉴에 그 음식이 있는 곳만 걸리고 주소는 근거로 쓰지 않는다. 서울에서 밀면 찾기처럼 그 지역다운 음식이 아니면 일반 keyword를 쓴다. meta.localFood로 적용한 지역·음식을 되돌려주니 그대로 근거로 인용한다. e.g. 서울(설렁탕·곰탕·육개장), 부산(돼지국밥·밀면·꼼장어), 대구(따로국밥·대구막창·뭉티기), 인천(짜장면·밴댕이회·물텀벙), 광주(오리탕·상추튀김·육전), 대전(두부두루치기·칼국수·도토리묵). Use it instead of typing dishes into keyword one by one; a dish outside its home region (밀면 in Seoul) goes in keyword. Quote meta.localFood as the basis. | |
| photo_spot | No | "true" · 인스타 감성, 포토스팟, 사진 명소, 감성 카페, 인스타, instagrammable, photo spot | |
| reservable | No | "true" · 예약, 예약가능, 예약되는 | |
| sports_bar | No | "true" · 스포츠바, 경기중계, 스크린, sports bar | |
| featured_by | No | FEATURED BY an influencer or channel (name or @handle, e.g. 성시경, 먹을텐데). 그 인플루언서/맛집 채널이 소개한 매장만. "성시경이 간 맛집", "먹을텐데 나온 집", "@sarah_logbook 소개"처럼 사람 이름·핸들·채널명으로 넘긴다(부분일치, 대소문자 무시). 서면 동의한 앰버서더의 소개(endorsement)만 검색한다. 하드 필터라 그 인플루언서가 없으면 0건 — 그때 meta.featuredBy.available로 "지금 있는 사람들"을 되돌려주니 그 사람을 제안한다. 매칭되면 meta.featuredBy.matched로 누구 소개인지 되돌려주니 "@X가 소개한 곳"으로만 인용한다("보증/추천/공인" 금지). Hard filter: on 0, suggest someone from meta.featuredBy.available. Cite meta.featuredBy.matched only as "@X가 소개한 곳", never endorsed. | |
| fine_dining | No | "true" · 파인다이닝, 파인 다이닝, 파인다이닝 레스토랑, fine dining, fine-dining, finedining, tasting menu, tasting course, degustation, 테이스팅 코스, 테이스팅 메뉴 | |
| region_code | No | Exact admin region code (from resolve_regions); wins over region_name. | |
| region_name | No | The place as the user said it: a 동/구/시 (a 구/시 searches the whole district), any subway station, a nickname (홍대·가로수길), a landmark or mall (더현대·코엑스), or an airport or bus terminal — pass an airport AS-IS ("제주공항"), never a 동 you guess is next to it. Romanized, Japanese and Chinese names work too ("Gangnam", "明洞", "ホンデ", "江南駅") — pass them as written, do not translate. Stations and landmarks come back with resolvedAs and distanceM. | |
| temple_food | No | "true" · 사찰음식, 템플푸드, temple food | |
| corkage_free | No | "true" · 콜키지 무료, 콜키지프리, 콜키지 프리, 주류반입 무료, corkage free | |
| english_menu | No | "true" · 영어 메뉴, 영어 메뉴판, 영문 메뉴, 외국어 메뉴, english menu | |
| natural_wine | No | "true" · 내추럴와인, 자연파와인, 내추럴 와인 | |
| no_kids_zone | No | "true" · 노키즈존, 노키즈 | |
| nursing_room | No | "true" · 모유수유, 수유실, 수유 가능, nursing room, breastfeeding | |
| parking_type | No | onsite, valet, partner, nearby, none | |
| pet_friendly | No | "true" · 반려동물, 강아지 동반, 애견, 펫 동반 | |
| private_room | No | "true" · 룸, 개별룸, 프라이빗룸, 룸 있는 | |
| smoking_area | No | "true" · 흡연구역, 흡연실, 흡연가능 | |
| floor_seating | No | "true" · 좌식, 다다미, 좌식테이블 | |
| has_promotion | No | "true" · 할인, 이벤트, 프로모션, 세일 | |
| inside_market | No | "true" · 시장안, 재래시장, 전통시장, 시장맛집 | |
| kids_friendly | No | "true" · 아이 동반, 키즈, 애들이랑, 아이랑 | |
| michelin_star | No | "true" · 미슐랭, 미쉐린, 미슐랭 스타, 미쉐린 스타, 미슐랭 레스토랑, 미쉐린 레스토랑, michelin, michelin star, michelin starred, michelin-starred, michelin guide, ミシュラン, ミシュラン星付き, 米其林, 米其林餐厅, 米其林餐廳, 米芝蓮, มิชลิน, Мишлен, ميشلان, मिशेलिन | |
| power_outlets | No | "true" · 콘센트, 충전, 노트북 충전, 코드 | |
| charcoal_grill | No | "true" · 숯불, 숯불구이, charcoal | |
| group_friendly | No | "true" · 단체, 단체석, 여럿이, 단체 수용 | |
| kids_play_area | No | "true" · 키즈존, 놀이방, 키즈룸, 키즈카페, 어린이 놀이공간, kids zone, kids play area | |
| local_favorite | No | "true" · 현지인 맛집, 로컬 맛집, 동네 맛집, 숨은 맛집, 단골 많은, local favorite, hidden gem | |
| max_dish_price | No | Budget in KRW: keep venues with a dish at or below this price (add-ons excluded). Not a per-person cost. For a meal add business_category=restaurant. For "가성비" without a number use good_value="true". | |
| min_confidence | No | Minimum trust score 0–1 (0.7 = high confidence). | |
| restroom_clean | No | "true" · 화장실 깨끗, 청결한 화장실 | |
| associated_with | No | ASSOCIATED WITH a celebrity, idol, drama or show (e.g. BTS, 손흥민, 도깨비). 연예인·아이돌·드라마/영화/예능과 연결됐다고 알려진 매장만. "BTS가 간 맛집", "정국이 갔다는 고깃집", "도깨비 나온 식당", "손흥민 단골집"처럼 사람·그룹·작품 이름이나 유튜버·인스타그래머 계정명으로 넘긴다(낱말 단위 일치, 대소문자 무시, 낱말 순서·띄어쓰기·하이픈·가운뎃점 차이는 무시. "Jensen"은 "Jensen Huang"에 걸린다). 이름은 손님이 쓴 언어 그대로 넘겨도 된다. 한글·영문 말고도 일본어·중국어(간체/번체)·태국어·러시아어 이름이 들어 있다(ジョングク, 朴彩英, จองกุก). 그 언어로 0건이면 영어 이름으로 한 번 더 찾는다. 그룹으로 물으면 그룹 이름 하나만 넘긴다(associated_with=ATEEZ). 멤버가 간 곳도 함께 나오니 멤버 이름을 하나씩 따로 찾지 않는다. 공개 보도된 사실을 우리 검증 매장에 붙인 것이다. 하드 필터라 그 대상이 없으면 0건 — 그때 meta.associatedWith.available로 "지금 있는 대상들"을 되돌려주니 그중 하나를 제안한다. 매칭되면 meta.associatedWith.matched로 무엇과 연결됐는지 되돌려준다. 응답의 culturalAssociations(summary·sourceUrls)를 그대로 인용하되 "~가 방문한 것으로 알려진"으로만 말하고 "보증/공인/맛집 인증"으로 단정하지 않는다. 오래된 연결이면 "그때 이야기라 지금은 다를 수 있다"를 덧붙인다. Hard filter: on 0, suggest from meta.associatedWith.available. Cite culturalAssociations only as "~가 방문한 것으로 알려진" (reportedly), never endorsed; old reports may be out of date. | |
| counter_seating | No | "true" · 카운터석, 다찌, 다찌석 | |
| muslim_friendly | No | "true" = venues known to welcome Muslim guests. 무슬림 손님을 받는다고 알려진 곳만("true"를 넘긴다). 상호·메뉴에 할랄/무슬림 표기가 있거나(자기 광고) 사장님이 앱에서 확인한 값(owner_verified). **공식 할랄 인증이 아니다** — 인증 여부·돼지고기 없는 주방·주류 취급은 항상 매장에 직접 확인하라고 안내한다(절대 "인증 할랄"로 단정 금지). "할랄/무슬림 프렌들리" 의도는 dietary=halal(무시됨)이 아니라 이 필터로 받는다. 돼지고기 없는 주방 등 세부는 serviceAttributes.halal(edge) 필드로 읽는다. 코셔는 아직 데이터가 없다(키워드 검색). Use it instead of dietary=halal. NOT a halal certification: never call it certified, and tell the user to confirm with the venue. | |
| outdoor_seating | No | "true" · 야외석, 테라스, 루프탑, 야외자리 | |
| payment_methods | No | ALL must match: cash, card, toss_pay, kakao_pay, naver_pay, zero_pay, local_gift, gov_support, alipay, wechat_pay, apple_pay, samsung_pay, unionpay. No "foreign card" field: apple_pay is the honest hint ("takes Apple Pay, so a card on Apple Pay should work; ask staff about a physical card"). If a method comes back in meta.ignoredFilters, don't present results as accepting it. | |
| recommended_for | No | Occasion: solo_dining, solo_drinking, date, group_dining, group_drinking, family, business_meeting, formal_gathering, late_night, late_night_eatery (회식·상견례·데이트 OK). For a room, use private_room=true. | |
| deposit_required | No | "true" · 예약금, 보증금 | |
| leftover_packing | No | "true" · 잔반포장, 남은거 포장, 싸주기 | |
| repeat_customers | No | "true" · 단골, 단골 많은, 재방문 많은 | |
| stroller_storage | No | "true" · 유모차, 유모차 보관 | |
| unlimited_refill | No | "true" · 무한리필, 무제한 | |
| waiting_expected | No | "true" · 웨이팅, 줄서는, 대기 있는 | |
| business_category | No | 업종 하나. 맛집은 restaurant(음식점)·cafe(카페)·bar(술집). 미용은 salon(미용실)·nail(네일샵)·esthetic(피부·체형관리)·lash(속눈썹)·waxing(왁싱), 묶음 값 beauty는 미용 전부. 운동은 gym(헬스장)·pilates(필라테스)·yoga(요가), 묶음 값 fitness는 운동 전부이고 헤이유미 제휴 매장만 나온다. 검색 한 번은 대분류 하나만 본다. 업종을 안 주면 keyword가 있어도 맛집만 나오니, 머리·네일·속눈썹·왁싱·피부관리를 찾을 땐 이 값을 꼭 넘긴다. 미용·운동 매장도 결과의 yumiBooking.canRequest가 true면 이 대화에서 예약을 요청할 수 있다. 결과가 0건이면 지도 앱 검색을 대신 지어내지 않는다. `bar` also includes izakaya/pocha/hof. For a kind of restaurant use subtype. Leave it out when looking up a named venue. | |
| corkage_available | No | "true" · 콜키지, 콜키지 가능, 콜키지 되는, 주류반입, 외부 주류 반입, 와인 반입, corkage | |
| foreign_languages | No | Staff languages (ISO 639-1), ALL must match: en, zh, ja, es, de, fr. | |
| foreigner_friendly | No | "true" · 한국말 몰라도, 한국어 몰라도, 외국인 친화, 외국인 가기 좋은, 영어 되는, english friendly, no korean needed, foreigner friendly | |
| traditional_liquor | No | "true" · 전통주, 막걸리, 우리술, 전통주바 | |
| reservation_channel | No | How it can be booked, comma = OR: yumi, phone. "yumi" = venues that take a reservation request right here (yumiBooking.canRequest — partners and non-partners). For booking intent pass "yumi"; on 0 the server widens and sets meta.reservationFallback — relay its note. NOT A DIRECTORY: pair it with a 동/구/station or a food. Listing or counting every bookable venue nationwide returns partner_scope_required; there are very many, so ask for an area or food instead. | |
| domestic_ingredients | No | "true" · 국내산, 국내산 재료, 국산, 국산 재료, 국내산 식재료, 우리농산물, 우리 농산물, domestic ingredients, locally sourced, korean ingredients | |
| include_unknown_hours | No | "true" with open_at to also keep venues whose hours are unknown (the server already does this once on 0 results). Say their hours are unconfirmed. | |
| wheelchair_accessible | No | "true" · 휠체어, 배리어프리, 장애인 접근 | |
| restroom_gender_separated | No | "true" · 남녀화장실분리, 화장실 분리 |