You can use our API to retrieve your reviews and related data to:
build custom review widgets with our widget endpoint. Learn more:
pull reviews or analytics data for custom reportings
retrieve service tickets and integrate them directly into your existing ticketing system Learn more:
How to access the API
Generate an API key in your MARA account settings under API Keys to access your properties data via the API.
You can find the API Documentation here: https://api.mara-solutions.com/api#/
Endpoints
widget Endpunkte können LIVE eingebaut werden (kann von der Website direkt live für jee Session / jeden User) gecalled werden
Alle anderen Endpunkte sind darauf NICHT ausgelegt. Diese Endpunkte könnt ihr regelmäßig (zum beispiel täglich) nutzen, um zum Beispiel neue Reviews zu ziehen, die Daten solltet ihr aber auf eurer Seite speichern
Returns statistics for your properties in the selected timeframe:
total number of reviews
number of answerable reviews
number of answered reviews
MARA score (average rating across all reviews on a 5-point scale)
You can filter by specific properties using the property_ids parameter.
Returns a list of reviews for the specified group/properties including all available review and reply information
Important:
Our API provides reviews from Online Travel Agencies (OTAs) such as Booking.com and Google. Due to legal and licensing restrictions (e.g., terms of service and copyright), these reviews may not be displayed 1:1 (verbatim) on your website. The content remains the intellectual property of the respective platform and/or the original reviewer.
Survey responses collected through MARA are not subject to these third-party restrictions and can be used on your website, subject to applicable data protection laws.
Input Parameters:
limit(required): Limit the number of reviews returned. Default = 100.offset(required): Offset for pagination. Default = 0.min_date(optional): Minimum date for reviews. Default = 2025-01-01.max_date(optional): Maximum date for reviews. Default = 2025-01-01.property_ids(optional): Comma-separated Property IDs for reviews.min_mara_score(optional): Minimum MARA score (1-5) for filtering reviews.max_mara_score(optional): Maximum MARA score (1-5) for filtering reviews.platform(optional): Filter by platform (e.g., booking_com, airbnb,google_maps). Using "airbnb" will match all Airbnb listings.has_text(optional): Filter by whether the review has text or not (true/false).
Returns a list of maintenance service tickets for the specified group.
Input Parameters:
limit(required): Limit the number of tickets returned. Default is 100, max is 1000.offset(required): Offset for pagination. Default is 0.min_date(optional): Filter tickets created after this date.max_date(optional): Filter tickets created before this date.checkout_date(optional): Filter tickets by checkout date.min_checkout_date(optional): Filter tickets with checkout date greater than or equal to this date.department(optional): Filter tickets by department (Housekeeping, Maintenance, Front Office, Marketing).property_ids(optional): Comma-separated property IDs to filter tickets.room_nr(optional): Filter tickets by room number.
How to create service Tickets
Returns statistics for your competitors.
You can filter by specific properties using the property_ids parameter and by date range using from/to parameters.
Ratings over time
Returns rating and review statistics over time for the specified group, properties, and platforms.
number of reviews
number of answerable reviews
number of answered reviews
response rate (reviews with published reply)
done rate (published + reviews marked as answered)
mara score
Categories and Topics
Returns identified topics, subcategories, categories and sentiments for the specified properties in the defined time range, including their average rating and number of reviews mentioning the topic/category.
The platform parameter allows you to get the insights for all feedback (-), only public feedback (non_mara_survey) or only survey feedback (mara_survey).
Returns the latest publicly visible data for a widget:
Widget configuration and settings
Latest visibility data from all connected platforms
Aggregated metrics (average rating, total reviews)
Platform-specific review data with URLs and ratings
To start the automated scraping of the live public data from the OTAs, you need to create a widget in your MARA Account first: https://app.mara-solutions.com/widgets
This widget's ID is needed to retrieve the data via the API.
How to create a custom widget using the API