>

roomesto.com · English

ค้นหาโรงแรมสำหรับผู้ช่วย 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ไม่ ค่าเริ่มต้น USDUSD, 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 นอกนั้นเป็นภาษาอังกฤษ)

ตัวอย่าง

การตอบกลับแบบ 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 ประกอบด้วย:

กฎการใช้งาน

วิธีเข้าถึงอื่น ๆ