Cotización múltiple
POST /v1/quotes cotiza varios hoteles en una sola llamada. Se cobra por
hotel: un lote de 20 cuesta 20 veces lo que cuesta uno solo — el beneficio
es la latencia, no el precio.
El cuerpo del request
Sección titulada «El cuerpo del request»hotels acepta entre 1 y 200 elementos — el
techo físico del lote. Cada elemento es, a tu elección:
- un entero (abreviatura de
{"hotel_id": <entero>}), o - un objeto con
hotel_idohotel_refoname(máscity/lat/lon/country/phoneopcionales, igual que en cotización simple).
Tu plan puede limitar cuántos hoteles puedes pedir por llamada por debajo de ese techo — consulta tu plan. Además, para un cliente con timeout HTTP de 60 segundos, el rango práctico recomendado es de 25 a 50 hoteles por llamada: la velocidad depende de qué tan rápido respondan las fuentes, no de nuestro límite — un lote más grande no es más rápido si la fuente ya es el cuello de botella.
Junto a hotels/checkin/checkout/adults, el cuerpo acepta los mismos
parámetros opcionales que cotización simple:
| Parámetro | Por defecto | Descripción |
|---|---|---|
rooms |
1 |
Habitaciones. |
children |
— | Edades de los menores, como arreglo de enteros (0 a 17 cada uno) — aquí SÍ es un arreglo JSON, no una cadena separada por comas como en GET. |
currency |
USD |
— |
market |
mx |
Punto de venta. |
max_age |
300 |
Antigüedad de caché aceptable, en segundos. |
curl -X POST "https://api.rateshooter.com/v1/quotes" \ -H "Authorization: Bearer <tu_api_key>" \ -H "Content-Type: application/json" \ -d '{ "hotels": [2008, 13983], "checkin": "2026-12-10", "checkout": "2026-12-11", "adults": 2 }'{
"stay": {
"checkin": "2026-12-10",
"checkout": "2026-12-11",
"nights": 1,
"adults": 2,
"rooms": 1,
"children": [],
"currency": "USD"
},
"results": [
{
"status": "ok",
"hotel": {
"resolved_name": "Grand Oasis Cancun",
"hotel_id": 2008,
"verified": true
},
"offers": [
{
"vendor": "The Grand Oasis Cancun - All Inclusive",
"price_per_night": 245.40494,
"total_price": 245.40494,
"taxes_included": true
},
{
"vendor": "Super.com",
"price_per_night": 185.50781,
"total_price": 185.50781,
"taxes_included": true
},
{
"vendor": "trivago DEALS",
"price_per_night": 189.47403,
"total_price": 189.47403,
"taxes_included": true
},
{
"vendor": "Traveluro",
"price_per_night": 187.65692,
"total_price": 187.65692,
"taxes_included": true
},
{
"vendor": "Billabook.com",
"price_per_night": 210,
"total_price": 210,
"taxes_included": true
},
{
"vendor": "goseek.com",
"price_per_night": 219.50781,
"total_price": 219.50781,
"taxes_included": true
},
{
"vendor": "Despegar",
"price_per_night": 301.375,
"total_price": 301.375,
"taxes_included": true
},
{
"vendor": "Expedia.mx",
"price_per_night": 302.93268,
"total_price": 302.93268,
"taxes_included": true
},
{
"vendor": "Agoda",
"price_per_night": 230.1875,
"total_price": 230.1875,
"taxes_included": true
},
{
"vendor": "Booking.com",
"price_per_night": 297.90625,
"total_price": 297.90625,
"taxes_included": true
},
{
"vendor": "Priceline",
"price_per_night": 305.90625,
"total_price": 305.90625,
"taxes_included": true
},
{
"vendor": "Evendo",
"price_per_night": 256.15396,
"total_price": 256.15396,
"taxes_included": true
},
{
"vendor": "Central de Reservas",
"price_per_night": 247.38129,
"total_price": 247.38129,
"taxes_included": true
},
{
"vendor": "Hotel prive",
"price_per_night": 292.5,
"total_price": 292.5,
"taxes_included": true
},
{
"vendor": "Hoteles.com",
"price_per_night": 302.93268,
"total_price": 302.93268,
"taxes_included": true
},
{
"vendor": "Qantas Hotels",
"price_per_night": 302.1284,
"total_price": 302.1284,
"taxes_included": true
},
{
"vendor": "klook",
"price_per_night": 235.61737,
"total_price": 235.61737,
"taxes_included": true
},
{
"vendor": "Clicktrip.com",
"price_per_night": 241.47806,
"total_price": 241.47806,
"taxes_included": true
}
],
"meta": {
"offers_count": 18,
"billable": true
}
},
{
"status": "ok",
"hotel": {
"resolved_name": "Iberostar Selection Cancún",
"hotel_id": 13983,
"verified": true
},
"offers": [
{
"vendor": "Iberostar Selection Cancún",
"price_per_night": 346.34375,
"total_price": 346.34375,
"taxes_included": true
},
{
"vendor": "Super.com",
"price_per_night": 293.6875,
"total_price": 293.6875,
"taxes_included": true
},
{
"vendor": "trivago DEALS",
"price_per_night": 313.97296,
"total_price": 313.97296,
"taxes_included": true
},
{
"vendor": "Evendo",
"price_per_night": 308.90115,
"total_price": 308.90115,
"taxes_included": true
},
{
"vendor": "Expedia.mx",
"price_per_night": 372.97366,
"total_price": 372.97366,
"taxes_included": true
},
{
"vendor": "Vio.com",
"price_per_night": 325.21875,
"total_price": 325.21875,
"taxes_included": true
},
{
"vendor": "Central de Reservas",
"price_per_night": 326.70975,
"total_price": 326.70975,
"taxes_included": true
},
{
"vendor": "Booking.com",
"price_per_night": 384.32812,
"total_price": 384.32812,
"taxes_included": true
},
{
"vendor": "goseek.com",
"price_per_night": 325.21875,
"total_price": 325.21875,
"taxes_included": true
},
{
"vendor": "Priceline",
"price_per_night": 384.32812,
"total_price": 384.32812,
"taxes_included": true
},
{
"vendor": "Clicktrip.com",
"price_per_night": 318.6159,
"total_price": 318.6159,
"taxes_included": true
},
{
"vendor": "Bluepillow.mx",
"price_per_night": 327.09186,
"total_price": 327.09186,
"taxes_included": true
},
{
"vendor": "Billabook.com",
"price_per_night": 327,
"total_price": 327,
"taxes_included": true
},
{
"vendor": "dealbase.com",
"price_per_night": 326.19708,
"total_price": 326.19708,
"taxes_included": true
},
{
"vendor": "Etrip.net",
"price_per_night": 325.21875,
"total_price": 325.21875,
"taxes_included": true
},
{
"vendor": "Hoteles.com",
"price_per_night": 372.97366,
"total_price": 372.97366,
"taxes_included": true
},
{
"vendor": "BusinessHotels.com",
"price_per_night": 362.07812,
"total_price": 362.07812,
"taxes_included": true
}
],
"meta": {
"offers_count": 17,
"billable": true
}
}
]
}Mezclando formas de identificar un hotel
Sección titulada «Mezclando formas de identificar un hotel»Un entero y un objeto {hotel_id} para el mismo hotel resuelven
exactamente igual — es la misma forma corta y larga de decir lo mismo:
curl -X POST "https://api.rateshooter.com/v1/quotes" \ -H "Authorization: Bearer <tu_api_key>" \ -H "Content-Type: application/json" \ -d '{ "hotels": [2008, {"hotel_id": 2008}], "checkin": "2026-12-10", "checkout": "2026-12-11", "adults": 2 }'{
"stay": {
"checkin": "2026-12-10",
"checkout": "2026-12-11",
"nights": 1,
"adults": 2,
"rooms": 1,
"children": [],
"currency": "USD"
},
"results": [
{
"status": "ok",
"hotel": {
"resolved_name": "Grand Oasis Cancun",
"hotel_id": 2008,
"verified": true
},
"offers": [
{
"vendor": "The Grand Oasis Cancun - All Inclusive",
"price_per_night": 245.40494,
"total_price": 245.40494,
"taxes_included": true
},
{
"vendor": "Super.com",
"price_per_night": 185.50781,
"total_price": 185.50781,
"taxes_included": true
},
{
"vendor": "trivago DEALS",
"price_per_night": 189.47403,
"total_price": 189.47403,
"taxes_included": true
},
{
"vendor": "Traveluro",
"price_per_night": 187.65692,
"total_price": 187.65692,
"taxes_included": true
},
{
"vendor": "Billabook.com",
"price_per_night": 210,
"total_price": 210,
"taxes_included": true
},
{
"vendor": "goseek.com",
"price_per_night": 219.50781,
"total_price": 219.50781,
"taxes_included": true
},
{
"vendor": "Despegar",
"price_per_night": 301.375,
"total_price": 301.375,
"taxes_included": true
},
{
"vendor": "Expedia.mx",
"price_per_night": 302.93268,
"total_price": 302.93268,
"taxes_included": true
},
{
"vendor": "Agoda",
"price_per_night": 230.1875,
"total_price": 230.1875,
"taxes_included": true
},
{
"vendor": "Booking.com",
"price_per_night": 297.90625,
"total_price": 297.90625,
"taxes_included": true
},
{
"vendor": "Priceline",
"price_per_night": 305.90625,
"total_price": 305.90625,
"taxes_included": true
},
{
"vendor": "Evendo",
"price_per_night": 256.15396,
"total_price": 256.15396,
"taxes_included": true
},
{
"vendor": "Central de Reservas",
"price_per_night": 247.38129,
"total_price": 247.38129,
"taxes_included": true
},
{
"vendor": "Hotel prive",
"price_per_night": 292.5,
"total_price": 292.5,
"taxes_included": true
},
{
"vendor": "Hoteles.com",
"price_per_night": 302.93268,
"total_price": 302.93268,
"taxes_included": true
},
{
"vendor": "Qantas Hotels",
"price_per_night": 302.1284,
"total_price": 302.1284,
"taxes_included": true
},
{
"vendor": "klook",
"price_per_night": 235.61737,
"total_price": 235.61737,
"taxes_included": true
},
{
"vendor": "Clicktrip.com",
"price_per_night": 241.47806,
"total_price": 241.47806,
"taxes_included": true
}
],
"meta": {
"offers_count": 18,
"billable": true
}
},
{
"status": "ok",
"hotel": {
"resolved_name": "Grand Oasis Cancun",
"hotel_id": 2008,
"verified": true
},
"offers": [
{
"vendor": "The Grand Oasis Cancun - All Inclusive",
"price_per_night": 245.40494,
"total_price": 245.40494,
"taxes_included": true
},
{
"vendor": "Super.com",
"price_per_night": 185.50781,
"total_price": 185.50781,
"taxes_included": true
},
{
"vendor": "trivago DEALS",
"price_per_night": 189.47403,
"total_price": 189.47403,
"taxes_included": true
},
{
"vendor": "Traveluro",
"price_per_night": 187.65692,
"total_price": 187.65692,
"taxes_included": true
},
{
"vendor": "Billabook.com",
"price_per_night": 210,
"total_price": 210,
"taxes_included": true
},
{
"vendor": "goseek.com",
"price_per_night": 219.50781,
"total_price": 219.50781,
"taxes_included": true
},
{
"vendor": "Despegar",
"price_per_night": 301.375,
"total_price": 301.375,
"taxes_included": true
},
{
"vendor": "Expedia.mx",
"price_per_night": 302.93268,
"total_price": 302.93268,
"taxes_included": true
},
{
"vendor": "Agoda",
"price_per_night": 230.1875,
"total_price": 230.1875,
"taxes_included": true
},
{
"vendor": "Booking.com",
"price_per_night": 297.90625,
"total_price": 297.90625,
"taxes_included": true
},
{
"vendor": "Priceline",
"price_per_night": 305.90625,
"total_price": 305.90625,
"taxes_included": true
},
{
"vendor": "Evendo",
"price_per_night": 256.15396,
"total_price": 256.15396,
"taxes_included": true
},
{
"vendor": "Central de Reservas",
"price_per_night": 247.38129,
"total_price": 247.38129,
"taxes_included": true
},
{
"vendor": "Hotel prive",
"price_per_night": 292.5,
"total_price": 292.5,
"taxes_included": true
},
{
"vendor": "Hoteles.com",
"price_per_night": 302.93268,
"total_price": 302.93268,
"taxes_included": true
},
{
"vendor": "Qantas Hotels",
"price_per_night": 302.1284,
"total_price": 302.1284,
"taxes_included": true
},
{
"vendor": "klook",
"price_per_night": 235.61737,
"total_price": 235.61737,
"taxes_included": true
},
{
"vendor": "Clicktrip.com",
"price_per_night": 241.47806,
"total_price": 241.47806,
"taxes_included": true
}
],
"meta": {
"offers_count": 18,
"billable": true
}
}
]
}Leyendo la respuesta
Sección titulada «Leyendo la respuesta»stay: la estancia normalizada, en la raíz de la respuesta — no se repite dentro de cada resultado.results: un elemento por hotel pedido, en el mismo orden, cada uno con su propiostatus(no todo el lote falla porque un hotel no se pudo cotizar).X-HotelQuotes-Chargeden los headers suma el total de hoteles cobrados en este request.
Un elemento inválido en el lote
Sección titulada «Un elemento inválido en el lote»{ "hotels": [2008, { "hotel_id": 0.5 }], "checkin": "2026-12-10", "checkout": "2026-12-11", "adults": 2 }{
"status": "bad_request",
"error": "hotels.1.hotel_id must not be less than 1; hotels.1.hotel_id must be an integer number"
}Todo el request se rechaza: un hotel_id inválido en cualquier posición
invalida el lote completo, antes de cotizar nada.