>

roomesto.com · English

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

ParametreZorunluBiçim ve sınırlar
destinationevetŞehir veya bölge adı, 2 ile 80 karakter arası, örneğin Dubai, Istanbul, Paris (İngilizce ad en iyi sonucu verir).
checkinevetTarih YYYY-MM-DD: bugün veya sonrası (UTC), en fazla 365 gün ileri.
checkoutevetTarih YYYY-MM-DD, giriş tarihinden sonra; en fazla 30 gece.
adultshayır, varsayılan 21 ile 6 arasında tam sayı.
children_ageshayırÇocuk yaşları virgülle ayrılmış, 0-17, en fazla 4 çocuk, örneğin 5,12.
currencyhayır, varsayılan USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_pricehayırSeçilen para biriminde gecelik fiyat, 0 ile 100000 arası.
limithayır, varsayılan 101 ile 20 arasında tam sayı.
langhayır, varsayılan enSayfanı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

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:

Kullanım kuralları

Diğer erişim yolları