# 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.

## Merkmal-Dimensionen — mit diesen Worten fragen
Jedes buchbare Angebot beschreibt der Gastgeber selbst in diesen Dimensionen (die Zahl = Angebote mit diesem Wert).
- **Aussicht**: Blick zum Innenhof (186), Blick zum Garten (277), Sicht auf die Stadt (97), Sicht auf die Strasse (45), Panoramablick (104), Blick zur Rückseite (31), Vorderhaus Aussicht (28), Meerblick (22), Dorfblick (21), Blick in die Natur (20), Blick Richtung Parkplatz (18), Blick auf Berge (167), Sonnenaufgang (73), Blick auf die Seitenstrasse (42)
- **Außenbereich**: Balkon (304), Terrasse (146), Französischer Balkon (50), Dachterrasse (35), Großer Balkon (33), Grill (43), Kleiner Balkon (22), Esstisch draußen (10), Gartenmöbel (258), Loggia (52), Große Sonnenterrasse (31), Balkon/ Terrasse (5), Große Dachterrasse (5), Privater Balkon (4)
- **Raumaufteilung**: Doppelzimmer (554), Einzelzimmer (115), Apartment - 2 Schlafzimmer (115), Familien-Schlafzimmer (44), Maisonette (31), Eckzimmer (95), Barrierefrei (16), 3-Schlafzimmer-Apartment (39), Zimmer nebeneinander (20), Schlafzimmer (47), Eingangsbereich (41), Junior Suite (13), 1 Schlafzimmer Apartment (62), Hohe Decken (32)
- **Größe**: M - Zimmergröße (321), L- Zimmergröße (220), S - Zimmergröße (251), XL - Größe (103), M/L - Zimmergröße (127), S/M - Zimmergröße (163), XS-  Zimmergröße (43), XXL - Größe (28), M - Comfort (106), L-  Superior (100), S+  - Zimmergröße (46), S - Smart (35), XL - Deluxe (30), M/L -  Apartmentgröße (ca. 50 m²) (25)
- **Betten**: Doppelbett (630), Queen Bett (327), King Bett (404), Bettsofa (279), Zwei Einzelbetten (85), Einzelbett (159), Zwei Einzel- oder Doppelbett (74), Französisches Bett (35), Stockbett (52), Einzelschlafsofa (39), übergroßes BEinzelbett (41), Schlafsofa für zwei Personen (189), Recamiere (21), Sofabett (4)
- **Bad**: Bodentiefe Dusche (687), mit Badezimmer (419), Badewanne (192), Dusche (326), Badezimmer mit Fenster (185), Großes Bad (37), extra Badezimmer (255), Kleines Bad (50), Barrierefreies Badezimmer (22), Toilette separat (268), 2 Badezimmer (146), Doppelwaschbecken (58), Regenwald Dusche (51), Extra Toilette (42)
- **Ausstattung**: Wohnzimmer (129), Kitchenette (219), Kühlschrank (110), Sitzgelegenheit (94), Esstisch (82), Klimaanlage (71), Holzboden (71), Hunde erlaubt (183), Arbeitstisch (109), Mikrowelle (213), Teppichboden (93), Smart TV (162), Modernes Design (55), Küche (42)
- **Standardausstattung**: Wlan/Wifi (1462), Haartrockner (844), Nichtraucherzimmer (629), Annehmlichkeiten im Badezimmer (592), Smart TV (476), Rauchmelder (475), Wasserkocher (625), Klimaanlage (419), Safe (418), Tee- und Kaffee Zubehör (318), Verdunklungsvorhänge (407), TV (554), Arbeitstisch (331), Kühlschrank (216)
- **Einrichtungen**: 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)
- **Lage**: Besonders ruhig (273), In der Nähe vom Aufzug (103), Vom Aufzug entfernt (95), Zugang über Treppen (55), Nach Osten (26), zur Rückseite (59), In der Nähe der Lobby (28), Nach Süden (30), Nach Norden (16), In der Nähe der Treppe (10), Strandnah (61), Nach Westen (35), In der Nähe des Pools (24), Umgebung von Natur (21)
- **Etage**: Erdgeschoss (301), Oberstes Stockwerk (174), Höheres Stockwerk (327), Unteres Stockwerk (221), Mittleres Stockwerk (83), 1. Obergeschoss (77), 2. Obergeschoss (79), 2. Stock (63), Erster Stock (33), 1. Stock (16), Zwischengeschoss (13), 3. Stock (12), Souterrain (6), Gartengeschoss (22)
- **Unterkunftsart**: Zimmer (803), Apartment (649), Studio (140), Unterkunft (258), Suite (30), Ferienhaus (21), Chalet (17), Villa (1)
- **Reiseprofil**: Familienfreundlich (1496), Hundefreundlich (465), Barrierefrei (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.
