reviews.antworten
Reply publicly. THE CHECK COMES BEFORE SENDING, not after: whatever goes out here stays permanently on Airbnb or Booking.com, and Hospitable does not allow it to be changed afterwards. `darfAntworten()` decides; the error code is passed to the UI unchanged so that it can say WHAT the cause was. Mutation — changes data.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
reviewId | string | yes | |
text | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | boolean | yes | |
grund | string | no |
reviews.antwortentwurf
Draft reply to a review that has no reply yet, in the language of the review, polite, without making commitments. Draft only: nothing is published or stored. For Beds24 reviews, the reply is sent manually in the extranet (link in the response). Without `MISTRAL_API_KEY` (Mistral, EU), or if the service fails, `quelle: "vorlage"` returns a fixed template. Mutation — changes data.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
reviewId | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | boolean | yes | |
grund | string | no | |
text | string | no | |
sprache | string | no | |
quelle | enum | no | One of: ki, vorlage |
extranetName | string · nullable | no | |
extranetUrl | string · nullable | no |
reviews.gastbewertungSchreiben
Write and submit a guest review. FINAL AND PUBLIC, and unlike a reply it affects a PERSON: afterwards the text appears under the guest's name, and all 55 already sent have `is_editable_on_platform: false`. Mutation — changes data.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
reviewId | string | yes | |
text | string | yes | |
privatesFeedback | string | no | |
verzoegern | boolean | no | |
noten | object | yes | |
noten.rating | number | yes | |
noten.recommend | boolean | yes | |
noten.cleanliness | number | yes | |
noten.communication | number | yes | |
noten.respect_house_rules | number | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | boolean | yes | |
grund | string | no |
reviews.gastbewertungenOffen
The open guest reviews: what the property CAN write about its guests. LIVE FROM HOSPITABLE, not from a mirror table: an open guest review only exists while the platform's window is open. A nightly sync would be wrong exactly where the deadline matters. Read-only query.
Input parameters
Returns object.
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | boolean | yes | |
fehler | string | no | |
eintraege | array of object | yes | |
eintraege.id | string | yes | |
eintraege.gastName | string · nullable | yes | |
eintraege.objekt | string · nullable | yes | |
eintraege.laeuftAbAm | string · nullable | yes | |
eintraege.vorschlaege | object · nullable | yes |
reviews.kritik
Points of criticism: average rating per platform, the number of poor reviews, and the most frequent topics from their texts. Read-only query.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
tage | integer | no | Default: 90 |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
tage | number | yes | |
bewertet | number | yes | |
schlecht | number | yes | |
plattformen | array of object | yes | |
plattformen.plattform | string | yes | |
plattformen.anzahl | number | yes | |
plattformen.schlecht | number | yes | |
plattformen.durchschnitt | number · nullable | yes | |
plattformen.durchschnittOriginal | number · nullable | yes | |
themen | array of object | yes | |
themen.id | enum | yes | One of: sauberkeit, laerm, bett, bad, temperatur, wlan, checkin, personal, preis, lage, ausstattung, fruehstueck, geruch |
themen.anzahl | number | yes | |
themen.beispiele | array of object | yes | |
zimmer | array of object | yes | |
zimmer.zimmer | string | yes | |
zimmer.bewertet | number | yes | |
zimmer.schlecht | number | yes | |
zimmer.schlechtMehrzimmer | number | yes | |
zimmer.mitKritik | number | yes | |
zimmer.durchschnitt | number · nullable | yes | |
zimmer.themen | array of object | yes | |
zimmer.bewertungen | array of object | yes | |
ohneZimmerSchlecht | number | yes | |
ohneZimmerGesamt | number | yes |
reviews.offene
The open reviews, most recent first, WITH the true totals. OPEN means: no public reply yet. An expired review stays listed anyway IF it has text, because it explains a poor rating even when it can no longer be answered. Read-only query.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
limit | integer | no | Default: 50 |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
gesamtOffen | number | yes | |
beantwortbar | number | yes | |
ohneTextVerborgen | number | yes | |
eintraege | array of object | yes | |
eintraege.id | string | yes | |
eintraege.exReviewId | string | yes | |
eintraege.publicRating | string · nullable | yes | |
eintraege.publicReview | string · nullable | yes | |
eintraege.privateFeedback | string · nullable | yes | |
eintraege.canRespond | boolean · nullable | yes | |
eintraege.reviewedAt | string · nullable | yes | |
eintraege.plattform | string · nullable | yes | |
eintraege.gastVorname | string · nullable | yes | |
eintraege.publicRatingPlatformOriginal | string · nullable | yes | |
eintraege.extern | boolean | yes | |
eintraege.extranetName | string · nullable | yes | |
eintraege.extranetUrl | string · nullable | yes | |
eintraege.zimmer | array of string | yes | |
eintraege.mehrzimmer | boolean | yes |
reviews.zimmerMaengel
Defects of ONE room as a short list, condensed from the reviews in the date range. Reads all reviews of the room that contain criticism, including good ones with a negative part, the most recent 15, without names and dates. Result cached for 24 h. Without a key, or on an error: empty list, and `quelle` says why. One room per call so that a call stays small (Mistral, EU). Read-only query.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
zimmer | string | yes | |
tage | integer | no | Default: 90 |
locale | enum | no | One of: de, en — Default: "de" |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
punkte | array of string | yes | |
quelle | enum | yes | One of: ki, keine_texte, nicht_konfiguriert, fehler |
texte | number | yes |