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 | 아니요, 기본값 2 | 1~6 사이의 정수. |
children_ages | 아니요 | 자녀 나이를 쉼표로 구분, 0~17세, 최대 4명, 예: 5,12. |
currency | 아니요, 기본값 USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | 아니요 | 선택한 통화 기준 1박 가격, 0~100000. |
limit | 아니요, 기본값 10 | 1~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로, 그 밖의 언어는 영어). |
예시
- 두바이 호텔, 2인, 2026년 11월 10일~15일, 1박 최대 150 USD, 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 - 이스탄불, 성인 2명과 7세 어린이 가족, HTML 페이지:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
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 의 각 항목에는 다음이 포함됩니다:
hotel:id,name,star_rating,address(로컬 데이터에 호텔 카드가 없으면 이름과 주소가null일 수 있습니다).room: 해당 날짜의 가장 저렴한 객실 요금의name과meal식사 유형(room_only,breakfast,half_board,full_board,all_inclusive등).price: 전체 숙박의total,per_night,currency.taxes:included_in_price(true, false, 알 수 없으면 null)와not_included— 보통 호텔에서 따로 지불하는 세금과 수수료로, 각각 금액과 통화가 있습니다.payment:type은pay_now(예약 페이지에서 결제) 또는pay_at_hotel입니다.cancellation:type은free_until(UTC 기준free_until시각 포함),partial,non_refundable,unknown중 하나이며,penalties는 기간별 금액을 나열합니다.availability:statusavailable,checked_at(검색을 실행한 시각, UTC),requires_recheck= true: 가격과 객실은 예약 페이지에서 확인됩니다.booking_url: 같은 날짜, 인원, 통화의 roomesto.com 예약 페이지.
사용 규칙
- 가격을 날짜, 통화,
checked_at시각과 함께 보여 주세요. 예약 전에 바뀔 수 있습니다. not_included의 세금을 가격 옆에 표시하세요.included_in_price가 null이면 세금을 알 수 없다고 안내하세요.- 여행자를
booking_url링크로 안내하세요. 예약과 결제는 roomesto.com에서 이루어집니다. - 결과 페이지에는
noindex가 표시되어 있습니다. 색인 대상은 이 페이지와 문서입니다. - 제한: IP 주소당 분당 120회 요청. 일반적인 AI 어시스턴트 트래픽은 이 한도보다 훨씬 적습니다.
- 이 서비스는 개인정보나 계정 정보를 반환하지 않습니다.