>

roomesto.com · English

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âmetroObrigatórioFormato e limites
destinationsimNome da cidade ou região, de 2 a 80 caracteres, por exemplo Dubai, Istanbul, Paris (de preferência em inglês).
checkinsimData YYYY-MM-DD: hoje ou mais tarde (UTC), no máximo 365 dias à frente.
checkoutsimData YYYY-MM-DD, depois da chegada; no máximo 30 noites.
adultsnão, padrão 2Número inteiro de 1 a 6.
children_agesnãoIdades das crianças separadas por vírgulas, de 0 a 17, no máximo 4 crianças, por exemplo 5,12.
currencynão, padrão USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_pricenãoPreço por noite na moeda escolhida, de 0 a 100000.
limitnão, padrão 10Número inteiro de 1 a 20.
langnão, padrão enIdioma 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

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:

Regras de utilização

Outras formas de acesso