>

roomesto.com · English

Hotelsøgning til AI-assistenter

roomesto.com svarer på hotelforespørgsler med aktuelle priser og ledighed via en almindelig GET-anmodning. Konto, API-nøgle, cookies, JavaScript eller MCP-klient er ikke nødvendig. Den samme søgemaskine driver webstedet.

Adresse for anmodningen

GET https://roomesto.com/ai/hotels returnerer en HTML-resultatside, der kan læses uden JavaScript. Tilføj format=json (eller kald /ai/hotels.json, eller send Accept: application/json) for at få struktureret JSON.

Parametre

ParameterPåkrævetFormat og grænser
destinationjaNavn på by eller region, 2 til 80 tegn, for eksempel Dubai, Istanbul, Paris (engelsk navn virker bedst).
checkinjaDato YYYY-MM-DD: i dag eller senere (UTC), højst 365 dage frem.
checkoutjaDato YYYY-MM-DD, efter indtjekning; højst 30 nætter.
adultsnej, standard 2Heltal fra 1 til 6.
children_agesnejBørnenes alder adskilt med kommaer, 0 til 17, højst 4 børn, for eksempel 5,12.
currencynej, standard USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_pricenejPris pr. nat i den valgte valuta, fra 0 til 100000.
limitnej, standard 10Heltal fra 1 til 20.
langnej, standard enSprog for siden og hotelnavnene: 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 (hotelnavne på leverandørens sprog en, ru, de, es, fr, tr, it, ellers på engelsk).

Eksempler

JSON-svar

status er en af ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, med en liste errors af param og message) eller provider_unavailable (503: ingen resultater og ingen priser, der gættes ikke på noget, når leverandørens søgning fejler).

data_status viser, hvor resultaterne kommer fra: live — søgningen blev netop kørt; cached — en nylig søgning genbruges; stale — en ældre søgning, mens nye er begrænsede; partial — leverandøren sendte stadig hoteller, da ventetiden udløb (hotels_received angiver, hvor mange hoteller der kom; et sådant svar caches ikke, gentag den samme anmodning senere).

Hvert element i results indeholder:

Regler for brug

Andre adgange