# 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).
- **Vistas**: Vista del patio (207), Vista al jardín (299), Vista de la ciudad (97), Vista de la calle (83), Vista panorámica (106), Vista de la naturaleza (44), Vista trasera (31), Vista al mar (30), Vista frontal (28), Vista del pueblo (24), Vista del parque (35), View to Parking (18), Vista de la montaña (167), Vista del amanecer (73)
- **Exterior**: Balcón (307), Terraza (148), Terraza en el tejado (38), Balcón francés (50), Balcón grande (33), Parrilla (43), Balcón pequeño (22), Acceso al jardín (20), Balcón privado (17), Balcón/ Terrazza (7), Muebles de exterior (258), logia (52), Piscina privada (34), Mesa de comedor (9)
- **Distribución**: Dormitorio doble Dormitorio doble (558), Habitación individual (115), Apartamento de 2 dormitorios (105), Dormitorio familiar (49), Piso dúplex (31), Sin barreras (96), Dormitorio de esquina (95), Apartamento de 3 habitaciones (70), Apartamento de 1 dormitorio (63), Habitaciones contiguas (20), Dormitorio (47), Zona de entrada adicional (41), Apartamento de dos habitaciones (39), Junior Suite (13)
- **Tamaño**: M - tamaño de la habitación (330), L- tamaño de la habitación (237), S - tamaño de la habitación (259), XL - tamaño (103), M/L - tamaño de la habitación (152), S/M - tamaño de la habitación (163), XS - tamaño de la habitación (43), XXL - tamaño (28), M - Comfort (106), L-  Superior (100), S+  - tamaño de la habitación (46), S - Smart (35), XL - Deluxe (30), XXL - Grand (15)
- **Camas**: Cama de matrimonio (657), Cama doble (690), Sofá cama (290), Camas gemelas (85), Cama individual (168), Cama gemela o doble (79), Cama francesa (35), Litera (52), Sofá cama individual (39), Ropa de cama de gran tamaño (41), Sofá cama para dos personas (189), Recamiere (21), Cama doble o king (18), Dos camas queen size (61)
- **Baño**: Ducha de mano (687), baño en suite (419), Bañera (192), Ducha (326), Baño con ventana (185), Baño grande (41), fregadero doble (71), baño adicional (255), Baño adicional (209), Baño pequeño (50), Baño sin barreras (22), Aseo separado (268), 2 baños (146), Ducha de lluvia (51)
- **Equipamiento**: Sala de estar (129), Kitchenette (219), Zona de asientos (94), Mesa de comedor (82), aire acondicionado (71), Se admiten perros (218), escritorio de trabajo (166), Nevera (109), Suelo de madera (71), Microondas (213), Armario (100), Suelo de moqueta (93), Smart TV (162), Ventanas del suelo al techo (59)
- **Equipamiento estándar**: Wlan/WIFI (1621), Hairdryer (844), Habitación para no fumadores (675), Amenities de baño (592), Smart TV (476), detector de humo (475), Instalaciones de té y café (353), aire acondicionado (419), Seguro (418), escritorio de trabajo (464), Cortina de oscurecimiento (407), TV (554), Utensilios de cocina (227), Cocina totalmente equipada (480)
- **Instalaciones**: 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)
- **Ubicación**: extra silencioso (273), Cerca del ascensor (103), Lejos del ascensor (95), Acceso a la escalera (62), Cerca del vestíbulo (30), Orientación este (26), Orientación hacia atrás (59), Orientación sur (30), Orientación norte (16), Cerca de las escaleras (10), Cerca del casco antiguo (157), Cerca de la playa (61), Orientación oeste (35), Edificio principal (28)
- **Planta**: Planta baja (226), Planta superior (175), Piso alto (331), Piso bajo (225), Primera planta (110), Planta intermedia (83), 2ª planta (70), Segundo piso (79), Entreplanta (90), Entresuelo (13), Planta jardín (22), Primer piso (12), 3ª planta (8), Tercer piso (6)
- **Tipo de alojamiento**: Habitación (803), Apartamento (649), Estudio (140), Alojamiento (258), Suite (30), Casa vacacional (21), Chalet (17), Villa (1)
- **Perfil de viaje**: Ideal para familias (1496), Admite perros (465), Sin barreras (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.
