{"openapi":"3.1.0","info":{"title":"Reaply","version":"1.1.0","contact":{"email":"contact@reaply.ai"},"description":"Les avis de toutes les plateformes (Google, Booking.com, Tripadvisor, Airbnb, Expedia, Trip.com, TheFork, Uber Eats, Deliveroo, Trustpilot, Yelp…) en un seul format : notes converties sur 5 et sur l’échelle de chaque plateforme, analyse IA multilingue (sentiment, thèmes communs à toutes les langues, résumé), impact chiffré de chaque thème sur la note de chaque plateforme, concurrence, réponses soumises à validation, webhooks signés, export CSV et serveur MCP pour les assistants IA (OAuth 2.1). Limite : 300 requêtes par heure et par compte (429 au-delà)."},"servers":[{"url":"https://mcp.reaply.ai"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Clé Reaply (rcx_…) ou jeton OAuth (rca_…)"},"oauth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://mcp.reaply.ai/oauth/authorize","tokenUrl":"https://mcp.reaply.ai/oauth/token","refreshUrl":"https://mcp.reaply.ai/oauth/token","scopes":{"reviews":"Lire les avis, les analyses et la concurrence","replies":"Soumettre des réponses à la validation de l’établissement"}}}}},"responses":{"Unauthorized":{"description":"Jeton absent, invalide ou expiré","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"Établissement hors du compte","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Trop de requêtes (300 par heure)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string","examples":["property_required","forbidden_property","review_not_found","rate_limited"]}}},"Review":{"type":"object","properties":{"id":{"type":"string"},"property_id":{"type":"string"},"platform":{"type":"string"},"platform_label":{"type":"string"},"date":{"type":"string","format":"date"},"author":{"type":["string","null"]},"rating_5":{"type":["number","null"],"description":"Note convertie sur 5"},"rating_raw":{"type":["number","null"]},"scale":{"type":["number","null"],"description":"Échelle de la plateforme (5, 6 ou 10)"},"title":{"type":"string"},"text":{"type":"string"},"replied":{"type":"boolean"},"reply":{"type":"string"},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral",null]},"themes":{"type":"array","items":{"type":"object","properties":{"theme":{"type":"string"},"sentiment":{"type":"string"}}}},"summary":{"type":["string","null"]},"needs_attention":{"type":"boolean"},"analysis":{"type":"string","enum":["done","pending","no_text"]}}},"ReviewPage":{"type":"object","properties":{"reviews":{"type":"array","items":{"$ref":"#/components/schemas/Review"}},"returned":{"type":"integer"},"next_cursor":{"type":["string","null"]}}},"ReviewDetail":{"allOf":[{"$ref":"#/components/schemas/Review"},{"type":"object","properties":{"emotions":{"type":["object","null"]},"category":{"type":["string","null"]},"reply_policy":{"type":"object","properties":{"publish":{"type":"string","enum":["official_api","one_click_in_platform"]},"how":{"type":"string"},"max_chars":{"type":["integer","null"]},"manage_url":{"type":["string","null"]}}}}}]},"Stats":{"type":"object","properties":{"rating":{"type":["number","null"],"description":"Note globale /5 pondérée par le nombre d’avis"},"count":{"type":"integer"},"method":{"type":"string"},"platforms":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string"},"label":{"type":"string"},"url":{"type":"string"},"rating":{"type":["number","null"]},"rating_raw":{"type":["number","null"]},"scale":{"type":"number"},"count":{"type":["integer","null"]},"imported":{"type":"integer"},"replied":{"type":"integer"}}}},"sentiment":{"type":"object","additionalProperties":{"type":"integer"}}}},"Insights":{"type":"object","description":"Ce qui fait la note : thèmes, impact en points, tendance sur 90 jours, simulation de la note officielle de chaque plateforme si les mentions négatives d’un thème disparaissaient.","properties":{"analysed_reviews":{"type":"integer"},"average_rating_5":{"type":["number","null"]},"method":{"type":"string"},"priorities":{"type":"array","items":{"type":"object","properties":{"theme":{"type":"string"},"negative_mentions":{"type":"integer"},"overall_gain_5":{"type":"number"},"trend":{"type":"string"},"platforms":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string"},"scale":{"type":"number"},"official_rating":{"type":["number","null"]},"potential_rating":{"type":["number","null"]},"gain":{"type":"number"}}}}}}},"strengths":{"type":"array","items":{"type":"object"}},"themes":{"type":"array","items":{"type":"object"}}}},"Competitors":{"type":"object","properties":{"platforms":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string"},"you":{"type":["object","null"]},"rank":{"type":["integer","null"]},"of":{"type":"integer"},"competitors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"rating_5":{"type":["number","null"]},"count":{"type":["integer","null"]},"gap_5":{"type":["number","null"]},"strengths":{"type":"array"},"weaknesses":{"type":"array"}}}}}}}}},"Reply":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["queued","done"]},"platform":{"type":"string"},"publish":{"type":"string"},"how":{"type":"string"},"deep_link":{"type":["string","null"]}}},"Webhook":{"type":"object","properties":{"event":{"type":"string","enum":["review.created","review.updated"]},"property_id":{"type":"string"},"sent_at":{"type":"string","format":"date-time"},"reviews":{"type":"array","items":{"type":"object"}}}}}},"security":[{"bearer":[]},{"oauth":["reviews"]}],"paths":{"/v1/properties":{"get":{"summary":"Établissements du compte, avec leurs notes par plateforme","operationId":"listProperties","responses":{"200":{"description":"Liste { properties: [{ id, name, rating_5, reviews, platforms }] }"}}},"post":{"summary":"Offre partenaire : créer l’établissement d’un de vos clients (renvoie un code pour relier son extension Reaply Connect)","operationId":"createProperty","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"settings":{"type":"object","properties":{"tone":{"type":"string"},"signature":{"type":"string"}}}}}}}}}},"/v1/reviews":{"get":{"summary":"Rechercher des avis, toutes plateformes","operationId":"searchReviews","parameters":[{"name":"property","in":"query","required":false,"description":"Établissement (facultatif si le compte n’en a qu’un ; voir /v1/properties)","schema":{"type":"string"}},{"name":"platform","in":"query","required":false,"description":"Plateforme","schema":{"type":"string","enum":["google","booking","tripadvisor","airbnb","expedia","hotels","trustpilot","thefork","ubereats","deliveroo","justeat","yelp","facebook","agoda","holidaycheck","pagesjaunes","trustedshops","avisverifies","tripcom","hrs","hostelworld","vrbo","opentable","petitfute","dianping","yandex"]}},{"name":"query","in":"query","required":false,"description":"Mots présents dans l’avis","schema":{"type":"string"}},{"name":"theme","in":"query","required":false,"description":"Thème (petit-déjeuner, bruit, accueil…)","schema":{"type":"string"}},{"name":"sentiment","in":"query","required":false,"schema":{"type":"string","enum":["positive","negative","neutral"]}},{"name":"min_rating","in":"query","required":false,"description":"Note minimale /5","schema":{"type":"number"}},{"name":"max_rating","in":"query","required":false,"description":"Note maximale /5","schema":{"type":"number"}},{"name":"unreplied","in":"query","required":false,"description":"Sans réponse","schema":{"type":"boolean"}},{"name":"since","in":"query","required":false,"description":"AAAA-MM-JJ","schema":{"type":"string","format":"date"}},{"name":"until","in":"query","required":false,"description":"AAAA-MM-JJ","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"1 à 100","schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"description":"Page suivante (next_cursor)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewPage"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/reviews/{id}":{"get":{"summary":"Un avis, son analyse et la règle de réponse de sa plateforme","operationId":"getReview","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewDetail"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/stats":{"get":{"summary":"Notes officielles par plateforme, note globale pondérée, sentiment","operationId":"getStats","parameters":[{"name":"property","in":"query","required":false,"description":"Établissement (facultatif si le compte n’en a qu’un ; voir /v1/properties)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Stats"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/insights":{"get":{"summary":"Ce qui fait la note : impact de chaque thème et note possible sur chaque plateforme","operationId":"getInsights","parameters":[{"name":"property","in":"query","required":false,"description":"Établissement (facultatif si le compte n’en a qu’un ; voir /v1/properties)","schema":{"type":"string"}},{"name":"platform","in":"query","required":false,"description":"Plateforme","schema":{"type":"string","enum":["google","booking","tripadvisor","airbnb","expedia","hotels","trustpilot","thefork","ubereats","deliveroo","justeat","yelp","facebook","agoda","holidaycheck","pagesjaunes","trustedshops","avisverifies","tripcom","hrs","hostelworld","vrbo","opentable","petitfute","dianping","yandex"]}},{"name":"since","in":"query","required":false,"schema":{"type":"string"}},{"name":"until","in":"query","required":false,"schema":{"type":"string"}},{"name":"min_mentions","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Insights"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/competitors":{"get":{"summary":"Concurrence plateforme par plateforme","operationId":"getCompetitors","parameters":[{"name":"property","in":"query","required":false,"description":"Établissement (facultatif si le compte n’en a qu’un ; voir /v1/properties)","schema":{"type":"string"}},{"name":"platform","in":"query","required":false,"description":"Plateforme","schema":{"type":"string","enum":["google","booking","tripadvisor","airbnb","expedia","hotels","trustpilot","thefork","ubereats","deliveroo","justeat","yelp","facebook","agoda","holidaycheck","pagesjaunes","trustedshops","avisverifies","tripcom","hrs","hostelworld","vrbo","opentable","petitfute","dianping","yandex"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Competitors"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/coverage":{"get":{"summary":"Avis lus et analysés par plateforme","operationId":"getCoverage","parameters":[{"name":"property","in":"query","required":false,"description":"Établissement (facultatif si le compte n’en a qu’un ; voir /v1/properties)","schema":{"type":"string"}}]}},"/v1/listings":{"get":{"summary":"Pages d’avis suivies","parameters":[{"name":"property","in":"query","required":false,"description":"Établissement (facultatif si le compte n’en a qu’un ; voir /v1/properties)","schema":{"type":"string"}}]},"post":{"summary":"Suivre une page d’avis (plateforme détectée depuis l’URL ; peer pour un concurrent)","operationId":"addListing","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string"},"property":{"type":"string"},"peer":{"type":"string"},"peer_name":{"type":"string"}}}}}}}},"/v1/reply-draft":{"post":{"summary":"Proposition de réponse (IA, langue de l’avis) ; rien n’est publié","operationId":"draftReply","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"review_id":{"type":"string"},"review_text":{"type":"string"},"platform":{"type":"string"},"property":{"type":"string"}}}}}}}},"/v1/replies":{"get":{"summary":"Réponses en attente de validation (queued) ou publiées (done)","parameters":[{"name":"property","in":"query","required":false,"description":"Établissement (facultatif si le compte n’en a qu’un ; voir /v1/properties)","schema":{"type":"string"}},{"name":"platform","in":"query","required":false,"description":"Plateforme","schema":{"type":"string","enum":["google","booking","tripadvisor","airbnb","expedia","hotels","trustpilot","thefork","ubereats","deliveroo","justeat","yelp","facebook","agoda","holidaycheck","pagesjaunes","trustedshops","avisverifies","tripcom","hrs","hostelworld","vrbo","opentable","petitfute","dianping","yandex"]}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["queued","done"]}}]},"post":{"summary":"Soumettre une réponse à la validation de l’établissement","operationId":"queueReply","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["review_id","text"],"properties":{"review_id":{"type":"string"},"text":{"type":"string"},"property":{"type":"string"}}}}}},"responses":{"201":{"description":"En attente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Reply"}}}}}}},"/v1/replies/{id}/done":{"post":{"summary":"Marquer une réponse publiée","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/webhooks":{"get":{"summary":"Webhooks du compte"},"post":{"summary":"Recevoir review.created / review.updated (signature x-reaply-signature: sha256=HMAC du corps, 6 nouvelles tentatives)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string"},"events":{"type":"array","items":{"type":"string","enum":["review.created","review.updated"]}}}}}}}}},"/v1/webhooks/{id}":{"delete":{"summary":"Supprimer un webhook","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/export.csv":{"get":{"summary":"Export CSV (Excel)","parameters":[{"name":"property","in":"query","required":false,"description":"Établissement (facultatif si le compte n’en a qu’un ; voir /v1/properties)","schema":{"type":"string"}}]}},"/v1/connect-code":{"post":{"summary":"Code de connexion à 8 caractères (10 minutes) pour relier un assistant IA ou l’extension"}},"/v1/usage":{"get":{"summary":"Appels du mois et limites de l’offre (included 20 000/mois, developer 100 000, partner 1 000 000)"}},"/v1/keys":{"get":{"summary":"Clés du compte"},"post":{"summary":"Créer une clé (affichée une seule fois)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"label":{"type":"string"}}}}}}}},"/v1/keys/{id}":{"delete":{"summary":"Révoquer une clé","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/ingest":{"post":{"summary":"Entrée des capteurs (Reaply Connect, API officielles, partenaires)"}},"/mcp":{"post":{"summary":"Serveur MCP (Streamable HTTP, JSON-RPC 2.0, OAuth 2.1) : 14 outils et 4 invites pour ChatGPT, Claude, Cursor…","security":[{"oauth":["reviews","replies"]},{"bearer":[]}]}},"/widget/v1/summary":{"get":{"summary":"Note publique du widget","security":[],"parameters":[{"name":"p","in":"query","required":true,"schema":{"type":"string"}}]}}}}