# 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).
- **Vista**: Vista sul cortile (207), Vista sul giardino (299), Vista della città (97), Vista della strada (83), Vista panoramica (106), Vista sulla natura (44), Vista posteriore (31), Vista frontale (28), Vista villaggio (24), Vista sul mare (22), Vista sulle montagne (177), Vista Parco (35), View to Parking (18), Vista dell'alba (73)
- **Esterno**: Balcone (307), Terrazza (148), Terrazza sul tetto (38), Balcone francese (50), Balcone grande (33), Barbecue (43), Balcone piccolo (22), Accesso al giardino (20), Balcone privato (17), Balcone/ Terrazza (7), Arredi da esterno (258), Loggia (52), Piscina privata (34), Ampia terrazza solarium (31)
- **Disposizione**: Camera da letto doppia (558), Camera singola (115), Appartamento con 2 camere da letto (127), Camera da letto per famiglie (49), Appartamento duplex (31), Senza barriere (96), Camera da letto d'angolo (95), Appartamento (77), Appartamento con 3 camere da letto (39), Camere una accanto all'altra (20), Camera da letto (47), Area d'ingresso extra (41), Junior Suite (13), Appartamento con 1 camera da letto (68)
- **Dimensioni**: M - dimensione della camera (330), L- dimensione della stanza (237), S - dimensione della stanza (259), XL - dimensione (103), M/L - dimensione della stanza (152), S/M - dimensione della camera (163), XS - dimensione della stanza (43), XXL - dimensione (28), M - Comfort (106), L-  Superior (100), S+  - dimensione della camera (46), S - Smart (35), XL - Deluxe (30), XXL - Grand (15)
- **Letti**: Letto matrimoniale (1310), Divano letto (290), Letto singolo (168), Letti gemelli (65), Letto doppio o matrimoniale (79), Letto francese (35), Letto a castello (52), Divano letto singolo (39), Biancheria da letto oversize (41), Divano letto per due (189), Recamiere (21), Letto matrimoniale o letto king (18), Letti queen size gemelli (61), Letto con pediera (35)
- **Bagno**: Doccia walk-in (704), bagno in camera (419), Vasca da bagno (192), Doccia (326), Bagno con finestra (185), Bagno grande (41), doppio lavandino (71), bagno extra (255), Toilette extra (209), Bagno piccolo (50), Bagno senza barriere (22), Servizi igienici separati (268), 2 bagni (146), Doccia Rainforest (51)
- **Dotazioni**: Soggiorno (129), Kitchenette (219), Posti a sedere (94), Tavolo da pranzo (82), aria condizionata (71), Cani ammessi (191), Frigorifero (109), Pavimento in legno (71), scrivania di lavoro (109), Microonde (213), Pavimento in moquette (93), Smart TV (162), Armadio (97), Finestre a tutta altezza (59)
- **Dotazioni standard**: Wlan/WIFI (1621), Hairdryer (844), Stanza non fumatori (675), Prodotti per il bagno (592), Smart TV (476), rilevatore di fumo (475), Caldaia ad acqua (625), Tè e caffè (353), aria condizionata (419), Sicuro (418), TV (554), scrivania di lavoro (331), Tenda oscurante (274), Accessori per la cucina (227)
- **Servizi**: 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)
- **Posizione**: extra silenzioso (260), Vicino all'ascensore (103), Lontano dall'ascensore (95), Accesso alle scale (62), Vicino alla lobby (30), Orientamento est (26), Affacciato sul retro (59), Esposizione a sud (30), Affaccio a nord (16), Vicino alle scale (10), Vicino al centro storico (157), Vicino alla spiaggia (61), Rivolto a ovest (35), Edificio principale (28)
- **Piano**: Piano terra (223), Ultimo piano (177), Piano alto (331), Piano basso (225), Primo piano (110), Piano intermedio (83), 2° piano (70), Secondo piano (79), Mezzanine (90), Piano ammezzato (13), Piano giardino (22), 1° piano (12), 3° piano (8), Terzo piano (6)
- **Tipo di alloggio**: Camera (803), Appartamento (649), Monolocale (140), Alloggio (258), Suite (30), Casa vacanze (21), Chalet (17), Villa (1)
- **Profilo di viaggio**: Per famiglie (1496), Cani ammessi (465), Senza barriere (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.
