>

roomesto.com · English

Recherche d'hôtels pour les assistants IA

roomesto.com répond aux demandes de recherche d'hôtels avec des prix et une disponibilité en direct via une simple requête GET. Aucun compte, clé API, cookie, JavaScript ni client MCP n'est nécessaire. Le même moteur de recherche fait fonctionner le site.

Adresse de la requête

GET https://roomesto.com/ai/hotels renvoie une page HTML de résultats lisible sans JavaScript. Ajoutez format=json (ou appelez /ai/hotels.json, ou envoyez Accept: application/json) pour obtenir du JSON structuré.

Paramètres

ParamètreObligatoireFormat et limites
destinationouiNom de ville ou de région, de 2 à 80 caractères, par exemple Dubai, Istanbul, Paris (de préférence en anglais).
checkinouiDate YYYY-MM-DD : aujourd'hui ou plus tard (UTC), au plus 365 jours à l'avance.
checkoutouiDate YYYY-MM-DD, postérieure à l'arrivée ; au plus 30 nuits.
adultsnon, 2 par défautNombre entier de 1 à 6.
children_agesnonÂges des enfants séparés par des virgules, de 0 à 17, au plus 4 enfants, par exemple 5,12.
currencynon, USD par défautUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_pricenonPrix par nuit dans la devise choisie, de 0 à 100000.
limitnon, 10 par défautNombre entier de 1 à 20.
langnon, en par défautLangue de la page et des noms d'hôtels : 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 (noms d'hôtels dans les langues du fournisseur en, ru, de, es, fr, tr, it, sinon en anglais).

Exemples

Réponse JSON

status vaut ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, avec une liste errors composée de param et message) ou provider_unavailable (503 : aucun résultat et aucun prix, rien n'est deviné lorsque la recherche du fournisseur échoue).

data_status indique l'origine des résultats : live — la recherche vient d'être lancée ; cached — une recherche récente est réutilisée ; stale — une recherche ancienne pendant que les nouvelles sont limitées ; partial — le fournisseur renvoyait encore des hôtels quand le délai d'attente a expiré (hotels_received indique combien d'hôtels sont arrivés ; une telle réponse n'est pas mise en cache, répétez la même requête plus tard).

Chaque élément de results contient :

Règles d'utilisation

Autres accès