Hotellihaku tekoälyavustajille
roomesto.com vastaa hotellihakupyyntöihin ajantasaisilla hinnoilla ja saatavuudella tavallisella GET-pyynnöllä. Tiliä, API-avainta, evästeitä, JavaScriptiä tai MCP-asiakasta ei tarvita. Sama hakukone pyörittää sivustoa.
Pyynnön osoite
GET https://roomesto.com/ai/hotels palauttaa HTML-tulosivun, joka on luettavissa ilman JavaScriptiä. Lisää format=json (tai kutsu /ai/hotels.json tai lähetä Accept: application/json), niin saat jäsennellyn JSONin.
Parametrit
| Parametri | Pakollinen | Muoto ja rajat |
|---|---|---|
destination | kyllä | Kaupungin tai alueen nimi, 2–80 merkkiä, esimerkiksi Dubai, Istanbul, Paris (englanninkielinen nimi toimii parhaiten). |
checkin | kyllä | Päivämäärä YYYY-MM-DD: tänään tai myöhemmin (UTC), enintään 365 päivää eteenpäin. |
checkout | kyllä | Päivämäärä YYYY-MM-DD, saapumisen jälkeen; enintään 30 yötä. |
adults | ei, oletus 2 | Kokonaisluku 1–6. |
children_ages | ei | Lasten iät pilkuilla erotettuina, 0–17, enintään 4 lasta, esimerkiksi 5,12. |
currency | ei, oletus USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | ei | Hinta yötä kohden valitussa valuutassa, 0–100000. |
limit | ei, oletus 10 | Kokonaisluku 1–20. |
lang | ei, oletus en | Sivun ja hotellien nimien kieli: 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 (hotellien nimet toimittajan kielillä en, ru, de, es, fr, tr, it, muuten englanniksi). |
Esimerkit
- Hotellit Dubaissa kahdelle, 10.–15. marraskuuta 2026, enintään 150 USD yöltä, 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 - Perhe, kaksi aikuista ja 7-vuotias lapsi Istanbulissa, HTML-sivu:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
JSON-vastaus
status on jokin seuraavista: ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, mukana errors-lista, jossa on param ja message) tai provider_unavailable (503: ei tuloksia eikä hintoja, mitään ei arvailla, kun toimittajan haku epäonnistuu).
data_status kertoo, mistä tulokset tulevat: live — haku tehtiin juuri; cached — äskettäistä hakua käytetään uudelleen; stale — vanhempi haku, kun uudet haut ovat rajoitettuja; partial — toimittaja lähetti vielä hotelleja, kun odotusaika päättyi (hotels_received kertoo, montako hotellia saapui; tällaista vastausta ei tallenneta välimuistiin, toista sama pyyntö myöhemmin).
Jokainen results-alkio sisältää:
hotel:id,name,star_rating,address(nimi ja osoite voivat ollanull, jos hotellikortti ei ole paikallisissa tiedoissamme).room: päivien halvimman huonehinnannameja ateriasuunnitelmameal(room_only,breakfast,half_board,full_board,all_inclusiveja muita).price:totalkoko oleskelulle,per_nightjacurrency.taxes:included_in_price(true, false tai null, kun tuntematon) janot_included— erikseen maksettavat verot tai maksut, yleensä hotellissa, omalla summalla ja valuutalla.payment:typeonpay_now(maksu varaussivulla) taipay_at_hotel.cancellation:typeonfree_until(aikafree_untilUTC:nä),partial,non_refundabletaiunknown;penaltiesluettelee summat jaksoittain.availability:statusavailable,checked_at(milloin haku tehtiin, UTC) jarequires_recheck= true: hinta ja huone vahvistetaan varaussivulla.booking_url: roomesto.comin varaussivu samoilla päivillä, vierailla ja valuutalla.
Käytön säännöt
- Näytä hinnat yhdessä päivämäärän, valuutan ja
checked_at-ajan kanssa: ne voivat muuttua ennen varausta. - Näytä
not_included-verot hinnan vieressä. Josincluded_in_priceon null, kerro, että verot eivät ole tiedossa. - Ohjaa matkustaja
booking_url-linkkiin. Varaus ja maksu tapahtuvat roomesto.comissa. - Tulosivut on merkitty
noindex-merkinnällä; tämä sivu ja dokumentaatio on tarkoitettu indeksoitaviksi. - Raja: 120 pyyntöä minuutissa IP-osoitetta kohden. Tekoälyavustajien tavallinen liikenne on selvästi tämän rajan alla.
- Palvelu ei palauta henkilötietoja eikä tilitietoja.
Muut yhteydet
- MCP-palvelin sitä tukeville asiakkaille: yhdistämisohje.
- Hotellioppaat: artikkelit.