CielStay

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'city': {'type': 'string', 'description': 'The city, to disambiguate a property name. Names repeat across towns.'}, 'otaUrl': {'type': 'string', 'description': 'The Airbnb or Vrbo URL the traveller is looking at. Paste it exactly as they gave it â\x80\x94 tracking parameters and locale prefixes are fine. This is the most reliable input.'}, 'propertyName': {'type': 'string', 'description': 'The property name, if you have no URL. Exact spelling as shown on the OTA listing.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The listing ID from a previous search result (result.id).'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query', 'refinement'], 'properties': {'query': {'type': 'string', 'description': 'The original search query you want to refine, exactly as you sent it before.'}, 'persona': {'type': 'string', 'description': 'Carry the same persona through from the original search, if you sent one.'}, 'refinement': {'type': 'string', 'description': 'Natural language refinement instruction. Examples: "more rustic and less modern", "closer to the water", "something with better views", "bigger â\x80\x94 needs 3+ bedrooms".'}, 'previousIntent': {'description': 'The `currentIntent` object from the previous response, if you still have it. Preserves location and dates across the refinement. Optional â\x80\x94 omit it and the refinement still works.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 5, 'maximum': 20, 'minimum': 1, 'description': 'Number of results to return (1â\x80\x9320). Default 5.'}, 'query': {'type': 'string', 'description': 'Natural language search query: location, dates, group, and what the stay is for. Examples: "cozy cabin near Zion National Park for a couple", "pet-friendly beachfront with a hot tub in Hawaii", "modern loft in Austin walkable to nightlife for 4 adults". Put WHO the guest is in the separate `persona` argument rather than here.'}, 'guests': {'type': 'integer', 'minimum': 1, 'description': 'Number of guests. Defaults to 2 if omitted.'}, 'intent': {'description': 'OPTIONAL FAST PATH. If you have already parsed the traveller\'s request, send it here and CielStay skips its own parse â\x80\x94 measured 2.3s to 0.06s with identical results. Shape: {"vibePrefs":["quiet","rustic"],"aestheticPrefs":["historic","cabin"],"activities":["hiking"],"filters":{"guests":4,"checkIn":"2026-11-13","checkOut":"2026-11-16"}}. Trusted, not re-validated. You can also pass back the `currentIntent` from a previous response.'}, 'checkin': {'type': 'string', 'description': 'Check-in date in YYYY-MM-DD format. Omit if flexible or unknown.'}, 'persona': {'type': 'string', 'description': 'Who the guest is, in a few sentences of plain prose â\x80\x94 what they like, what the trip is for, and what they want to avoid. CielStay embeds this and ranks on it, so it changes which homes come back rather than filtering them. Example: "Travelling with a dog and two teenagers. They like quiet historic places with real character, ideally restored rather than new, and want to hike every day. They avoid resorts, condo complexes and anywhere with nightlife." Must be MORE THAN 100 CHARACTERS â\x80\x94 anything shorter is too thin to embed and is ignored, so keywords like "likes cabins" have no effect. Never stored.'}, 'checkout': {'type': 'string', 'description': 'Check-out date in YYYY-MM-DD format. Omit if flexible or unknown.'}, 'minBedrooms': {'type': 'integer', 'minimum': 0, 'description': 'Minimum number of bedrooms required.'}, 'maxPricePerNight': {'type': 'number', 'description': 'Maximum nightly price in USD.'}, 'mustHaveAmenities': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Amenities the listing must have. Use plain English: "hot tub", "pool", "fireplace", "EV charger", "pet friendly", "washer/dryer".'}}, 'additionalProperties': False}