ค้นหาโรงแรมสำหรับผู้ช่วย AI
roomesto.com ตอบคำขอค้นหาโรงแรมด้วยราคาและห้องว่างล่าสุดผ่านคำขอ GET ธรรมดา ไม่ต้องมีบัญชี คีย์ API คุกกี้ JavaScript หรือไคลเอนต์ MCP ระบบค้นหาเดียวกันนี้ใช้งานบนเว็บไซต์
ที่อยู่คำขอ
GET https://roomesto.com/ai/hotels ส่งคืนหน้าผลลัพธ์แบบ HTML ที่อ่านได้โดยไม่ต้องใช้ JavaScript เพิ่ม format=json (หรือเรียก /ai/hotels.json หรือส่ง Accept: application/json) เพื่อรับ 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 | ไม่ | ราคาต่อคืนในสกุลเงินที่เลือก 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 นอกนั้นเป็นภาษาอังกฤษ) |
ตัวอย่าง
- โรงแรมในดูไบสำหรับสองท่าน วันที่ 10 ถึง 15 พฤศจิกายน 2026 ไม่เกิน 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 - ครอบครัวผู้ใหญ่สองคนและเด็กอายุ 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 พร้อมรายการ errors ที่มี param และ message) หรือ 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และcurrencytaxes:included_in_price(true, false หรือ null เมื่อไม่ทราบ) และnot_included— ภาษีหรือค่าธรรมเนียมที่จ่ายแยก โดยปกติที่โรงแรม พร้อมจำนวนเงินและสกุลเงินของตัวเองpayment:typeเป็นpay_now(ชำระบนหน้าจอง) หรือpay_at_hotelcancellation:typeเป็นfree_until(พร้อมเวลาfree_untilใน UTC),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ส่วนหน้า nàyและเอกสารมีไว้ให้จัดทำดัชนี - ขีดจำกัด: 120 คำขอต่อนาทีต่อหนึ่ง IP แอดเดรส ปริมาณการใช้งานปกติของผู้ช่วย AI ต่ำกว่าขีดจำกัดนี้มาก
- บริการนี้ไม่ส่งคืนข้อมูลส่วนบุคคลหรือข้อมูลบัญชี
วิธีเข้าถึงอื่น ๆ
- เซิร์ฟเวอร์ MCP สำหรับไคลเอนต์ที่รองรับ: คู่มือการเชื่อมต่อ
- คู่มือโรงแรม: บทความ