POST/v1/hotels/search

Buscar hoteles disponibles

Busca hoteles disponibles por ubicación, fechas, ocupación y filtros comerciales, y aplica las reglas de precio configuradas para la compañía.

Compartir

Busca hoteles disponibles por ubicación, fechas, ocupación y filtros comerciales, y aplica las reglas de precio configuradas para la compañía.

Endpoint

MétodoRutaAuth
POST/v1/hotels/searchAPI key requerida
Headers obligatorios:
HeaderDescripción
AuthorizationBearer <secret_key>. El secret se muestra una sola vez al crear la credencial.
X-Travelandz-Id<public_key>:<profile_code>. El profile_code es el codigo de Developer Profile con prefijo dp_ que ves en el dashboard. Esto vincula la peticion con un perfil y una credencial.
Content-TypeUsa application/json para peticiones con cuerpo.

Parámetros de la petición

No requiere parámetros de ruta ni query.

Esquema del cuerpo de la petición

language
enum
eneszh
No
Default en
checkIn
string
Format: YYYY-MM-DD
Sí
checkOut
string
Format: YYYY-MM-DD
Sí
location
objectSí
locationsearchBy
enum
coords
Sí
locationlatitude
numberSí
locationlongitude
numberSí
searchRadius
numberNo
Minimum value: 1
countryCode
string
Format: 2 digits
Sí
nationality
string
Format: 2 digits
Sí
maxHotels
numberNo
Maximum value: 2000
minRate
numberNo
maxRate
numberNo
minCategory
enum
12345
No
maxCategory
enum
12345
No
refundable
enum
allrefundablenon-refundable
Sí
rooms
arraySí
rooms[]adults
numberSí
Minimum value: 1, Maximum value: 4
rooms[]children
numberNo
Minimum value: 0, Maximum value: 4
rooms[]childrenAges
arraySí
rooms[]childrenAges[]
number[]Sí
currency
enum
EURUSDCNY
No
Por defecto EUR
retrieveBookingLink
booleanNo
Default false

Respuesta exitosa

Devuelve hotel results, availability, min rates and optional booking links.

Esquema del cuerpo de la respuesta

hotels
arraySí
hotels[]gdsprovider
numberSí
hotels[]offerLink
stringNo
hotels[]hotelId
stringSí
hotels[]code
stringSí
hotels[]name
stringSí
hotels[]description
objectSí
hotels[]descriptionlang
enum
eneszh
Sí
hotels[]descriptiondescription
stringSí
hotels[]starRating
numberSí
hotels[]reviewCount
numberNo
hotels[]accommodationType
stringSí
hotels[]chain
stringNulable
hotels[]address
objectSí
hotels[]addressstreet
stringNo
hotels[]addresscountryCode
stringNo
hotels[]addresscountry
stringNo
hotels[]addressdestination
stringNo
hotels[]addresszone
stringNo
hotels[]location
objectSí
hotels[]locationtype
stringSí
hotels[]locationcoordinates
arraySí
hotels[]locationcoordinates[]
number[]
Format: [longitude, latitude]
Sí
hotels[]latitude
numberSí
hotels[]longitude
numberSí
hotels[]roomsNames
arraySí
hotels[]roomsNames[]
string[]Sí
hotels[]boardTypes
arraySí
hotels[]boardTypes[]
string[]Sí
hotels[]hasRefundableRooms
booleanSí
hotels[]images
arraySí
hotels[]images[]
string[]Sí
hotels[]amenities
arraySí
hotels[]amenities[]
string[]Sí
hotels[]minPrice
numberSí
hotels[]roomCount
numberNo
liveMode
booleanSí
True cuando la peticion se sirve desde el entorno live de Travelandz. Este valor viene de Travelandz, no del payload del proveedor.

Ejemplo

bash
bash
curl -X POST https://api.sandbox.travelandz.com/v1/hotels/search \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
  -H "Content-Type: application/json" \
  -d '<request_body_json>'