# 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).
- **Vue**: Vue sur la cour (207), Vue sur le jardin (299), Vue sur la ville (97), Vue sur la rue (77), Vue panoramique (106), Vue sur la nature (44), Vue arrière (31), Vue sur le parc (42), Vue de face (28), Vue sur le village (24), Vue sur la mer (22), Vue sur les montagnes (177), View to Parking (18), Vue sur le lever du soleil (73)
- **Extérieur**: Balcon (307), Terrasse (148), Terrasse sur le toit (38), Balcon français (50), Grand balcon (33), Barbecue (43), Petit balcon (22), Accès au jardin (20), Balcon privé (17), Balcon/Terrasse (7), Mobilier d'extérieur (258), Loggia (52), Piscine privée (34), Grande terrasse ensoleillée (31)
- **Agencement**: Chambre à coucher double (558), Chambre à coucher simple (115), Appartement de 2 pièces (110), Chambre familiale (49), Maisonette (31), Sans barrière (96), Chambre d'angle (95), Appartement de 3 chambres (39), Chambres situées les unes à côté des autres (20), Chambre à coucher (47), Zone d'entrée supplémentaire (41), Junior Suite (13), Appartement 1 chambre (63), Appartement de 2 chambres (32)
- **Taille**: Taille de la chambre (321), L- taille de la pièce (237), S - taille de la pièce (259), XL - taille (103), M/L - taille de la pièce (152), S/M - taille de la pièce (163), XS - taille de la pièce (43), XXL - taille (28), M - Comfort (106), L-  Superior (100), S+ - taille de la pièce (46), S - Smart (35), XL - Deluxe (30), XXL - Grand (15)
- **Literie**: Lit double (690), Lit Queen (327), Canapé-lit (290), Lit King (344), Lits jumeaux (85), Lit simple (168), Lit jumeau ou lit double (79), Lit français (35), Lit superposé (52), Canapé-lit simple (39), Literie surdimensionnée (41), Canapé-lit pour deux personnes (189), Recamiere (21), Lit double ou lit king (18)
- **Salle de bain**: Douche à l'italienne (704), salle de bain attenante (419), Baignoire (192), Douche (326), Salle de bain avec fenêtre (185), Grande salle de bains (41), évier double (71), salle de bain supplémentaire (255), Toilettes supplémentaires (209), Petite salle de bain (50), Salle de bain accessible (22), Toilettes séparées (268), 2 salles de bain (146), Douche de la forêt tropicale (51)
- **Équipements**: Salle de séjour (129), Kitchenette (219), Sièges (94), Table à manger (82), climatisation (71), bureau de travail (166), Réfrigérateur (109), Chiens autorisés (184), Plancher en bois (71), Micro-ondes (213), Tapis de sol (93), Smart TV (162), Fenêtres au ras du sol (59), Cuisine (42)
- **Équipements standard**: Wlan/WIFI (1621), Hairdryer (844), Chambre non-fumeurs (675), Équipements de salle de bains (592), Smart TV (476), Détecteur de fumée (475), Chaudière à eau (625), Installations pour le thé et le café (353), climatisation (419), Sécurité (418), bureau de travail (464), TV (554), Rideau occultant (274), Equipements de cuisine (227)
- **Équipements**: 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)
- **Emplacement**: très silencieux (273), Près de l'ascenseur (103), Loin de l'ascenseur (95), Accès aux escaliers (62), Près du lobby (30), Orienté vers l'est (26), Face arrière (59), Deuxième rangée (32), Exposition sud (30), Orientation nord (16), Proche des escaliers (10), Près de la vieille ville (157), Près de la plage (61), Orientation ouest (35)
- **Étage**: Rez-de-chaussée (223), Étage supérieur (167), Plancher haut (331), Plancher bas (225), Premier étage (110), Étage intermédiaire (83), 2ème étage (70), Mezzanine (103), Deuxième étage (79), Dernier étage (10), Rez-de-jardin (22), 1er étage (12), 3ème étage (8), Troisième étage (6)
- **Type d’hébergement**: Chambre (803), Appartement (649), Studio (140), Hébergement (258), Suite (30), Maison de vacances (21), Chalet (17), Villa (1)
- **Profil de voyage**: Adapté aux familles (1496), Chiens acceptés (465), Accessible PMR (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.
