# Getyourguide Reviews Scraper (`stealth_mode/getyourguide-reviews-scraper`) Actor

Scrape detailed tour reviews from GetYourGuide.com by Tour ID. Collect ratings, author info, traveler types, media, replies, and 20+ fields per review — perfect for tour operators, travel analysts, and reputation managers.

- **URL**: https://apify.com/stealth_mode/getyourguide-reviews-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Automation, Developer tools, Travel
- **Stats:** 16 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## GetYourGuide Reviews Scraper: Extract Tour Reviews at Scale

***

### What Is GetYourGuide.com?

GetYourGuide is one of the world's largest online marketplaces for tours, activities, and travel experiences, hosting millions of verified customer reviews across hundreds of thousands of listings. These reviews are a goldmine of sentiment data, quality signals, and traveler insights — but collecting them manually is impractical at any meaningful scale.

The **GetYourGuide Reviews Scraper** solves this by automating review extraction for any tour, using only its Tour ID. Whether you manage a single experience or a large portfolio of activities, this scraper delivers structured, analysis-ready review data without writing a single line of code.

***

### Overview

The **GetYourGuide Reviews Scraper** targets the review section of individual tour pages on GetYourGuide.com. It retrieves full review records including ratings, written feedback, author metadata, traveler type, media attachments, and operator replies.

Designed for:

- **Tour operators** monitoring guest satisfaction and responding to trends
- **Travel analysts** building sentiment datasets across destinations or categories
- **Reputation managers** tracking review volume, rating distribution, and language breakdown
- **Researchers** studying traveler behavior and experience quality in the tours & activities sector

Key advantages include pagination via `offset`, configurable item limits, and resilient handling of failures through `ignore_url_failures` — making it suitable for both quick spot-checks and large-scale data collection runs.

***

### Input Format

The scraper is configured via a JSON object. No URLs are required — just the Tour ID extracted from the GetYourGuide tour page URL.

```json
{
  "tour_id": "68846",
  "offset": 0,
  "max_items_per_url": 200,
  "ignore_url_failures": true
}
```

#### Field Definitions

| Field | Type | Description |
|---|---|---|
| `tour_id` | `string` | **Required.** The numeric Tour ID found in the tour's URL. Example: `/paris-l16/full-champagne-wine-day-tour-from-paris-t68846/` → `68846` (the number after `t`) |
| `offset` | `integer` | Starting position for pagination. Use `0` to begin from the first review. Increase to skip already-collected reviews in subsequent runs. Default: `0` |
| `max_items_per_url` | `integer` | Maximum number of reviews to collect per run. Default: `20`. Set higher (e.g., `200`) for comprehensive collection |
| `ignore_url_failures` | `boolean` | If `true`, the scraper continues running even if a request fails, rather than stopping the entire job. Recommended: `true` for bulk runs |

#### How to Find the Tour ID

Navigate to any GetYourGuide tour page. The Tour ID is the number following `t` at the end of the URL path:

```
https://www.getyourguide.com/paris-l16/full-champagne-wine-day-tour-from-paris-t68846/ -> Tour ID: 68846
```

> **Tip:** To collect all reviews for a popular tour, combine a high `max_items_per_url` value with paginated runs using the `offset` field — for example, run with `offset: 0`, then `offset: 200`, then `offset: 400`, and so on.

***

### Output Format

#### Sample Output Record

```json
{
  "id": 123682326,
  "author": {
    "country": "United States",
    "full_name": "Komal"
  },
  "title": "",
  "message": "The trip was excellent! We saw some beautiful picturesque landscapes, learned a lot about the process of making champagne and got to experience some amazing champagne and champagne houses. Our tour guide, Aurélien, was knowledgeable and very helpful.",
  "is_anonymous": false,
  "rating": 5,
  "created": "2026-05-18T05:26:37+02:00",
  "activity_id": 68846,
  "enjoyment": "",
  "formatted_message": null,
  "has_upvoted": false,
  "is_partner_review": false,
  "is_test_data": false,
  "language": "en",
  "media": [],
  "option_id": 97003,
  "ratings": [
    {
      "rating_type": "rating_guide",
      "rating_value": 5
    },
    {
      "rating_type": "rating_value",
      "rating_value": 5
    },
    {
      "rating_type": "rating_transport",
      "rating_value": 5
    },
    {
      "rating_type": "rating_overall",
      "rating_value": 5
    }
  ],
  "replies": [
    {
      "created_at": "2026-05-19T13:43:13+02:00",
      "id": 1068933,
      "language_code": "en",
      "text": "Dear Komal, Thank you so much for this kind feedback! We're so glad you enjoyed the landscapes, the champagne houses and learned so much about the champagne production, that's exactly the experience we love to share! We'll make sure to pass on your kind words to Aurélien, he'll be very happy to hear it. We hope to welcome you back! Kind regards, My WineDays Team"
    }
  ],
  "traveler_type": "couple",
  "from_url": "https://travelers-api.getyourguide.com/activities/68846/adp-reviews-highlighted?limit=100&offset=0&sort=recommended"
}
```

Each review returns a structured record with 20 fields covering identity, content, ratings, and metadata.

#### Review Identity

| Field | Meaning |
|---|---|
| `ID` | Unique internal identifier for the review |
| `Activity ID` | The GetYourGuide activity/tour this review belongs to |
| `Option ID` | The specific tour option or time slot the reviewer booked |
| `Is Test Data` | Flags whether this is a test or synthetic entry, not a real customer review |

#### Reviewer Information

| Field | Meaning |
|---|---|
| `Author` | Reviewer's display name and profile metadata |
| `Is Anonymous` | Whether the reviewer chose to hide their identity |
| `Traveler Type` | Self-reported traveler category (e.g., couple, family, solo) |
| `Language` | Language in which the review was written |

#### Review Content

| Field | Meaning |
|---|---|
| `Title` | Short headline of the review (if provided) |
| `Message` | Raw review text as submitted by the traveler |
| `Formatted Message` | Processed/rendered version of the review message, may include formatting |
| `Media` | Attached photos or videos uploaded by the reviewer |
| `Created` | Timestamp of when the review was submitted |

#### Ratings & Sentiment

| Field | Meaning |
|---|---|
| `Rating` | Overall numeric rating given by the reviewer (typically 1–5) |
| `Ratings` | Breakdown of sub-ratings (e.g., value, guide quality, overall experience) where available |
| `Enjoyment` | Specific enjoyment score if captured separately from the main rating |

#### Engagement & Status

| Field | Meaning |
|---|---|
| `Has Upvoted` | Whether the current user (or session) has upvoted this review |
| `Is Partner Review` | Whether the review was submitted via a GetYourGuide partner channel |
| `Replies` | Operator or platform responses to the review |

***

### How to Use

1. **Find your Tour ID** — Open the target GetYourGuide tour page and extract the number after `t` in the URL.
2. **Configure the input** — Set `tour_id`, adjust `max_items_per_url` based on how many reviews you need, and set `offset: 0` for a fresh run.
3. **Run the scraper** — Start the actor and monitor the progress log.
4. **Paginate if needed** — For tours with hundreds of reviews, re-run with incremented `offset` values to collect the full dataset.
5. **Export** — Download results as JSON, CSV, or Excel for use in dashboards, spreadsheets, or analytics tools.

**Common issues:**

- If no results are returned, double-check that the `tour_id` is correct and corresponds to an active listing.
- For tours with few reviews, set `max_items_per_url` to a lower value to avoid unnecessary processing.
- Keep `ignore_url_failures: true` enabled when running multiple tour IDs in sequence.

***

### Use Cases & Business Value

- **Reputation monitoring:** Track rating trends over time and flag sudden drops in satisfaction
- **Competitive benchmarking:** Compare review sentiment across similar tours in the same destination
- **Content analysis:** Use review text for NLP, keyword extraction, or sentiment classification
- **Product improvement:** Identify recurring complaints or praise across sub-ratings like guide quality or value
- **Marketing insights:** Surface authentic traveler quotes and top-rated experiences for promotional use

The GetYourGuide Reviews Scraper turns thousands of dispersed review pages into a single, queryable dataset — saving hours of manual collection and enabling insights that are otherwise impossible to surface at scale.

***

### Conclusion

The **GetYourGuide Reviews Scraper** is a practical, efficient tool for anyone who needs structured review data from GetYourGuide.com. With detailed 20-field output, flexible pagination, and simple Tour ID-based configuration, it fits seamlessly into research workflows, operator dashboards, and data pipelines. Run it today to turn traveler feedback into actionable intelligence.

# Actor input Schema

## `tour_id` (type: `string`):

Enter Tour ID. For example, /paris-l16/full-champagne-wine-day-tour-from-paris-t68846/ -> 68846)

## `offset` (type: `integer`):

Offset to start from

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "tour_id": "68846",
  "ignore_url_failures": true,
  "max_items_per_url": 20
}
```

# 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 = {
    "tour_id": "68846",
    "offset": 0,
    "ignore_url_failures": true,
    "max_items_per_url": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/getyourguide-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 = {
    "tour_id": "68846",
    "offset": 0,
    "ignore_url_failures": True,
    "max_items_per_url": 20,
}

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

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

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

```

## CLI example

```bash
echo '{
  "tour_id": "68846",
  "offset": 0,
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/getyourguide-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,stealth_mode/getyourguide-reviews-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/es0FW3Crdkf6ELwwl/builds/oY300ailCgAjYuYzw/openapi.json