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)

Can I use the API to generate or post review replies?

No. The MARA API currently provides read-only (GET) endpoints only — for retrieving reviews, analytics, service tickets and widget data. There is no endpoint to generate replies or to publish responses to reviews programmatically. Reply generation and publishing are done inside the MARA app.

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#/

API key management & permissions

API keys can only be created by Account Admins.
Every API key has access to all of your account's data - keys cannot be scoped to individual properties.
You can deactivate or rotate a key at any time. Rotating a key invalidates the old one and creates a new one, so remember to update it wherever it's used.
To test the API, open the documentation, click Authorize, paste your key, then use "Try it out" on any endpoint.

Endpoints

Widget endpoints can be called live - for example directly from your website for each visitor/session.
All other endpoints are not designed for live calls. Use them on a schedule (e.g. daily) - for example to pull new reviews - and store the data on your side.

Automation tools such as n8n, Zapier or Make make it easy to pull data on a schedule and push it into your other systems.

Properties

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.

Reviews

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).

Service-tickets

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/retrieve service tickets using the API: Video

Competitors

Returns statistics for your competitors.

You can filter by specific properties using the property_ids parameter and by date range using from/to parameters.

Analytics

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).

Widgets

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: Video

API Usage and Endpoints