Tripadvisor Scraper (Camoufox Stealth)

A production-grade, anti-bot resilient Tripadvisor Scraper Apify Actor built with Crawlee + Playwright + Camoufox (stealth C++ Firefox engine).

It extracts comprehensive data on Hotels, Restaurants, and Attractions / Things to do from Tripadvisor, including bubble ratings, reviews count, popularity rankings, price levels, full addresses, contact details, property amenities, room features, photo galleries, and customer review cards.

---

⚡ Features

• 🏨 Multi-Category Coverage: Extract Hotels, Restaurants, and Tourist Attractions.
• 🔍 Flexible Search & Direct URLs: Search by city/keywords (e.g. hotels in paris, best restaurants in tokyo) or paste direct Tripadvisor review URLs.
• ⭐ Bubble Ratings & Rankings: Extracts TripAdvisor bubble rating (e.g., 4.8 / 5.0), total review counts, and regional rankings (e.g., "#1 of 1,886 hotels in Paris").
• 💰 Pricing Details: Extracts price ranges and price levels (e.g., $$ - $$$).
• 📍 Full Address & Geolocation: City, country, postal code, and street address.
• 📞 Contact Information: Phone number and official direct website links.
• 🏊 Amenities & Features: Property amenities, room features, and dining options.
• 🖼️ High-Resolution Photo Gallery: Hero photos and gallery pictures.
• 💬 Customer Review Cards: Top customer reviews with title, body, reviewer rating, and date.
• 🛡️ Camoufox Stealth: Bypasses PerimeterX, Cloudflare, and bot detection on the Apify platform.

---

📥 Input Parameters

Field	Type	Default	Description
searchTerms	Array of strings	["hotels in paris"]	Search keywords or city queries.
startUrls	Array of objects/strings	[]	Direct Tripadvisor search, listing, or place review URLs.
maxItems	Integer	20	Maximum number of places to scrape.
maxPagesPerQuery	Integer	2	Maximum pagination pages to visit per query.
scrapeDetails	Boolean	true	Extract full amenities, rankings, contact info, and gallery.
includeReviews	Boolean	true	Extract top customer review cards.
proxyConfiguration	Object	{}	Apify Proxy settings (Residential recommended).

Sample Input (JSON)

{
  "searchTerms": ["hotels in paris", "rome restaurants"],
  "maxItems": 20,
  "maxPagesPerQuery": 2,
  "scrapeDetails": true,
  "includeReviews": true
}

---

📤 Output Sample (JSON)

{
  "id": "d198234",
  "name": "Hotel Plaza Athénée",
  "category": "HOTEL",
  "url": "https://www.tripadvisor.com/Hotel_Review-g187147-d198234-Reviews-Hotel_Plaza_Athenee-Paris_Ile_de_France.html",
  "rating": 4.9,
  "reviewCount": 3946,
  "ranking": "#1 of 1,886 hotels in Paris",
  "priceRange": "$$$$",
  "address": "25 avenue Montaigne, 75008 Paris, France",
  "city": "Paris",
  "country": "France",
  "phone": "+33 1 53 67 66 65",
  "website": "https://www.dorchestercollection.com/paris/hotel-plaza-athenee",
  "amenities": [
    "Free High Speed Internet (WiFi)",
    "Fitness Center with Gym / Workout Room",
    "Bar / Lounge",
    "Spa",
    "Room Service",
    "Valet Parking"
  ],
  "thumbnail": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/28/10/72/7b/hotel-plaza-athenee.jpg",
  "photos": [
    "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/28/10/72/7b/hotel-plaza-athenee.jpg",
    "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/28/10/72/7c/eiffel-suite.jpg"
  ],
  "reviews": [
    {
      "title": "A magical stay in Paris",
      "text": "Every single detail was taken care of. The view of the Eiffel tower from our balcony was breathtaking...",
      "rating": 5.0,
      "author": "TravelerFromNYC",
      "date": "September 2026"
    }
  ],
  "scrapedAt": "2026-09-11T17:15:00.000Z"
}

---

🚀 How to Run

Via Apify Web Console

1. Open the Actor in your Apify Console.
2. Enter your search terms or start URLs.
3. Click Start.

Via Python

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")

run_input = {
    "searchTerms": ["hotels in paris"],
    "maxItems": 10,
    "scrapeDetails": True
}

run = client.actor("datablow/tripadvisor-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"[{item['category']}] {item['name']} - ★{item['rating']}/5 ({item['ranking']})")