>

roomesto.com · English

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ámetroObligatorioFormato y límites
destinationsíNombre de ciudad o región, de 2 a 80 caracteres, por ejemplo Dubai, Istanbul, Paris (mejor en inglés).
checkinsíFecha YYYY-MM-DD: hoy o más adelante (UTC), como máximo 365 días por delante.
checkoutsíFecha YYYY-MM-DD, posterior a la de llegada; como máximo 30 noches.
adultsno, por defecto 2Número entero de 1 a 6.
children_agesnoEdades de los niños separadas por comas, de 0 a 17, como máximo 4 niños, por ejemplo 5,12.
currencyno, por defecto USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_pricenoPrecio por noche en la moneda elegida, de 0 a 100000.
limitno, por defecto 10Número entero de 1 a 20.
langno, por defecto enIdioma 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

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:

Reglas de uso

Otras vías de acceso