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ètre | Obligatoire | Format et limites |
|---|---|---|
destination | oui | Nom de ville ou de région, de 2 à 80 caractères, par exemple Dubai, Istanbul, Paris (de préférence en anglais). |
checkin | oui | Date YYYY-MM-DD : aujourd'hui ou plus tard (UTC), au plus 365 jours à l'avance. |
checkout | oui | Date YYYY-MM-DD, postérieure à l'arrivée ; au plus 30 nuits. |
adults | non, 2 par défaut | Nombre entier de 1 à 6. |
children_ages | non | Âges des enfants séparés par des virgules, de 0 à 17, au plus 4 enfants, par exemple 5,12. |
currency | non, USD par défaut | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | non | Prix par nuit dans la devise choisie, de 0 à 100000. |
limit | non, 10 par défaut | Nombre entier de 1 à 20. |
lang | non, en par défaut | Langue 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
- Hôtels à Dubaï pour deux personnes, du 10 au 15 novembre 2026, jusqu'à 150 USD par nuit, 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 - Une famille de deux adultes et un enfant de 7 ans à Istanbul, page HTML :
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
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 :
hotel:id,name,star_rating,address(le nom et l'adresse peuvent êtrenullsi la fiche de l'hôtel n'est pas dans nos données locales).room:namedu tarif le moins cher pour les dates et le type de repasmeal(room_only,breakfast,half_board,full_board,all_inclusiveet autres).price:totalpour tout le séjour,per_nightetcurrency.taxes:included_in_price(true, false ou null si inconnu) etnot_included— taxes ou frais payés séparément, généralement à l'hôtel, avec leur montant et leur devise.payment:typevautpay_now(paiement sur la page de réservation) oupay_at_hotel.cancellation:typevautfree_until(avec l'heurefree_untilen UTC),partial,non_refundableouunknown;penaltiesliste les montants par période.availability:statusavailable,checked_at(moment de la recherche, UTC) etrequires_recheck= true : le prix et la chambre sont confirmés sur la page de réservation.booking_url: la page de réservation roomesto.com avec les mêmes dates, les mêmes voyageurs et la même devise.
Règles d'utilisation
- Affichez les prix avec la date, la devise et l'heure
checked_at: ils peuvent changer avant la réservation. - Affichez les taxes de
not_includedà côté du prix. Siincluded_in_pricevaut null, indiquez que les taxes sont inconnues. - Envoyez le voyageur vers le lien
booking_url. La réservation et le paiement se font sur roomesto.com. - Les pages de résultats portent
noindex; cette page et la documentation sont destinées à l'indexation. - Limite : 120 requêtes par minute et par adresse IP. Le trafic habituel des assistants IA reste bien en dessous de cette limite.
- Le service ne renvoie ni données personnelles ni informations de compte.
Autres accès
- Serveur MCP pour les clients qui le prennent en charge : guide de connexion.
- Guides d'hôtels : articles.