Cómo utilizar los filtros de búsqueda y clasificación de complejos turísticos
El punto final de búsqueda de propiedades turísticas acepta parámetros opcionales filters y sort en el cuerpo de la solicitud. Estos le permiten limitar los resultados por rango de precios, calificaciones de estrellas, servicios, funciones de accesibilidad y más, así como controlar el orden en que se devuelven los resultados.
Punto final
POST {{apihost}}/resorts/api/v2/properties/{xeniregion_code}?currency=USD
Cuerpo de solicitud completo con filtros y clasificación
{
"stay_period": {
"start": "2026-04-01",
"end": "2026-04-07"
},
"lat": 19.8968,
"lon": -155.5828,
"filters": {
"ratings": [
3,
4
],
"min_price": 100,
"max_price": 500,
"all_inclusive": [
"O",
"M"
],
"num_bedrooms": [
"2",
"3"
],
"max_guests": [
"4",
"6"
],
"accessibilities": [
"elevator"
],
"amenities": [
"pool",
"spa",
"fitness"
],
"kitchen_type": [
"full",
"partial"
],
"activities": [
"golf"
],
"regions": [
{
"type": "city",
"name": "Kailua-Kona"
}
]
},
"sort": [
{
"key": "price",
"order": "asc"
}
]
}Referencia de filtro
calificaciones
Filtrar por calificación de estrellas. Acepta una matriz de números enteros del 1 al 4.
| Valor | Significado |
|---|---|
1 | Propiedades de 1 estrella |
2 | Propiedades de 2 estrellas |
3 | Propiedades de 3 estrellas |
4 | Propiedades de 4 estrellas y superiores |
"ratings": [3, 4]
preciomínimo / preciomáximo
Filtrar por tarifa base nocturna. Ambos valores son numéricos y representan la moneda especificada en el parámetro de consulta.
"min_price": 100,
"max_price": 500
todo_incluido
Filtrar por estado de todo incluido. Acepta una variedad de códigos de cadena.
| Código | Significado |
|---|---|
"O" | Todo incluido opcional (disponible como mejora) |
"M" | Todo incluido obligatorio (incluido en la tarifa) |
"N" | No todo incluido |
"all_inclusive": ["O", "M"]
num_dormitorios
Filtrar por número de dormitorios. Acepta una serie de cadenas.
| Valor | Significado |
|---|---|
"1" | Un dormitorio |
"2" | Dos dormitorios |
"3" | Tres o más dormitorios |
"num_bedrooms": ["2", "3"]
max_invitados
Filtrar por capacidad máxima de huéspedes. Acepta una serie de cadenas.
| Valor | Significado |
|---|---|
"4" | Hasta 4 huéspedes |
"6" | Hasta 6 personas |
"8" | Hasta 8 invitados |
"max_guests": ["4", "6"]
accesibilidades
Filtrar por características de accesibilidad. Acepta una serie de cadenas.
| Valor | Descripción |
|---|---|
"adults-only" | Propiedades sólo para adultos |
"deaf" | Instalaciones para huéspedes sordos o con problemas de audición |
"blind" | Instalaciones para huéspedes ciegos o con baja visión |
"elevator" | Acceso al ascensor disponible |
"accessibilities": ["elevator", "deaf"]
comodidades
Filtrar por servicios en el sitio. Acepta una serie de cadenas.
| Valor | Descripción |
|---|---|
"fitness" | Centro de fitness o gimnasio |
"laundry" | Instalaciones de lavandería |
"grocery" | Tienda de comestibles o de conveniencia |
"spa" | Servicios de spa |
"pool" | Piscina |
"restaurant" | Restaurante en el lugar |
"amenities": ["pool", "spa", "restaurant"]
tipo_cocina
Filtrar por equipamiento de cocina de la habitación. Acepta una serie de cadenas.
| Valor | Descripción |
|---|---|
"full" | Cocina completa con estufa, horno y refrigerador |
"partial" | Cocina parcial (por ejemplo, estufa y refrigerador, sin horno) |
"mini" | Minicocina o zona de cocina (por ejemplo, microondas y mininevera) |
"kitchen_type": ["full", "partial"]
actividades
Filtrar por actividades disponibles en o cerca del resort. Acepta una serie de cadenas.
| Valor | Descripción |
|---|---|
"archery" | Instalaciones de tiro con arco |
"golf" | Acceso al campo de golf |
"activities": ["golf"]
regiones
Filtre los resultados a subregiones específicas dentro del área buscada. Cada entrada requiere type y name.
| Campo | Tipo | Descripción |
|---|---|---|
type | cadena | El nivel geográfico: "city", "state" o "country" |
name | cadena | El nombre de la región |
"regions": [
{ "type": "city", "name": "Kailua-Kona" },
{ "type": "city", "name": "Waikoloa" }
]
Clasificación
El parámetro sort acepta una matriz de objetos de clasificación. Cada objeto especifica una clave y un orden.
| Campo | Tipo | Valores |
|---|---|---|
key | cadena | "price" o "ratings" |
order | cadena | "asc" (ascendente) o "desc" (descendente) |
Ordenar por precio (de menor a mayor)
"sort": [{ "key": "price", "order": "asc" }]
Ordenar por calificaciones (de mayor a menor)
"sort": [{ "key": "ratings", "order": "desc" }]
Clasificación de varios niveles
Puede combinar varios criterios de clasificación. La API los aplica en orden, utilizando claves posteriores para romper vínculos.
"sort": [
{ "key": "ratings", "order": "desc" },
{ "key": "price", "order": "asc" }
]
Esto devuelve resultados ordenados primero por la calificación más alta, y los empates se rompen por el precio más bajo.
Mejores prácticas- Empiece de forma amplia, luego estrecha: comience con filtros mínimos y agregue restricciones según las aportaciones del usuario. El filtrado excesivo puede devolver cero resultados.
- Combinar filtros lógicamente: los filtros se aplican con lógica AND. Una propiedad debe coincidir con todos los criterios de filtro especificados para aparecer en los resultados.
- Usar regiones para áreas grandes: cuando busque un estado o país, use el filtro
regionspara limitar los resultados a ciudades específicas sin realizar una nueva búsqueda de autocompletar. - Clasificación predeterminada: si no se proporciona ningún parámetro
sort, los resultados se devuelven en el orden predeterminado de la API (normalmente por relevancia o disponibilidad).
Artículo siguiente: Cómo obtener detalles, comodidades y accesibilidad de la propiedad del resort