# pickyourmatch — for AI agents

Individually described, directly bookable accommodation products — each with its own features (view, floor, beds, bathroom, outdoors), its building and facilities, per-product dog and child allowances — from each participating property's own system, with live availability and the property's own price for exact dates. Booking happens on the property's own page; what the product states is what the guest is assigned, guaranteed.

## Ask in plain words
GET https://pickyourmatch.com/ask?q=<the guest's request>&format=md

**Context decides, not history.** Pass what you know about the traveller NOW in context=<free text>: who travels, children's ages, a dog, an electric car, a wheelchair, what the trip is for. It is used like the request itself, and nothing you send is stored (only a count per assistant). Show options first — most guests only know what they want when they see it.

Optional: check_in, check_out (YYYY-MM-DD), adults, children_ages (comma list), pets, max_price (per night), city, features (values from the dimensions below, comma list), free_cancellation=1, lang (en, de, fr, es, it, nl, ar), format=md|json.
- https://pickyourmatch.com/ask?unit=<property>:<code> — one product live, and what else fits
- https://pickyourmatch.com/ask?property=<property> — a property's best products

## Examples
- https://pickyourmatch.com/ask?format=md&q=a%20week%20in%20the%20mountains%20in%20March&context=family%20of%20four%2C%20children%206%20and%209%2C%20a%20labrador%2C%20we%20drive%20an%20electric%20car%2C%20budget%20about%20300%20a%20night
- https://pickyourmatch.com/ask?format=md&q=apartment%20in%20Schladming%20for%202%20adults%20and%202%20children%20(6%20and%209)%2C%2013%E2%80%9320%20March%2C%20under%20%E2%82%AC300%20a%20night
- https://pickyourmatch.com/ask?format=md&q=apartment%20with%20a%20sauna%20for%202%20adults%20and%20a%20dog&check_in=2026-12-11&check_out=2026-12-13
- https://pickyourmatch.com/ask?format=md&q=stay%20with%20EV%20charging%20in%20the%20Alps

## Any intent
A traveller rarely names features — they name a trip: a weekend with a spouse, a week with teenagers, a writing retreat. Pass that in q and context as it is. For common trips the answer already says each feature as its benefit ("2 Bathrooms — with teenagers, nobody waits for a free bathroom"). For any other intent, translate it into values of the dimensions below (features=Quiet room,Desk) and derive the benefit from the features each product lists.

The answer: what was understood, the best matches and why each fits, alternatives and what differs, the same products on other dates, extras worth offering, and booking links that open the exact product with the dates filled in.

## Feature dimensions — ask with these words
Every bookable product is described by the property itself in these dimensions (the number = products that have the value).
- **الإطلالة**: منظر الفناء (207), منظر الحديقة (330), عرض الشارع (141), منظر المدينة (103), منظر بانورامي (106), المنظور الأمامي (48), منظر طبيعي (44), عرض الجانب الخلفي (31), منظر معلمي (60), منظر القرية (24), منظر البحر (22), عرض إلى موقف السيارات (18), منظر الجبال (167), منظر شروق الشمس (73)
- **المساحات الخارجية**: شرفة (307), شُرفة (151), شرفة فرنسية (53), شرفة كبيرة (44), الشرفة العلوية (38), وصول إلى الحديقة (116), شواية (43), شرفة صغيرة (22), شرفة خاصة (18), طاولة الطعام (10), شرفة أو تراس (7), أثاث خارجي (258), لوجيا (52), حمام سباحة خاص (34)
- **التقسيم**: غرفة نوم مزدوجة (558), غرفة نوم واحدة (193), غرفة العائلة (76), غرفة نوم ثلاثية (105), تصميم موضوعي 11 (31), خالية من الحواجز (96), غرفة النوم في الزاوية (95), الغرف المجاورة لبعضها البعض (24), غرفة النوم (53), منطقة الدخول (42), شقة بثلاث غرف نوم (39), شقة بغرفة نوم واحدة (51), شقة (101), سقف عالي (32)
- **المساحة**: حجم M (436), حجم L (337), حجم - S (294), XL - حجم (140), مقاس متوسط/كبير - الحجم (152), مقاس S/M (209), XXL - حجم كبير جدا (44), XS - الحجم (43)
- **الأسرّة**: سرير مزدوج (698), سرير ملكي (327), سرير الأريكة (295), سرير الملك (344), أسرة توأم (65), سرير مفرد (159), سرير توأم أو مزدوج (92), سرير فرنسي (35), المفروشات الكبيرة (42), سرير أريكة فردي (39), أريكة سرير لشخصين (189), سرير بوكسبرينج (52), كرسي الأريكة (21), سرير مزدوج أو سرير كينغ (18)
- **الحمّام**: حمام داخلي (455), دش مفتوح (704), حوض الاستحمام (192), دش (326), حمام مع نافذة (185), حمام كبير (41), حمام إضافي (265), حوض مزدوج (71), حمام صغير (61), مرحاض إضافي (209), حمام خالٍ من العوائق (22), مرحاض منفصل (268), حمامان (146), دش الغابة المطيرة (51)
- **التجهيزات**: غرفة المعيشة (129), طاولة الطعام (93), مطبخ صغير (219), تصميم موضوعي 03 (120), ثلاجة (110), منطقة الجلوس (94), تكييف الهواء (71), تصميم موضوعي 06 (42), الكلاب مسموح بها (191), مكتب العمل (166), مطبخ (88), الأرضية الخشبية (71), تصميم موضوعي 08 (29), تلفزيون ذكي (332)
- **التجهيزات القياسية**: شبكة لاسلكية/واي فاي (1621), مستلزمات الحمام (1436), تلفزيون ذكي (1076), غرفة لغير المدخنين (675), كاشف الدخان (475), صندوق آمن (489), مرافق الشاي والقهوة (419), غلاية ماء (625), تكييف الهواء (419), مكتب العمل (464), ستارة الإطفاء (407), مرافق المطبخ (227), موقف سيارات (229), ثلاجة (216)
- **المرافق**: Self-catering (194), EV charging station for cars (140), Schladming (115), Gym (115), Bike wash area with repair tools (110), Panoramic view (107), Elevator / Lift (100), Pool (98), Sun terrace or lounge garden (95), Relaxation Room (90), Reception in building (90), Massage & Beauty Treatments (85), Herb garden (85), Close to the center of Schladming (79)
- **الموقع**: هادئ إضافي (291), قرب المصعد (103), الوصول بالسلم (85), بعيدا عن المصعد (95), قرب اللوبي (30), تواجه الشرق (26), الجانب الخلفي (59), الصف الأول (53), الصف الثاني (32), جنوب الواجهة (30), شمالي الوجه (16), قريب من السلالم (10), قريب من البلدة القديمة (157), قريب من الشاطئ (61)
- **الطابق**: الطابق الأرضي (223), الطابق العلوي (183), الطابق العالي (331), طابق منخفض (225), الطابق الثاني (149), الطابق الأول (122), الطابق الأوسط (83), الطابق الأرضي المرتفع (90), طابق الميزانين (13), الطابق الأرضي مع حديقة (22), الطابق الثالث (6), الطابق الأرضي السفلي (3), الطابق السفلي (3), طابق البنتهاوس (2)
- **نوع مكان الإقامة**: غرفة (803), شقة (649), استوديو (140), مكان إقامة (258), جناح (30), منزل عطلات (21), شاليه (17), فيلا (1)
- **ملف السفر**: مناسب للعائلات (1496), مناسب للكلاب (465), بدون عوائق (112)

## Feedback — we work with agents
GET https://pickyourmatch.com/ask/feedback?outcome=booked|shortlisted|not_suitable|no_match&missing=<what the guest wanted and did not find>&product=<property>:<code>&note=<anything that would have made the answer better>
No personal data, please. Every report is read and used to improve the answers.

MCP (for assistants that connect tools): https://pym-mcp.gauvendi.workers.dev/mcp — also in the ChatGPT and Claude directories.
