🧳🌍 GetYourGuide Review Scraper

📌 Introduction

GetYourGuide Review Scraper is a powerful and easy-to-use Apify Actor that collects structured review data from GetYourGuide product pages. It allows you to extract ratings, review text, author information, photos, and other metadata — ideal for sentiment analysis, competitor feedback monitoring, travel content enrichment, and research workflows.

---

💡 Free vs paid plans

On a free Apify plan, this actor returns a sample of the reviews. Upgrade to any paid Apify plan to get the complete results.

---

🎯 What is this Review Scraper?

This Actor automatically scrapes customer reviews from a specified GetYourGuide product URL and outputs them as structured JSON. It supports flexible pagination, reliable de-duplication, and produces data that's ready for analysis or integration into your systems.

---

🔍 Features

• ⭐ Comprehensive Review Data — Extracts ratings, review text, author name & location, photos, and helpful votes.
• 🔁 Flexible Pagination — Supports custom starting page and page size.
• 🔀 Multiple Sorting Options — Reviews can be processed in different orders (date, rating, etc.).
• 🚀 High Performance — Efficiently handles scraping of large volumes of reviews.
• 🧹 Reliable Output — Includes duplicate detection and data validation.
• 🔌 Easy Integration — Simple input parameters and structured output.

---

🧰 Input Parameters

Parameter	Type	Required	Description
product_url	String	⚠️	The GetYourGuide product page URL to scrape reviews from. Either product_url or product_urls must be provided.
product_urls	Array[String]	⚠️	Array of GetYourGuide product URLs for batch processing. Either product_url or product_urls must be provided.
page_size	Number	❌	Maximum number of reviews per page (default: 100).
page	Number	❌	Start page number; will skip (page – 1) * page_size reviews from the beginning (default: 1).

---

📥 Example Input

Single URL

{
  "product_url": "https://www.getyourguide.com/uss-midway-museum-l4441/the-uss-midway-museum-t12879",
  "page_size": 100,
  "page": 1
}

Batch Processing (Multiple URLs)

{
  "product_urls": [
    "https://www.getyourguide.com/uss-midway-museum-l4441/the-uss-midway-museum-t12879",
    "https://www.getyourguide.com/rome-l33/colosseum-roman-forum-palatine-hill-guided-tour-t195566/"
  ],
  "page_size": 100,
  "page": 1
}

This configuration will scrape up to 100 reviews from the first page of the specified GetYourGuide product(s).

---

🗃️ Output Data

Each review returned by this Actor includes the following structured fields:

Field	Type	Description
id	String	Unique review identifier.
review_id	String	Original GetYourGuide review ID.
product_id	String	GetYourGuide product identifier.
product_url	String	Product URL used for scraping this review.
rating	Number	Review rating (1–5 stars).
title	String	Review title.
content	String	Full review text.
author_name	String	Reviewer's name.
user_identifier_value	String	Author user identifier.
review_date	String	Date when the review was published (ISO 8601 format).
helpful_votes	Number	Number of helpful votes.
photos	Array	Array of photo URLs (if any).
owner_response	String	Business owner response text (if any).
owner_response_author	String	Response author name (if any).
owner_response_date	String	Response publication date (ISO 8601 format, if any).
source	String	Data source identifier (always "gyg").
language	String	Review language code.
overall_star_rating	Number	Overall product star rating (e.g. 4.5 out of 5). -1 if unavailable.
overall_review_count	Number	Total number of reviews for the product. -1 if unavailable.

---

🧠 How It Works

1. Input Validation — Validates the provided GetYourGuide product URL.
2. Review Extraction — Scrapes reviews from the product page using advanced web scraping logic.
3. Data Processing — Cleans and processes the extracted review data.
4. Duplicate Detection — Identifies and handles duplicates.
5. Data Storage — Saves the structured data to the Apify dataset for retrieval.

---

⚙️ Usage Examples

📦 Basic Usage

{
  "product_url": "https://www.getyourguide.com/uss-midway-museum-l4441/the-uss-midway-museum-t12879"
}

📈 Advanced Usage (Pagination)

{
  "product_url": "https://www.getyourguide.com/uss-midway-museum-l4441/the-uss-midway-museum-t12879",
  "page_size": 200,
  "page": 2
}

🔄 Batch Processing (Multiple URLs)

{
  "product_urls": [
    "https://www.getyourguide.com/uss-midway-museum-l4441/the-uss-midway-museum-t12879",
    "https://www.getyourguide.com/rome-l33/colosseum-roman-forum-palatine-hill-guided-tour-t195566/",
    "https://www.getyourguide.com/rome-l33/vatican-museums-sistine-chapel-st-peter-s-basilica-tour-t1103/"
  ],
  "page_size": 100,
  "page": 1
}

---

🤖 Use GetYourGuide Review Scraper in Claude, Cursor & Codex via MCP

You can call this Actor directly from an AI assistant through the Apify MCP server — it works with Claude, Cursor, Codex, and any other MCP client.

Add this connector URL in your MCP client:

https://mcp.apify.com/?tools=louvre/gyg-review-scraper

Then ask in plain language, for example:

"Get the latest reviews for this GetYourGuide tour: https://www.getyourguide.com/uss-midway-museum-l4441/the-uss-midway-museum-t12879"

For a ready-to-paste configuration (Claude Desktop, Cursor, VS Code, and more), open the API → MCP tab on this Actor's page.

---

📡 API / CLI Integration

You can run this Actor using the Apify API or CLI. Example with curl:

curl "https://api.apify.com/v2/acts/louvre~gyg-review-scraper/runs?token=<YOUR_API_TOKEN>" \
  -X POST \
  -H "Content-Type: application/json" \
  -d @input.json

Replace <YOUR_API_TOKEN> with your Apify token and input.json with your JSON input containing the fields above.

---

💰 Pricing & Limits

This Actor uses pay-per-result pricing — see the Pricing tab on the Actor page for the current rate. A free trial is available.

---

🔗 Related Links

• 🌐 Actor page: https://apify.com/louvre/gyg-review-scraper
• 📜 Input schema: https://apify.com/louvre/gyg-review-scraper/input-schema