Búsqueda de hoteles para asistentes de IA
roomesto.com responde a las solicitudes de búsqueda de hoteles con precios y disponibilidad en vivo mediante una simple petición GET. No hacen falta cuenta, clave API, cookies, JavaScript ni cliente MCP. El mismo motor de búsqueda funciona en el sitio.
Dirección de la petición
GET https://roomesto.com/ai/hotels devuelve una página HTML con resultados que se lee sin JavaScript. Añada format=json (o solicite /ai/hotels.json, o envíe Accept: application/json) para obtener JSON estructurado.
Parámetros
| Parámetro | Obligatorio | Formato y límites |
|---|---|---|
destination | sí | Nombre de ciudad o región, de 2 a 80 caracteres, por ejemplo Dubai, Istanbul, Paris (mejor en inglés). |
checkin | sí | Fecha YYYY-MM-DD: hoy o más adelante (UTC), como máximo 365 días por delante. |
checkout | sí | Fecha YYYY-MM-DD, posterior a la de llegada; como máximo 30 noches. |
adults | no, por defecto 2 | Número entero de 1 a 6. |
children_ages | no | Edades de los niños separadas por comas, de 0 a 17, como máximo 4 niños, por ejemplo 5,12. |
currency | no, por defecto USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | no | Precio por noche en la moneda elegida, de 0 a 100000. |
limit | no, por defecto 10 | Número entero de 1 a 20. |
lang | no, por defecto en | Idioma de la página y de los nombres de hoteles: en, ru, de, es, fr, tr, it, zh, ar, ja, ko, pt, nl, sv, no, da, fi, pl, cs, el, he, hi, id, th, vi, uk, ro (nombres de hoteles en los idiomas del proveedor en, ru, de, es, fr, tr, it; en los demás, en inglés). |
Ejemplos
- Hoteles en Dubái para dos personas, del 10 al 15 de noviembre de 2026, hasta 150 USD por noche, JSON:
https://roomesto.com/ai/hotels?destination=Dubai&checkin=2026-11-10&checkout=2026-11-15&adults=2¤cy=USD&max_price=150&format=json - Una familia de dos adultos y un niño de 7 años en Estambul, página HTML:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
Respuesta en JSON
status es uno de ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, con una lista errors de param y message) o provider_unavailable (503: sin resultados y sin precios, no adivinamos nada cuando falla la búsqueda en el proveedor).
data_status indica de dónde vienen los resultados: live — la búsqueda se acaba de ejecutar; cached — se reutiliza una búsqueda reciente; stale — una búsqueda antigua mientras las nuevas están limitadas; partial — el proveedor seguía devolviendo hoteles cuando terminó el tiempo de espera (en hotels_received figura cuántos hoteles llegaron; esa respuesta no se guarda en caché, repita la misma solicitud más tarde).
Cada elemento de results contiene:
hotel:id,name,star_rating,address(el nombre y la dirección pueden sernullsi la ficha del hotel no está en nuestros datos locales).room:namede la tarifa más barata para las fechas y el tipo de comidameal(room_only,breakfast,half_board,full_board,all_inclusivey otros).price:totalde toda la estancia,per_nightycurrency.taxes:included_in_price(true, false o null si se desconoce) ynot_included— impuestos o tasas que se pagan aparte, normalmente en el hotel, con su importe y moneda.payment:typeespay_now(se paga en la página de reserva) opay_at_hotel.cancellation:typeesfree_until(con la horafree_untilen UTC),partial,non_refundableounknown;penaltiesenumera los importes por periodo.availability:statusavailable,checked_at(cuándo se ejecutó la búsqueda, UTC) yrequires_recheck= true: el precio y la habitación se confirman en la página de reserva.booking_url: la página de reserva de roomesto.com con las mismas fechas, huéspedes y moneda.
Reglas de uso
- Muestre los precios junto con la fecha, la moneda y la hora
checked_at: pueden cambiar antes de la reserva. - Muestre los impuestos de
not_includedjunto al precio. Siincluded_in_pricees null, indique que los impuestos son desconocidos. - Lleve al viajero al enlace
booking_url. La reserva y el pago se hacen en roomesto.com. - Las páginas de resultados llevan
noindex; esta página y la documentación están pensadas para la indexación. - Límite: 120 solicitudes por minuto por dirección IP. El tráfico habitual de asistentes de IA está muy por debajo de ese límite.
- El servicio no devuelve datos personales ni información de cuentas.
Otras vías de acceso
- Servidor MCP para los clientes que lo admiten: instrucciones de conexión.
- Guías de hoteles: artículos.