Primeros pasos con la API de actividades de Xeni Cómo reservar una actividad Cómo buscar etiquetas y categorías de actividades Cómo cancelar una reserva de actividad Cómo comprobar la disponibilidad de la actividad Cómo obtener detalles de la actividad Cómo recuperar los detalles de la reserva de actividades Cómo buscar actividades con filtros Cómo buscar destinos de actividades API de alquiler de coches: introducción API de alquiler de coches: comprensión de los campos de respuesta Cómo reservar un alquiler de coches Cómo obtener detalles del vehículo de alquiler y complementos de equipo Cómo recuperar o cancelar una reserva de alquiler de coches Cómo buscar autos de alquiler disponibles Cómo buscar ubicaciones de recogida Cómo utilizar los filtros de búsqueda de alquiler de coches Mejores prácticas de integración de API de ofertas Preguntas frecuentes sobre la API de ofertas Primeros pasos con la API de ofertas de Xeni Referencia de encabezados y parámetros de solicitud de API de ofertas Ofertas API Monedas admitidas y localización Cómo mostrar ofertas en su aplicación Cómo buscar ofertas de hoteles por ubicación Códigos de error de la API de vuelos y solución de problemas Primeros pasos con la API de vuelos de Xeni Cómo reservar un vuelo Cómo comprobar la disponibilidad y el precio de los vuelos Cómo confirmar o cancelar una reserva de vuelo Cómo recuperar las reglas de tarifas de un vuelo Cómo recuperar los detalles de la reserva de un vuelo Cómo buscar aeropuertos usando Autocompletar Cómo buscar vuelos Cómo utilizar filtros, clasificación y paginación de búsqueda de vuelos Cómo comprobar la disponibilidad y el precio de las habitaciones Cómo filtrar los resultados de los alquileres vacacionales Cómo obtener detalles, comodidades y accesibilidad de la propiedad del resort Cómo mantener y confirmar una reserva de resort Cómo liberar una retención de resort Cómo recuperar los detalles de la reserva del resort Cómo buscar complejos turísticos disponibles Cómo buscar destinos turísticos Cómo buscar ubicaciones de alquiler vacacional Cómo buscar alquileres vacacionales Cómo utilizar filtros de búsqueda y clasificación de complejos turísticos Comenzando con la API de Xeni Resorts API de Resorts: comprensión de los estados y políticas de las reservas Primeros pasos con la API de alquileres vacacionales Preguntas frecuentes sobre alquileres vacacionales Tipos de propiedades admitidas para alquileres vacacionales Comprensión de la búsqueda asincrónica para alquileres vacacionales Autenticación y firmas API Reserva de hoteles: API directa y pago SSO Manejo de errores, límites de tasas y mejores prácticas Primeros pasos con la API de Xeni Hoteles Gestión de reservas: estado, recuperación y cancelación Confirmación de precios y ciclo de vida del token Recuperar detalles del hotel y disponibilidad de habitaciones Búsqueda de hoteles: ubicaciones, filtros y paginación Buscando Hoteles Gestión de sesiones e ID de correlación Autenticación API y obtención de claves API

Cómo buscar complejos turísticos disponibles

Última actualización: 2026-03-03

Cómo buscar complejos turísticos disponibles

Una vez que tenga un código de región del punto final de autocompletar, puede buscar propiedades turísticas disponibles. El punto final de búsqueda de propiedades devuelve una lista de complejos turísticos que coinciden con sus criterios, incluidos precios, calificaciones, imágenes y detalles de ubicación.

Punto final

POST {{apihost}}/resorts/api/v2/properties/{xeniregioncode}?currency={currencycode}

Encabezados requeridos

Encabezado	Valor	Requerido
`Content-Type`	`application/json`	Sí
`x-api-key`	Su clave API	Sí
`x-correlation-id`	Identificador de correlación único	Sí

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
`xeniregioncode`	cadena	Sí	El código de región codificado en Base64 del punto final de autocompletar

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
`currency`	cadena	No	Código de moneda ISO 4217 de tres letras (por ejemplo, `USD`, `EUR`, `GBP`). El valor predeterminado es `USD`.

Cuerpo de solicitud

JSON

{
  "stay_period": {
    "start": "2026-04-01",
    "end": "2026-04-07"
  },
  "lat": 19.8968,
  "lon": -155.5828
}

Campos del cuerpo de la solicitud

Campo	Tipo	Requerido	Descripción
`stayperiod.start`	cadena	Sí	Fecha de entrada en formato `YYYY-MM-DD`
`stayperiod.end`	cadena	Sí	Fecha de salida en formato `YYYY-MM-DD`
`lat`	número	Sí	Latitud del destino (desde autocompletar)
`lon`	número	Sí	Longitud del destino (desde autocompletar)
`filters`	objeto	No	Filtros opcionales para limitar los resultados. Consulte Cómo utilizar los filtros y la clasificación de búsqueda de complejos turísticos.
`sort`	matriz	No	Criterios de clasificación opcionales. Consulte Cómo utilizar filtros y clasificación de búsqueda de complejos turísticos.

Solicitud de ejemplo

JSON

POST {{api_host}}/resorts/api/v2/properties/aGF3YWlp?currency=USD
{
  "stay_period": {
    "start": "2026-04-01",
    "end": "2026-04-07"
  },
  "lat": 19.8968,
  "lon": -155.5828
}

Ejemplo de respuesta

JSON

{
  "status": 200,
  "data": [
    {
      "id": "RST-98765",
      "name": "Oceanfront Paradise Resort & Spa",
      "base_rate": 245,
      "taxesandfees": 38.5,
      "total_rate": 1710,
      "currency": "USD",
      "address": {
        "line_1": "100 Beachfront Drive",
        "city": "Kailua-Kona",
        "state": "HI",
        "country": "US",
        "postal_code": "96740"
      },
      "coordinates": {
        "lat": 19.64,
        "lon": -155.9969
      },
      "ratings": {
        "star_rating": 4,
        "user_rating": 8.7
      },
      "image": "https://images.example.com/resort-main.jpg",
      "start_date": "2026-04-01",
      "end_date": "2026-04-07",
      "recommendation_id": "rec-abc123",
      "published_price": 1850
    }
  ]
}

Campos de respuesta

Campo	Tipo	Descripción
`id`	cadena	Identificador de propiedad único. Utilice esto para llamadas de detalles, disponibilidad y reserva.
`name`	cadena	Nombre para mostrar de la propiedad del resort
`baserate`	número	Tarifa base por noche antes de impuestos y cargos
`taxesandfees`	número	Total de impuestos y tasas de la estancia
`totalrate`	número	Costo total de toda la estancia, incluidos impuestos y tasas
`currency`	cadena	Código de moneda para todos los campos de tarifas
`address`	objeto	Detalles de la dirección de la propiedad
`coordinates`	objeto	Latitud y longitud de la propiedad
`ratings.starrating`	número	Clasificación de estrellas de la propiedad (1-5)
`ratings.userrating`	número	Calificación promedio de los huéspedes
`image`	cadena	URL de la imagen de la propiedad principal
`startdate`	cadena	Fecha de entrada
`enddate`	cadena	Fecha de salida
`recommendationid`	cadena	Identificador de recomendación. Requerido para disponibilidad y llamadas de reserva.
`publishedprice`	número	La tarifa normal publicada original antes de cualquier descuento

Notas importantes

Guardar el recommendation_id: este valor es obligatorio al verificar la disponibilidad de habitaciones, confirmar precios y crear reservas. Vincula las llamadas API posteriores a este resultado de búsqueda específico.
Guardar la propiedad id: necesitará este identificador para realizar búsquedas de detalles de propiedades, comprobaciones de disponibilidad y solicitudes de reserva.
Las tarifas son por estadía: totalrate representa el costo total de todo el período de estadía, no una tarifa por noche. El baserate es la tarifa por noche.
Precio publicado frente a tarifa total: publishedprice es la tarifa normal original. El totalrate es el precio real que paga su cliente, que puede reflejar precios negociados o con descuento.

Artículo siguiente: Cómo utilizar los filtros y la clasificación de búsqueda de complejos turísticos

¿Te resultó útil este artículo?