ZeWelcome – URL Search Documentation (LLM & Developers)

This page explains how to generate a search URL https://zewelcome.com/en/rentals/search with GET parameters. It is designed for AI assistants (LLMs) and developers.

Available Parameters

Parameter	Type / Format	Required	Allowed values	Example
`checkin`	ISO date (YYYY-MM-DD)	✘	Future date	`2026-07-15`
`checkout`	ISO date (YYYY-MM-DD)	✘	Future date, after checkin	`2026-07-22`
`guests`	Integer	✘	1 → 20	`4`
`pool_private`	Boolean (int)	✘	`0` (no), `1` (yes)	`1`
`sort_by`	Enum	✘	`price_asc`, `position_asc`	`price_asc`

Examples (few-shots)

EN: Villa for 3 guests, from Nov 7 to Nov 23, 2023, with private pool, sorted by price ascending:

https://zewelcome.com/en/rentals/search?checkin=2023-11-07&checkout=2023-11-23&guests=3&pool_private=1&sort_by=price_asc

EN: Group of 8 guests, stay from Oct 10 to Oct 17, 2026, sorted by default:

https://zewelcome.com/en/rentals/search?checkin=2026-10-10&checkout=2026-10-17&guests=8&sort_by=position_asc

FR: Famille de 5 personnes, piscine privée, du 3 au 10 août 2026, tri par prix :

https://zewelcome.com/fr/rentals/search?checkin=2026-08-03&checkout=2026-08-10&guests=5&pool_private=1&sort_by=price_asc

Rules

Dates must always be future.
guests cannot exceed 20.
If no sorting is provided, use position_asc as default.

Machine-friendly specification (JSON)

{
  "endpoint": "https://zewelcome.com/en/rentals/search",
  "params": {
    "checkin":   { "type":"date", "format":"YYYY-MM-DD", "required":true },
    "checkout":  { "type":"date", "format":"YYYY-MM-DD", "required":true },
    "guests":    { "type":"integer", "min":1, "max":20, "required":true },
    "pool_private": { "type":"boolean-int", "allowed":["0","1"], "required":false, "default":"0" },
    "sort_by":   { "type":"enum", "allowed":["price_asc","position_asc"], "required":false, "default":"position_asc" }
  }
}

This documentation is provided to facilitate the use of ZeWelcome by AI assistants and external integrations.