# 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).
- **Uitzicht**: Binnenplaatszicht (186), Tuinzicht (301), Stadsview (97), Straatzeezicht (45), Panoramisch uitzicht (104), Achterzicht (31), Zeezicht (22), Bergzicht (177), Frontaal Uitzicht (22), Natuurzicht (20), Uitzicht op parkeerplaats (18), Parkzicht (16), Zonsopgang zicht (73), Zijstraataussicht (42)
- **Buiten**: Balkon (304), Voorterras (146), Frans balkon (50), Groot balkon (33), Dakterras (29), Grill (43), Klein balkon (22), Groot terras (12), Tuinmeubilair (258), Loggia (52), Privétuin (45), Balkon of terras (5), Groot dakterras (5), Privé Balkon (4)
- **Indeling**: Tweepersoonsslaapkamer (493), Eenpersoonsslaapkamer (107), 2-slaapkamer appartement (115), Maisonette (31), Hoekslaapkamer (73), 3-slaapkamer appartement (39), Kamers naast elkaar (20), Barrièrevrij (15), Slaapkamer (47), Appartement met 1 slaapkamer (44), Ingangsgebied (41), Familie en Vrienden (25), Appartement met 4 slaapkamers (33), Hoog plafond (32)
- **Grootte**: M - grootte (321), L - grootte (220), S - grootte (251), XL - formaat (103), M/L - grootte (127), S/M - grootte (163), XS - maat (43), XXL - formaat (28), M – Comfort maat (106), L – Superior maat (100), S+ - formaat (46), S – Smart maat (35), XL – Deluxe maat (30), M/L - formaat (~50 m²) (25)
- **Bedden**: Tweepersoonsbed (959), Slaapbank (283), Kingbed (344), Eenpersoonsbed (159), Twee aparte bedden (61), Twee eenpersoonsbedden of tweepersoonsbed (74), Stapelbed (52), Eenpersoons slaapbank (39), Overgrote eenpersoonsbed (41), Slaapbank voor twee (189), Twee eenpersoonsbedden (24), Recamière (21), Eenpersoonsbed of tweepersoonsbed (5), Twin queen bedden (61)
- **Badkamer**: Inloopdouche (707), Ensuite badkamer (419), Bad (186), Douche (318), Badkamer met raam (185), Grote badkamer (37), Dubbele wastafel (71), Extra toilet (209), Kleine badkamer (50), Apart toilet (268), 2 badkamers (146), Rolstoeltoegankelijke badkamer (18), Regenwouddouche (49), Extra badkamer (24)
- **Voorzieningen**: Woonkamer (129), Kitchenette (219), Zitgedeelte (94), Eettafel (82), Airconditioning (71), Koelkast (109), Honden toegestaan (183), Werkbureau (109), Houten vloer (57), Magnetron (213), Tapijtvloer (93), Smart TV (162), Fauteuil (46), Keuken (42)
- **Standaardvoorzieningen**: Wlan/Wifi (1391), Haardroger (844), Niet-roken kamer (629), Badkameraccessoires (592), Smart TV (476), Rookmelder (475), Kluis (489), Thee- en koffiefaciliteiten (318), Airconditioning (384), TV (554), Werkbureau (331), Verduisteringsgordijn (274), Waterkoker (232), Koelkast (216)
- **Faciliteiten**: 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)
- **Ligging**: Extra rustig (81), Dicht bij lift (103), Weg van de lift (95), Traptoegang (55), Dicht bij receptie (30), Oostwaarts gelegen (26), Achterzijde gericht (59), Zuid gericht (30), Noord gericht (16), Dicht bij de trap (10), Dicht bij strand (61), Westers gericht (35), Dicht bij zwembad (24), Dicht bij de natuur (21)
- **Verdieping**: Begane grond (301), Bovenste verdieping (174), Hoge verdieping (161), Lage verdieping (221), Eerste verdieping (110), Middelste verdieping (83), Tweede verdieping (79), 2e verdieping (63), 3e verdieping (20), Mezzanine (13), Hogere verdieping (166), Tuinniveau / tuinvloer (22), 1 verdieping (12), Benedenverdieping (7)
- **Type accommodatie**: Kamer (803), Appartement (649), Studio (140), Accommodatie (258), Suite (30), Vakantiehuis (21), Chalet (17), Villa (1)
- **Reisprofiel**: Gezinsvriendelijk (1496), Hondvriendelijk (465), Rolstoelvriendelijk (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.
