FoyerDevelopers

Generated · Live registry

reviews tools

7 tools in this domain, generated from the running registry.

All tool domains

reviews.antworten

writes

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

FieldTypeRequiredNotes
reviewIdstringyes
textstringyes

Output fields

FieldTypeRequiredNotes
okbooleanyes
grundstringno

reviews.antwortentwurf

writes

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

FieldTypeRequiredNotes
reviewIdstringyes

Output fields

FieldTypeRequiredNotes
okbooleanyes
grundstringno
textstringno
sprachestringno
quelleenumnoOne of: ki, vorlage
extranetNamestring · nullableno
extranetUrlstring · nullableno

reviews.gastbewertungSchreiben

writes

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

FieldTypeRequiredNotes
reviewIdstringyes
textstringyes
privatesFeedbackstringno
verzoegernbooleanno
notenobjectyes
noten.ratingnumberyes
noten.recommendbooleanyes
noten.cleanlinessnumberyes
noten.communicationnumberyes
noten.respect_house_rulesnumberyes

Output fields

FieldTypeRequiredNotes
okbooleanyes
grundstringno

reviews.gastbewertungenOffen

read-only

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

FieldTypeRequiredNotes
okbooleanyes
fehlerstringno
eintraegearray of objectyes
eintraege.idstringyes
eintraege.gastNamestring · nullableyes
eintraege.objektstring · nullableyes
eintraege.laeuftAbAmstring · nullableyes
eintraege.vorschlaegeobject · nullableyes

reviews.kritik

read-only

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

FieldTypeRequiredNotes
tageintegernoDefault: 90

Output fields

FieldTypeRequiredNotes
tagenumberyes
bewertetnumberyes
schlechtnumberyes
plattformenarray of objectyes
plattformen.plattformstringyes
plattformen.anzahlnumberyes
plattformen.schlechtnumberyes
plattformen.durchschnittnumber · nullableyes
plattformen.durchschnittOriginalnumber · nullableyes
themenarray of objectyes
themen.idenumyesOne of: sauberkeit, laerm, bett, bad, temperatur, wlan, checkin, personal, preis, lage, ausstattung, fruehstueck, geruch
themen.anzahlnumberyes
themen.beispielearray of objectyes
zimmerarray of objectyes
zimmer.zimmerstringyes
zimmer.bewertetnumberyes
zimmer.schlechtnumberyes
zimmer.schlechtMehrzimmernumberyes
zimmer.mitKritiknumberyes
zimmer.durchschnittnumber · nullableyes
zimmer.themenarray of objectyes
zimmer.bewertungenarray of objectyes
ohneZimmerSchlechtnumberyes
ohneZimmerGesamtnumberyes

reviews.offene

read-only

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

FieldTypeRequiredNotes
limitintegernoDefault: 50

Output fields

FieldTypeRequiredNotes
gesamtOffennumberyes
beantwortbarnumberyes
ohneTextVerborgennumberyes
eintraegearray of objectyes
eintraege.idstringyes
eintraege.exReviewIdstringyes
eintraege.publicRatingstring · nullableyes
eintraege.publicReviewstring · nullableyes
eintraege.privateFeedbackstring · nullableyes
eintraege.canRespondboolean · nullableyes
eintraege.reviewedAtstring · nullableyes
eintraege.plattformstring · nullableyes
eintraege.gastVornamestring · nullableyes
eintraege.publicRatingPlatformOriginalstring · nullableyes
eintraege.externbooleanyes
eintraege.extranetNamestring · nullableyes
eintraege.extranetUrlstring · nullableyes
eintraege.zimmerarray of stringyes
eintraege.mehrzimmerbooleanyes

reviews.zimmerMaengel

read-only

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

FieldTypeRequiredNotes
zimmerstringyes
tageintegernoDefault: 90
localeenumnoOne of: de, en — Default: "de"

Output fields

FieldTypeRequiredNotes
punktearray of stringyes
quelleenumyesOne of: ki, keine_texte, nicht_konfiguriert, fehler
textenumberyes