API de hoteles

Búsqueda de hoteles, tarifas y reserva

Resuelve un destino, lista alojamientos, valida la tarifa y confirma. Un flujo REST, precios en USD.

POST /v2/Hotel/HotelAvailability
{
  "CheckIn": "2026-11-14",
  "CheckOut": "2026-11-16",
  "CityId": 11111111456928,
  "Occupancies": [ { "AdultCount": 2 } ],
  "Sort": "price"
}
Resumen

El inventario hotelero es enorme y las tarifas cambian rápido. Esta API de alojamiento ofrece búsqueda pública de lugares, disponibilidad por ciudad y por hotel, validación de tarifa con ventana de retención y un flujo claro: primero reservas, luego confirmas.

Una única API de alojamiento se sitúa frente a millones de propiedades, desde cadenas globales hasta boutiques independientes. Disponibilidad, regímenes, políticas de cancelación e impuestos llegan en un mismo formato y moneda, para que tu web o app de reservas de hotel no tenga que conciliar una docena de formatos de proveedor.

Lo que obtienes

1

La búsqueda pública de lugares se conecta directamente a un campo de autocompletado.

2

Un solo endpoint de disponibilidad lista una ciudad entera o abre un hotel con sus habitaciones.

3

Valida la tarifa, retén la habitación y luego confirma y cobra, todo en USD.

4

Búsqueda por ciudad y por hotel desde un mismo endpoint, de un destino entero a una sola propiedad.

5

La validación de tarifa abre una ventana de retención breve, para que el precio que muestras sea el que reservas.

Cómo funciona el flujo

01

Resolve

Turn a destination string into a place id with public place search.

02

Search

List availability for a whole city, or open a single property with its rooms.

03

Validate

Confirm the live rate and open a short hold window.

04

Book

Place the order and confirm; your balance is charged on confirmation.

Endpoints clave

GET/Hotel/PlaceSearchResolve a destination into a place id.
POST/v2/Hotel/HotelAvailabilityList availability in city or hotel mode.
POST/Hotel/RateValidateValidate the selected rate and hold it.
POST/Hotel/HotelBookCreate and confirm the booking.
GET/Hotel/BookingDetailsRetrieve a booking and its status.

Solicitud y respuesta

Request · POST /v2/Hotel/HotelAvailability
{
  "CheckIn": "2026-11-14",
  "CheckOut": "2026-11-16",
  "CityId": 11111111456928,
  "Occupancies": [ { "AdultCount": 2 } ],
  "Sort": "price"
}
Response · 200 OK
{
  "hotels": [
    {
      "hotelId": "HTL-9931",
      "name": "Marina Suites",
      "stars": 4,
      "lowestRate": {
        "amount": 180.00, "currency": "USD", "board": "BB"
      },
      "rooms": [ { "code": "DLX-K", "refundable": true } ]
    }
  ]
}

Qué incluye la respuesta

hotelId
Stable id for the property.
lowestRate
Cheapest bookable rate, in USD, with board type.
rooms
Room options with codes and refundability.
cancellationPolicy
Deadlines and penalties that apply to the rate.
hold
Minutes the validated rate stays bookable.
5 M+

Hoteles en todo el mundo

Preguntas frecuentes

¿Cómo convierto un destino en una búsqueda?

Llama a la búsqueda pública de lugares para convertir el texto en un id y pásalo a disponibilidad.

¿Cuánto dura una tarifa validada?

Quince minutos. Reserva dentro de esa ventana con el código de tarifa devuelto.

¿Cuándo se cobra mi saldo?

Solo cuando confirmas el pedido. La reserva retiene la habitación sin cobrar.

¿Las tarifas incluyen impuestos y cargos?

Sí. Cada tarifa lleva la moneda, el régimen y un desglose de impuestos y cargos, todo normalizado a USD.

¿Puedo abrir una sola propiedad directamente?

Sí. El modo hotel abre una propiedad con sus habitaciones, y el modo ciudad lista un destino entero.

Construye tu producto de viajes sobre una sola API.

Integración gratuita. 1 % por billete emitido, con tope de 10 $. Cobertura en vivo de vuelos, hoteles y actividades.