For developers and AI agents
pickyourmatch answers accommodation requests with exact, directly bookable units: 1760 individually described units of 36 participating properties, each with its floor, view, beds and per-unit child and dog allowances, with live availability and the property’s own price for exact dates.
No key, no account, no sign-up. Every address here is public and read-only. You can call it now.
When to use pickyourmatch
- The guest wants one particular kind of accommodation — a view, a floor, a bed, a sauna, a balcony, a bathtub, step-free access — and wants to book exactly that.
- The party has needs that are set per unit: children with their ages, one or more dogs, an electric car to charge.
- The guest needs a stay near an event, a venue or a place on exact dates, with the live price.
- The guest wants to book directly with the property, at the property’s own price.
When not to use it
- A town where no participating property stands: pickyourmatch shows participating properties only, not every hotel of a place. The answer says so and names the nearest destinations.
- Flights, rental cars, activities or restaurants.
- Booking or paying on the guest’s behalf: pickyourmatch takes neither bookings nor payments. Its booking link opens the property’s own booking page with the unit and the dates filled in.
Ask in plain words (HTTP)
One address answers a request: GET https://pickyourmatch.com/ask. Markdown for an agent, JSON with format=json, a page for a browser.
curl "https://pickyourmatch.com/ask?q=apartment+with+a+sauna+for+2+adults+and+a+dog&check_in=2027-01-22&check_out=2027-01-24&format=json"
q: The request in the guest’s own words, in any languagecontext: What is known about the traveller: who travels, children’s ages, a dog, an electric car, the purpose of the tripcheck_in,check_out: Dates as YYYY-MM-DD, both or neither. Without dates the answer shows from-prices.adults,children_ages,pets: The party. Children by age, for example6,9.max_price: Highest price per night, in the property’s own currencycity,near,radius_km: The place, or a venue to stay nearunit: One unit as<property>:<code>: its live state plus alternativesformat,lang:md,jsonorhtml; the language of the answer:en,de,fr,es,it,nl,ar
The full description for a program: https://pickyourmatch.com/openapi.json (OpenAPI 3.1).
The answer names what was understood, the best matches and why each fits, alternatives and what differs, and a booking link per unit. Give the guest the booking link exactly as written: it opens the unit on the property’s own booking page with the dates filled in. Everything a listing states is what the guest is assigned — guaranteed.
The same question in NLWeb
For a caller that speaks NLWeb (v0.55): POST https://pickyourmatch.com/ask with the request in query.text. The answer is a list of typed items (schema.org Accommodation), each with its price, its source and a booking link; a stream of events when prefer.streaming is true.
curl -X POST "https://pickyourmatch.com/ask" -H "content-type: application/json" -d '{"query":{"text":"apartment with a sauna for 2 adults and a dog","check_in":"2027-01-22","check_out":"2027-01-24"},"prefer":{"mode":"list, summarize"}}'
MCP server
The same search as tools, for assistants that speak the Model Context Protocol: streamable HTTP, no authentication, read-only.
{
"mcpServers": {
"pickyourmatch": {
"type": "http",
"url": "https://pym-mcp.gauvendi.workers.dev/mcp"
}
}
}
Tools: search_stays, list_destinations, list_events, list_packages. Listed in the ChatGPT app directory, the Claude directory and the MCP Registry as com.pickyourmatch/stays. How people add it: AI connector guide.
Errors
An error says whose turn it is. JSON when JSON was asked for:
- 400
invalid_request: The request could not be read.problemsnames each parameter and how it should look. Correct it; do not repeat it. - 404
not_found: The address does not exist. - 503
temporarily_unavailable: The search failed just now. Come back after the seconds inRetry-After.
{
"error": {
"code": "invalid_request",
"message": "The request could not be read",
"problems": [
{
"parameter": "check_in",
"message": "check_in must be a date written YYYY-MM-DD, for example 2027-01-22"
}
],
"docs": "https://pickyourmatch.com/developers/"
}
}
Test calls
Send the header x-pym-test: 1. The call is answered like any other and is not counted as a real request. There is no separate test system because nothing can be written: no call changes a booking, a price or a property’s data.
curl -H "x-pym-test: 1" "https://pickyourmatch.com/ask?q=Schladming&format=json"
Fair use
No quota is published. A request with dates asks each property’s booking system live, so keep an answer for a few minutes instead of repeating the request, and do not poll.
Data files
- llms.txt: the index of destinations, properties and themes
- ai-inventory.json: every property and unit with its facts, rebuilt every night
- ai-catalog.json: everything an agent can call here, in one list
- auth.md: signing in (there is nothing to sign in to)