Pesquisa de hotéis para assistentes de IA
O roomesto.com responde a pedidos de pesquisa de hotéis com preços e disponibilidade ao vivo através de um simples pedido GET. Não são necessários conta, chave API, cookies, JavaScript nem cliente MCP. O mesmo motor de pesquisa alimenta o site.
Endereço do pedido
GET https://roomesto.com/ai/hotels devolve uma página HTML de resultados legível sem JavaScript. Acrescente format=json (ou peça /ai/hotels.json, ou envie Accept: application/json) para receber JSON estruturado.
Parâmetros
| Parâmetro | Obrigatório | Formato e limites |
|---|---|---|
destination | sim | Nome da cidade ou região, de 2 a 80 caracteres, por exemplo Dubai, Istanbul, Paris (de preferência em inglês). |
checkin | sim | Data YYYY-MM-DD: hoje ou mais tarde (UTC), no máximo 365 dias à frente. |
checkout | sim | Data YYYY-MM-DD, depois da chegada; no máximo 30 noites. |
adults | não, padrão 2 | Número inteiro de 1 a 6. |
children_ages | não | Idades das crianças separadas por vírgulas, de 0 a 17, no máximo 4 crianças, por exemplo 5,12. |
currency | não, padrão USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | não | Preço por noite na moeda escolhida, de 0 a 100000. |
limit | não, padrão 10 | Número inteiro de 1 a 20. |
lang | não, padrão en | Idioma da página e dos nomes dos hotéis: 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 (nomes dos hotéis nos idiomas do fornecedor en, ru, de, es, fr, tr, it; nos restantes, em inglês). |
Exemplos
- Hotéis no Dubai para duas pessoas, de 10 a 15 de novembro de 2026, até 150 USD por noite, 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 - Uma família de dois adultos e uma criança de 7 anos em Istambul, 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
Resposta em JSON
status é um de ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, com uma lista errors de param e message) ou provider_unavailable (503: sem resultados e sem preços, nada é adivinhado quando a pesquisa do fornecedor falha).
data_status mostra de onde vêm os resultados: live — a pesquisa acabou de ser feita; cached — reutiliza-se uma pesquisa recente; stale — uma pesquisa antiga enquanto as novas estão limitadas; partial — o fornecedor ainda estava a devolver hotéis quando o tempo de espera terminou (em hotels_received está quantos hotéis chegaram; essa resposta não é guardada em cache, repita o mesmo pedido mais tarde).
Cada elemento de results contém:
hotel:id,name,star_rating,address(o nome e a morada podem sernullquando a ficha do hotel não está nos nossos dados locais).room:nameda tarifa mais barata para as datas e o tipo de refeiçãomeal(room_only,breakfast,half_board,full_board,all_inclusivee outros).price:totalde toda a estadia,per_nightecurrency.taxes:included_in_price(true, false ou null quando desconhecido) enot_included— impostos ou taxas pagos à parte, normalmente no hotel, com o seu valor e moeda.payment:typeépay_now(pago na página de reserva) oupay_at_hotel.cancellation:typeéfree_until(com a horafree_untilem UTC),partial,non_refundableouunknown;penaltieslista os valores por período.availability:statusavailable,checked_at(quando a pesquisa correu, UTC) erequires_recheck= true: o preço e o quarto são confirmados na página de reserva.booking_url: a página de reserva do roomesto.com com as mesmas datas, hóspedes e moeda.
Regras de utilização
- Mostre os preços com a data, a moeda e a hora
checked_at: podem mudar antes da reserva. - Mostre os impostos de
not_includedjunto ao preço. Seincluded_in_pricefor null, diga que os impostos são desconhecidos. - Encaminhe o viajante para o link
booking_url. A reserva e o pagamento acontecem no roomesto.com. - As páginas de resultados estão marcadas com
noindex; esta página e a documentação destinam-se à indexação. - Limite: 120 pedidos por minuto por endereço IP. O tráfego habitual de assistentes de IA fica muito abaixo deste limite.
- O serviço não devolve dados pessoais nem informação de conta.
Outras formas de acesso
- Servidor MCP para os clientes que o suportam: guia de ligação.
- Guias de hotéis: artigos.