🧳🌍 Tripadvisor Review Scraper

📌 Introduction

Tripadvisor Review Scraper is a powerful and easy-to-use Apify Actor designed to collect structured review data from Tripadvisor product pages. Whether you're analyzing customer sentiment, monitoring traveler feedback, or enriching your travel content, this Actor helps you extract data at scale — pricing is pay-per-result.

---

🎯 What is this Review Scraper?

This Actor automatically scrapes reviews from a given Tripadvisor product URL and produces structured dataset output that you can download or integrate via API. It's perfect for travel market research, competitive analysis, sentiment tracking, and more.

---

🔍 Features

• ⭐ Structured Review Data — Extract ratings, review text, reviewer info, photos, dates, and more.
• 🔁 Flexible Pagination — Easily scrape multiple pages of reviews.
• 🚀 Efficient Extraction — Designed to handle a large number of reviews.
• 🧹 Clean Output — Produces organized dataset entries ready for analysis.
• 🔌 Easy Integration — Use with Apify API or workflow automation tools.

---

🧰 Input Parameters

The Actor's input schema allows you to specify what pages you want to scrape. (Exact fields may vary — based on the generic structure of similar review scrapers on Apify and this Actor's description.)

Parameter	Type	Required	Description
product_url	String	✅	The Tripadvisor product page URL to scrape reviews from.
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).

⚠️ Note: The exact input fields are based on typical review scrapers' schema (e.g., startUrls + limits), as detailed input docs aren't fully public for this Actor.

---

📥 Example Input

{
  "product_url": "https://www.tripadvisor.com/AttractionProductReview-g154998-d23988190-Niagara_Falls_Boat_Ride_VIP_Boarding_Journey_Behind_the_Falls-Niagara_Falls_Ontari.html",
  "page_size": 100,
  "page": 1
}

This configuration will scrape up to 100 reviews starting from the first page of the specified Tripadvisor product.

---

🗃️ 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 Tripadvisor review ID.
product_id	String	Tripadvisor product identifier.
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).
trip_type	String	Type of travel (solo, couple, family, etc.).
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).
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 Acceptance — Takes a list of Tripadvisor page URLs from the user.
2. Web Scraping — Visits each URL and parses visible review data from the page DOM.
3. Data Structuring — Normalizes extracted fields into structured records.
4. Dataset Storage — Saves results in the Apify dataset for retrieval via UI or API.

---

⚙️ Usage Examples

📦 Basic Usage

{
  "product_url": "https://www.tripadvisor.com/AttractionProductReview-g154998-d23988190-Niagara_Falls_Boat_Ride_VIP_Boarding_Journey_Behind_the_Falls-Niagara_Falls_Ontari.html"
}

📈 With Pagination

{
  "product_url": "https://www.tripadvisor.com/AttractionProductReview-g154998-d23988190-Niagara_Falls_Boat_Ride_VIP_Boarding_Journey_Behind_the_Falls-Niagara_Falls_Ontari.html",
  "page_size": 200,
  "page": 2
}

Attempts to extract up to 200 reviews from the specified restaurant page.

---

💰 Pricing & Limits

This Actor is priced at $1.00 per 1,000 results, and includes a free trial for testing.

---

🚀 Deploying to Apify

To push this Actor to the Apify platform, use the Apify CLI:

Prerequisites

1. Install Apify CLI (if not already installed):

$npm install -g apify-cli

2. Login to Apify:

$apify login

Push Command

Navigate to the actor directory and push:

cd tripadvisor-review-scraper
apify push

This will:

• Build the Actor code
• Upload it to your Apify account
• Make it available in the Apify platform

Push and Set as Latest Version

To push and automatically set the version as latest:

$apify push -b latest --force

This command will:

• Build and push the Actor
• Set the pushed version as the latest version
• Make it the default version when running the Actor

Alternative: Push with Specific Actor ID

If you want to push to a specific Actor ID:

$apify push --actor-id <YOUR_ACTOR_ID>

Or push with Actor ID and set as latest:

$apify push --actor-id <YOUR_ACTOR_ID> -b latest --force

Build and Push Separately

You can also build and push separately:

# Build the Actor
npm run build

# Push to Apify
apify push

Modifying the Version

To change the Actor version before pushing:

1. Edit the version in .actor/actor.json:

{
  "version": "1.3"
}

Note: Apify requires version format to be MAJOR.MINOR (e.g., 1.3), where MAJOR and MINOR are numbers from 0 to 99. Three-part versions like 1.3.1 are not supported.

2. Push with the new version:

$apify push

Or push with a specific version directly:

$apify push --version 1.3

Note: The version in actor.json will be used by default. If you specify --version latest, it will set the pushed version as latest regardless of the version in actor.json.

📡 API / CLI Integration

You can run this Actor programmatically via the Apify API. Example (curl):

curl "https://api.apify.com/v2/acts/louvre~tripadvisor-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.

---

🔗 Related Links

• 🌐 Actor page: https://apify.com/louvre/tripadvisor-review-scraper
• 📜 API docs: https://apify.com/louvre/tripadvisor-review-scraper/api