>

roomesto.com · English

AI 어시스턴트용 호텔 검색

roomesto.com은 호텔 검색 요청에 실시간 가격과 예약 가능 여부를 일반 GET 요청으로 응답합니다. 계정, API 키, 쿠키, JavaScript, MCP 클라이언트가 필요 없습니다. 사이트에서 쓰는 것과 같은 검색 엔진입니다.

요청 주소

GET https://roomesto.com/ai/hotels 는 JavaScript 없이 읽을 수 있는 HTML 결과 페이지를 반환합니다. 구조화된 JSON을 받으려면 format=json 을 추가하거나 /ai/hotels.json 을 호출하거나 Accept: application/json 헤더를 보내세요.

매개변수

매개변수필수형식 및 제한
destination예도시 또는 지역 이름, 2~80자, 예: Dubai, Istanbul, Paris (영문 이름이 가장 잘 맞습니다).
checkin예날짜 YYYY-MM-DD: 오늘 이후(UTC), 최대 365일 전까지.
checkout예날짜 YYYY-MM-DD, 체크인 이후, 최대 30박.
adults아니요, 기본값 21~6 사이의 정수.
children_ages아니요자녀 나이를 쉼표로 구분, 0~17세, 최대 4명, 예: 5,12.
currency아니요, 기본값 USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_price아니요선택한 통화 기준 1박 가격, 0~100000.
limit아니요, 기본값 101~20 사이의 정수.
lang아니요, 기본값 en페이지와 호텔 이름의 언어: 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 (호텔 이름은 공급사 언어 en, ru, de, es, fr, tr, it로, 그 밖의 언어는 영어).

예시

JSON 응답

status 는 ok, no_results(HTTP 200), destination_not_found(404), invalid_request(400, param 과 message 로 구성된 errors 목록 포함), 또는 provider_unavailable(503: 결과도 가격도 없음, 공급사 검색이 실패하면 아무것도 추측하지 않습니다) 중 하나입니다.

data_status 는 결과의 출처를 보여줍니다: live — 검색을 방금 실행함, cached — 최근 검색을 재사용함, stale — 새 검색이 제한된 동안의 이전 검색, partial — 대기 시간이 끝났을 때 공급사가 아직 호텔을 반환하고 있던 상태(hotels_received 는 받은 호텔 수, 이런 응답은 캐시되지 않으므로 같은 요청을 나중에 반복하세요).

results 의 각 항목에는 다음이 포함됩니다:

사용 규칙

다른 접속 방법