Documentation recherche ZeWelcome (pour LLM & développeurs)

Cette page décrit comment générer une URL de recherche https://zewelcome.com/fr/rentals/search avec des paramètres GET. Elle est destinée aux assistants IA (LLM) et aux développeurs.

Paramètres disponibles

Paramètre Type / Format Requis Valeurs possibles Exemple
checkin Date ISO (YYYY-MM-DD) ✘ Date future 2026-07-15
checkout Date ISO (YYYY-MM-DD) ✘ Date future, après checkin 2026-07-22
guests Entier ✘ 1 → 20 4
pool_private Booléen (int) ✘ 0 (non), 1 (oui) 1
sort_by Enum ✘ price_asc, position_asc price_asc

Exemples (few-shots)

FR : Villa pour 3 personnes, du 7 au 23 novembre 2023, avec piscine privée, tri par prix croissant :

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

FR : Groupe de 8 personnes, séjour du 10 au 17 octobre 2026, tri par défaut :

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

EN : Family of 5, private pool, from August 3 to 10, 2026, sorted by price:

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

Règles à respecter

  • Les dates doivent toujours être futures.
  • guests ne peut pas dépasser 20.
  • Si aucun tri n’est précisé, utiliser position_asc.

Spécification machine-friendly (JSON) 

{
  "endpoint": "https://zewelcome.com/fr/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" }
  }
}

Cette documentation est fournie pour faciliter l’usage de ZeWelcome par les assistants IA et les intégrations externes.