# Musement Reviews Scraper (`knagymate/musement-reviews-scraper`) Actor

Scrape Musement and TUI Musement activity reviews at scale. Extract ratings, review text, traveler type, reviewer country, locale, and date into structured JSON, CSV, or Excel — perfect for sentiment analysis, market research, and travel intelligence.

- **URL**: https://apify.com/knagymate/musement-reviews-scraper.md
- **Developed by:** [knagymate](https://apify.com/knagymate) (community)
- **Categories:** Travel, AI, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Musement Reviews Scraper | Extract Activity, Tour & Attraction Reviews at Scale

Scrape **Musement and TUI Musement activity reviews** in seconds and turn them
into structured datasets for **data analysis, market research, sentiment
analysis, and travel intelligence**.

> ℹ️ **One scraper, both sites.** This **Musement Reviews Scraper** covers both
> [musement.com](https://www.musement.com) and
> [tuimusement.com](https://www.tuimusement.com). They are effectively the same
> platform (TUI Musement), so a single actor handles reviews from either domain.

This actor extracts real customer reviews including rating, review text,
reviewer country, traveler type, and locale --- ready for export to **JSON, CSV,
Excel, or API pipelines**.

------------------------------------------------------------------------

### 🔥 Why use this Musement & TUI Musement scraper?

-   Extract **real Musement and TUI Musement reviews at scale**
-   Get **ratings, review text, and reviewer metadata**
-   Capture **traveler type, country, locale, and review date**
-   Ideal for **AI training, analytics, dashboards, and competitor research**
-   Built for **fast, reliable, and scalable scraping**

------------------------------------------------------------------------

### 🚀 Features

-   Scrape reviews from **Musement and TUI Musement activity URLs**
-   Extract structured data including:
    -   Review text (comment)
    -   Rating
    -   Traveler type (e.g. Alone, With friends, As a couple, With family)
    -   Reviewer country and locale
    -   Reviewer age and nickname
-   Sorting options:
    -   Most relevant
    -   Newest to oldest
    -   Current language
    -   Highest rated
    -   Lowest rated
-   Incremental scraping via **cutoff date**
-   Export to **JSON, CSV, Excel, or integrate via API**

------------------------------------------------------------------------

### 📥 Input

``` json
{
  "activityUrl": "https://www.musement.com/uk/barcelona/sagrada-familia-entrance-tickets-with-audioguide-330203",
  "maxReviews": 100,
  "sortBy": "newestToOldest",
  "cutoffDate": "2024-01-01"
}
````

TUI Musement URL example:

```json
{
  "activityUrl": "https://www.tuimusement.com/uk/spain/barcelona/sagrada-familia-entrance-tickets-with-audioguide/e_ne9wv-d_60-c_161/",
  "maxReviews": 100,
  "sortBy": "newestToOldest",
  "cutoffDate": "2024-01-01"
}
```

#### Input parameters

- **activityUrl** (required): Musement or TUI Musement activity page URL
- **maxReviews**: Maximum number of reviews to scrape (default: 1000)
- **sortBy**:
  - `mostRelevant`
  - `newestToOldest`
  - `currentLanguage`
  - `highestRated`
  - `lowestRated`
- **cutoffDate**: Only return reviews newer than this date. When set, results
  are automatically sorted from newest to oldest.

***

### 📤 Output

Each review is returned as structured data:

```json
{
  "id": "44a211c2-8887-41c2-9fcb-5953d03fec85",
  "date": "2026-07-04 00:00:00",
  "rating": 10.0,
  "reviewerAge": 50,
  "reviewerCountry": "United Kingdom",
  "reviewerNickName": "Jaime P",
  "locale": "en-GB",
  "travelerType": "WITH-FAMILY",
  "comment": "First time I'd booked a transfer via Tui Musement and the service was brilliant. Our flight was delayed by over 6 hours and they kept in contact via Whatsapp to ensure we had a driver on arrival at the airport at 3.15am. The communication and service was excellent."
}
```

#### Output fields

- **id**: Unique review ID
- **date**: Review date
- **rating**: Review rating
- **reviewerAge**: Age of the reviewer
- **reviewerCountry**: Country of the reviewer
- **reviewerNickName**: Reviewer nickname
- **locale**: Review locale (e.g. `en-GB`, `nl-NL`)
- **travelerType**: Traveler type (`ALONE`, `WITH-FRIENDS`, `AS-A-COUPLE`, `WITH-FAMILY`)
- **comment**: Review text

***

### 📊 Use cases

#### 📈 Market research & analytics

Analyze customer sentiment, satisfaction trends, and review patterns across
activities, tours, and attractions.

#### 🏛️ Competitor benchmarking

Compare experiences based on ratings, feedback, and traveler profiles.

#### 🤖 AI & data pipelines

Use structured reviews for: - NLP models - Sentiment analysis - Recommendation
systems

#### 📉 Reputation monitoring

Track how an activity's perception changes over time.

***

### ⚠️ Notes

- Musement and TUI Musement reviews come in **multiple languages** (see `locale`)
- Some fields may be missing depending on the review (e.g. `travelerType`,
  `reviewerNickName`, or `comment` can be empty)
- Popular activities can have **thousands of reviews**
- Always comply with Musement / TUI Musement Terms of Service

***

### 💡 Pro tips

- Use `newestToOldest` + `cutoffDate` for **incremental scraping**
- Run multiple jobs for **large-scale datasets**
- Group by `reviewerCountry`, `locale`, or `travelerType` for richer analytics
- Combine with other review sources for multi-platform analysis:
  - Agoda Reviews Scraper → https://apify.com/knagymate/fast-agoda-reviews-scraper
  - Kayak Reviews Scraper → https://apify.com/knagymate/apify-kayak-reviews-scraper
  - Priceline Reviews Scraper → https://apify.com/knagymate/priceline-reviews-scraper
  - Explore all scrapers → https://apify.com/knagymate

# Actor input Schema

## `activityUrl` (type: `string`):

URL of the Musement activity to scrape reviews from.

## `maxReviews` (type: `integer`):

Maximum number of reviews to scrape.

## `sortBy` (type: `string`):

Sorting order of reviews.

## `cutoffDate` (type: `string`):

Only reviews newer than this date will be returned.

## Actor input object example

```json
{
  "activityUrl": "https://www.musement.com/uk/barcelona/sagrada-familia-entrance-tickets-with-audioguide-330203",
  "maxReviews": 100,
  "sortBy": "newestToOldest"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "cutoffDate": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("knagymate/musement-reviews-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "cutoffDate": "" }

# Run the Actor and wait for it to finish
run = client.actor("knagymate/musement-reviews-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "cutoffDate": ""
}' |
apify call knagymate/musement-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=knagymate/musement-reviews-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Musement Reviews Scraper",
        "description": "Scrape Musement and TUI Musement activity reviews at scale. Extract ratings, review text, traveler type, reviewer country, locale, and date into structured JSON, CSV, or Excel — perfect for sentiment analysis, market research, and travel intelligence.",
        "version": "0.0",
        "x-build-id": "nK5rN1VTa7xppTdoD"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/knagymate~musement-reviews-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-knagymate-musement-reviews-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/knagymate~musement-reviews-scraper/runs": {
            "post": {
                "operationId": "runs-sync-knagymate-musement-reviews-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/knagymate~musement-reviews-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-knagymate-musement-reviews-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "activityUrl"
                ],
                "properties": {
                    "activityUrl": {
                        "title": "Activity URL",
                        "type": "string",
                        "description": "URL of the Musement activity to scrape reviews from.",
                        "default": "https://www.musement.com/uk/barcelona/sagrada-familia-entrance-tickets-with-audioguide-330203"
                    },
                    "maxReviews": {
                        "title": "Maximum number of reviews",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of reviews to scrape.",
                        "default": 100
                    },
                    "sortBy": {
                        "title": "Sort reviews by",
                        "enum": [
                            "mostRelevant",
                            "newestToOldest",
                            "currentLanguage",
                            "highestRated",
                            "lowestRated"
                        ],
                        "type": "string",
                        "description": "Sorting order of reviews.",
                        "default": "newestToOldest"
                    },
                    "cutoffDate": {
                        "title": "Cutoff date",
                        "type": "string",
                        "description": "Only reviews newer than this date will be returned."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```