# 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).
- **View**: Courtyard view (186), Garden view (275), City view (97), Street View (45), Panoramic view (104), Backside view (31), Sea View (22), Mountain view (196), Front View (22), Nature view (20), View to Parking (18), Sunrise view (73), Side street View (42), Midday Sun (37)
- **Outdoors**: Balcony (324), Terrace (156), French balcony (50), Large balcony (33), Roof terrace (28), Small balcony (22), Loggia (60), Grill (32), Balcony or Terrace (9), Outdoor furnitures (255), Private Balcony (4), Shared garden/patio area (96), Herb bed (86), Heated Indoor Pool (63)
- **Layout**: Double Bedroom (495), Single bedroom (107), 2-bedroom apartment (121), Maisonette (31), 3-bedroom apartment (41), Corner bedroom (73), Rooms next to each other (20), Barrier free (15), Bedroom (47), Entrance area (41), Family and Friends (24), High ceiling (32), Family bedroom (19), Junior Suite (9)
- **Size**: M - size (327), L- size (226), S - size (257), XL - size (108), M/L - size (137), S/M - size (167), XS - size (43), XXL - size (34), M – Comfort Size (106), L – Superior Size (98), S+ - size (46), S – Smart Size (35), XL – Deluxe Size (29), M/L - size (~50 m²) (25)
- **Bedding**: Double bed (665), Queen bed (327), Sofa bed (284), King bed (344), Single bed (163), Twin beds (61), Twin or double bed (74), Bunk bed (59), French bed (35), Single Sofa Bed (37), Oversized single bed (41), Sofa bed for two (188), Recamiere (21), Sofa Bed (4)
- **Bathroom**: Walk-in shower (680), Ensuite bathroom (430), Bathtub (191), Shower (338), Bathroom with window (185), Large bathroom (37), Toilet separated (273), 2 Bathrooms (160), Double sink (62), Small bathroom (50), Extra toilet (42), 3 Bathrooms (27), Barrier-free bathroom (18), 1 Bathroom (226)
- **Amenities**: Living room (129), Kitchenette (219), Seating area (94), Dining table (82), Air condition (70), Fridge (107), Dogs allowed (189), Wooden floor (75), Working desk (109), Carpet floor (98), Microwave (210), Smart TV (159), Modern design (59), Kitchen (42)
- **Standard features**: Wlan/Wifi (1436), Hairdryer (893), Non-Smoking Room (678), Bathroom Amenities (641), Smart TV (526), Smoke detector (524), Safe (467), Tea & coffee facilities (368), Working desk (381), TV (549), Air condition (373), Water boiler (282), Blackout curtain (274), Wardrobe (225)
- **Facilities**: Self-catering (194), EV charging station for cars (140), Schladming district (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)
- **Location**: Extra quiet (82), Close to elevator (68), Away from elevator (95), Stair access (60), East facing (34), Backside facing (59), South facing (41), Close to lobby (28), North facing (17), West facing (49), Close to pool (25), Close to the stairs (10), Close to beach (60), Surrounded by nature (21)
- **Floor**: Ground floor (230), Top floor (173), High floor (161), Low floor (221), Middle floor (83), First floor (85), Second floor (89), 2nd floor (50), First Floor (33), Ground Floor (78), 2. Floor (13), Mezzanine floor (13), 3. Floor (12), Top Floor (8)
- **Space type**: Room (802), Apartment (647), Studio (152), Accommodation (307), Suite (30), Holiday home (20), Chalet (17), Villa (1)
- **Travel profile**: Family-friendly (1540), Dog-friendly (509), Barrier-free (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.