Yapay zekâ asistanları için otel araması
roomesto.com, otel arama isteklerini basit bir GET isteğiyle canlı fiyat ve müsaitlik bilgisiyle yanıtlar. Hesap, API anahtarı, çerez, JavaScript veya MCP istemcisi gerekmez. Sitede çalışan arama motorunun aynısı kullanılır.
İstek adresi
GET https://roomesto.com/ai/hotels JavaScript olmadan okunabilen bir HTML sonuç sayfası döndürür. Yapılandırılmış JSON için format=json ekleyin (veya /ai/hotels.json adresini çağırın ya da Accept: application/json başlığını gönderin).
Parametreler
| Parametre | Zorunlu | Biçim ve sınırlar |
|---|---|---|
destination | evet | Şehir veya bölge adı, 2 ile 80 karakter arası, örneğin Dubai, Istanbul, Paris (İngilizce ad en iyi sonucu verir). |
checkin | evet | Tarih YYYY-MM-DD: bugün veya sonrası (UTC), en fazla 365 gün ileri. |
checkout | evet | Tarih YYYY-MM-DD, giriş tarihinden sonra; en fazla 30 gece. |
adults | hayır, varsayılan 2 | 1 ile 6 arasında tam sayı. |
children_ages | hayır | Çocuk yaşları virgülle ayrılmış, 0-17, en fazla 4 çocuk, örneğin 5,12. |
currency | hayır, varsayılan USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | hayır | Seçilen para biriminde gecelik fiyat, 0 ile 100000 arası. |
limit | hayır, varsayılan 10 | 1 ile 20 arasında tam sayı. |
lang | hayır, varsayılan en | Sayfanın ve otel adlarının dili: 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 (otel adları sağlayıcı dillerinde: en, ru, de, es, fr, tr, it; diğerlerinde İngilizce). |
Örnekler
- Dubai'de iki kişi için oteller, 10-15 Kasım 2026, gecelik en fazla 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 - İstanbul'da iki yetişkin ve 7 yaşında bir çocuktan oluşan aile, HTML sayfası:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
JSON yanıtı
status şu değerlerden biridir: ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, param ve message alanlarından oluşan errors listesiyle) veya provider_unavailable (503: sonuç ve fiyat yok; sağlayıcı araması çalışmadığında hiçbir şey tahmin edilmez).
data_status sonuçların kaynağını gösterir: live — arama az önce yapıldı; cached — yakın tarihli bir arama yeniden kullanıldı; stale — yeni aramalar sınırlıyken eski bir arama; partial — bekleme süresi dolduğunda sağlayıcı hâlâ otel döndürüyordu (hotels_received kaç otelin geldiğini gösterir; böyle bir yanıt önbelleğe alınmaz, aynı isteği daha sonra tekrarlayın).
results içindeki her öğe şunları içerir:
hotel:id,name,star_rating,address(otel kartı yerel verilerimizde yoksa ad ve adresnullolabilir).room: tarihler için en ucuz oda tarifesininnamealanı vemealyemek planı (room_only,breakfast,half_board,full_board,all_inclusiveve diğerleri).price: tüm konaklama içintotal,per_nightvecurrency.taxes:included_in_price(true, false veya bilinmiyorsa null) venot_included— genellikle otelde ayrıca ödenen, kendi tutarı ve para birimi olan vergi ve ücretler.payment:typedeğeripay_now(rezervasyon sayfasında ödenir) veyapay_at_hotel.cancellation:typedeğerifree_until(UTC olarakfree_untilzamanıyla),partial,non_refundableveyaunknown;penaltiesdönemlere göre tutarları listeler.availability:statusavailable,checked_at(aramanın yapıldığı an, UTC) verequires_recheck= true: fiyat ve oda rezervasyon sayfasında onaylanır.booking_url: aynı tarihler, misafirler ve para birimiyle roomesto.com rezervasyon sayfası.
Kullanım kuralları
- Fiyatları tarih, para birimi ve
checked_atsaatiyle birlikte gösterin: rezervasyona kadar değişebilirler. not_includediçindeki vergileri fiyatın yanında gösterin.included_in_pricenull ise vergilerin bilinmediğini belirtin.- Gezgini
booking_urlbağlantısına yönlendirin. Rezervasyon ve ödeme roomesto.com üzerinde yapılır. - Sonuç sayfaları
noindexolarak işaretlidir; bu sayfa ve belgeler indeksleme için tasarlanmıştır. - Sınır: IP adresi başına dakikada 120 istek. Olağan yapay zekâ asistanı trafiği bu sınırın çok altındadır.
- Hizmet kişisel veri ve hesap bilgisi döndürmez.
Diğer erişim yolları
- Destekleyen istemciler için MCP sunucusu: bağlantı kurma kılavuzu.
- Otel rehberleri: makaleler.