>

roomesto.com · English

Hotellsökning för AI-assistenter

roomesto.com svarar på hotellsökningar med aktuella priser och tillgänglighet via en vanlig GET-förfrågan. Konto, API-nyckel, cookies, JavaScript eller MCP-klient behövs inte. Samma sökmotor driver webbplatsen.

Adress för förfrågan

GET https://roomesto.com/ai/hotels returnerar en HTML-sida med resultat som går att läsa utan JavaScript. Lägg till format=json (eller anropa /ai/hotels.json, eller skicka Accept: application/json) för strukturerad JSON.

Parametrar

ParameterObligatoriskFormat och gränser
destinationjaStad eller region, 2 till 80 tecken, till exempel Dubai, Istanbul, Paris (engelsk stavning fungerar bäst).
checkinjaDatum YYYY-MM-DD: i dag eller senare (UTC), högst 365 dagar framåt.
checkoutjaDatum YYYY-MM-DD, efter incheckningen; högst 30 nätter.
adultsnej, standard 2Heltal från 1 till 6.
children_agesnejBarnens åldrar kommaseparerade, 0 till 17, högst 4 barn, till exempel 5,12.
currencynej, standard USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_pricenejPris per natt i vald valuta, från 0 till 100000.
limitnej, standard 10Heltal från 1 till 20.
langnej, standard enSpråk för sidan och hotellnamnen: 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 (hotellnamn på leverantörens språk en, ru, de, es, fr, tr, it, annars på engelska).

Exempel

JSON-svar

status är en av ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, med en lista errors av param och message) eller provider_unavailable (503: inga resultat och inga priser, inget gissas när leverantörens sökning misslyckas).

data_status visar var resultaten kommer från: live — sökningen gjordes nyss; cached — en nylig sökning återanvänds; stale — en äldre sökning medan nya är begränsade; partial — leverantören skickade fortfarande hotell när väntetiden tog slut (hotels_received anger hur många hotell som kom; ett sådant svar cachas inte, upprepa samma förfrågan senare).

Varje element i results innehåller:

Regler för användning

Andra vägar in