Rateshopper · API de rate shopping · v0.1
On donne l'URL du moteur de réservation d'un hôtel et des dates ; le service identifie le moteur parmi ceux qu'il connaît, l'interroge en temps réel et rend des offres normalisées. Pas d'interface applicative, pas de prix stockés : une API de lecture — et, ci-dessous, de quoi l'essayer tout de suite.
Colle l'URL d'un moteur de réservation, choisis les dates, lis le résultat. Ce banc n'a aucun
privilège : il appelle /rates et /calendar comme n'importe quel client,
avec la clef renseignée ci-dessous.
Trois routes de données, une clef en en-tête. Le détail — paramètres, forme des réponses, pièges à ne pas commettre — est dans la documentation.
# Le tarif d'un séjour précis
curl -s -H 'X-API-Key: VOTRE_CLEF' \
'https://rateshopper.vadech.tech/rates?url=<url_du_moteur>&checkin=2026-09-10&checkout=2026-09-12&adults=2'
# La grille des prix sur 30 dates d'arrivée
curl -s -H 'X-API-Key: VOTRE_CLEF' \
'https://rateshopper.vadech.tech/calendar?url=<url_du_moteur>&from=2026-09-01&days=30'
# Cinq concurrents sur plusieurs dates, en un appel
curl -s -X POST 'https://rateshopper.vadech.tech/rates/batch' \
-H 'X-API-Key: VOTRE_CLEF' -H 'content-type: application/json' \
-d '{"urls": [...], "dates": [{"checkin":"2026-09-10","nights":2}]}'
Un hôtel complet n'est pas une erreur. available:false avec
offers:[] en HTTP 200 signifie « rien de disponible » ; une source injoignable rend une
erreur typée (502/504). Tout le yield en aval s'appuie sur cette distinction.
Un montant basis:"night" ne se multiplie pas par le nombre de nuits :
le moteur n'a publié qu'un prix d'appel par nuit. Les deux autres pièges sont dans la documentation —
ils produisent tous un prix faux, et un prix faux est pire qu'une absence de prix.
Routes, paramètres, forme des réponses, codes d'erreur, et de quoi outiller un LLM.
GET /openapi.jsonOpenAPI 3.1, généré depuis le registre d'adapters. À donner tel quel à un générateur de client.
GET /llms.txtCe que le schéma ne peut pas dire, en texte brut, taillé pour tenir dans un contexte.
GET /moteursQuels moteurs équipent l'hôtellerie française, et dans quel ordre les brancher. Mesuré sur 1 326 sites.