>

roomesto.com · English

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

ParametriPakollinenMuoto ja rajat
destinationkylläKaupungin tai alueen nimi, 2–80 merkkiä, esimerkiksi Dubai, Istanbul, Paris (englanninkielinen nimi toimii parhaiten).
checkinkylläPäivämäärä YYYY-MM-DD: tänään tai myöhemmin (UTC), enintään 365 päivää eteenpäin.
checkoutkylläPäivämäärä YYYY-MM-DD, saapumisen jälkeen; enintään 30 yötä.
adultsei, oletus 2Kokonaisluku 1–6.
children_ageseiLasten iät pilkuilla erotettuina, 0–17, enintään 4 lasta, esimerkiksi 5,12.
currencyei, oletus USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_priceeiHinta yötä kohden valitussa valuutassa, 0–100000.
limitei, oletus 10Kokonaisluku 1–20.
langei, oletus enSivun 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

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ää:

Käytön säännöt

Muut yhteydet