Cómo filtrar los resultados de los alquileres vacacionales

La API de Vacation Rentals admite múltiples opciones de filtro para ayudar a limitar los resultados de búsqueda. Los filtros se pasan en el objeto filters y en la matriz vacation_rentals dentro del cuerpo de la solicitud de búsqueda.

Opciones de filtro

Calificaciones de estrellas

Filtrar propiedades por clasificación de estrellas. Pase una serie de números enteros.

{
  "filters": {
    "ratings": [
      4,
      5
    ]
  }
}

Servicios

Filtrar por servicios disponibles. Pase una serie de cadenas de nombres de servicios.

{
  "filters": {
    "amenities": [
      "pool",
      "wifi",
      "kitchen",
      "parking"
    ]
  }
}

Nombre de la propiedad

Busque propiedades que coincidan con un nombre o palabra clave.

{
  "filters": {
    "name": "Lakeside"
  }
}

Rango de precios

Establecer límites de precio mínimo y/o máximo por noche. Los precios están en la moneda especificada en la cadena de consulta.

{
  "filters": {
    "min_price": 100,
    "max_price": 400
  }
}

Distancia

Limite los resultados a propiedades dentro de una distancia específica desde las coordenadas de búsqueda.

{
  "filters": {
    "distance": 10
  }
}

Filtro de tipo de alquiler

Utilice el parámetro de cuerpo vacation_rentals (fuera de filters) para limitar los resultados a tipos de propiedad específicos:

{
  "vacation_rentals": [
    "Cottage",
    "Apartment",
    "Condo"
  ]
}

Valores admitidos: "Condo", "Apartment", "Cottage", "Houseboat", "Mobile Home", "Aparthotel", "Condominium Resort".

Combinando todos los filtros

Todas las opciones de filtro se pueden combinar en una sola solicitud. Solo se devuelven las propiedades que coinciden con cada filtro especificado.

{
  "checkin_date": "2026-06-01",
  "checkout_date": "2026-06-08",
  "occupancy": [
    {
      "adults": 4,
      "childs": 2,
      "childages": [
        6,
        10
      ]
    }
  ],
  "lat": 39.0968,
  "long": -120.0324,
  "countryofresidence": "US",
  "placeid": "placeabc123",
  "vacation_rentals": [
    "Cottage",
    "Condo"
  ],
  "radius": 30,
  "sort": [
    {
      "key": "price",
      "order": "asc"
    }
  ],
  "filters": {
    "ratings": [
      4,
      5
    ],
    "amenities": [
      "pool",
      "wifi",
      "kitchen"
    ],
    "min_price": 150,
    "max_price": 600,
    "distance": 20
  },
  "is_async": false
}

Clasificación

Controle el orden de los resultados de la búsqueda con la matriz sort:

{
  "sort": [
    {
      "key": "price",
      "order": "asc"
    }
  ]
}

Paginación

Utilice parámetros de consulta para desplazarse por los resultados:

POST /hotels/api/v2/properties/vacation-rentals?currency=USD&page=1&limit=25&amenities=true

1. Comience con page=1.
2. Marque data.total en la respuesta para determinar el número total de resultados.
3. Incremente page hasta que se hayan recuperado todos los resultados.

Consejos para un filtrado eficaz

• Empiece de forma amplia, luego estrecha: comience con menos filtros y agregue más para refinar los resultados.
• Utilice filtros de tipo de alquiler para necesidades de alojamiento específicas: los viajeros que busquen una experiencia en una cabaña no querrán resultados en apartamentos.
• Combine precio y distancia para encontrar opciones asequibles cerca de la ubicación deseada.
• Establezca servicios = verdadero en la cadena de consulta para recibir datos de servicios en la respuesta, lo que puede informar un filtrado adicional.

Próximos pasos

Descubra cómo funciona el modo de búsqueda asíncrona para alquileres vacacionales y cómo gestionar la carga progresiva de resultados.