Tripadvisor Reviews Scraper

A powerful and efficient tool for extracting comprehensive review data from TripAdvisor. This scraper enables you to collect detailed reviews, ratings, traveler insights, and much more from hotels, restaurants, attractions, and other businesses listed on TripAdvisor.

🚀 Features

Comprehensive Data Extraction

• Review Details: Extract complete review text, titles, ratings, and publication dates
• Reviewer Information: Get reviewer names, profiles, contribution counts, and verification status
• Travel Insights: Access traveler types, stay dates, and trip details
• Owner Responses: Capture business responses to reviews with timestamps
• Media Content: Extract images and visual content from reviews
• Multi-language Support: Handle reviews in multiple languages with translation detection

Advanced Filtering & Search

• Flexible Query Input: Search by TripAdvisor URLs, numeric IDs, or location names
• Rating Filters: Filter reviews by specific star ratings (1-5 stars)
• Traveler Type Filtering: Target specific traveler segments (business, couples, family, friends, solo)
• Temporal Filtering: Filter reviews by visitation months and publication dates
• Keyword Search: Find reviews containing specific keywords in title or content
• Language Filtering: Extract reviews in specific languages

Customizable Output

• Pagination Control: Choose between specific review counts or extract all available reviews
• Sorting Options: Sort reviews by most recent or detailed review order
• Localization Support: Support for 30+ locales and regional TripAdvisor versions
• Structured Data: Clean, well-formatted JSON output ready for analysis

📋 Input Parameters

Required Parameters

Parameter	Type	Description	Example
query	Array	TripAdvisor URLs, numeric IDs, or location names	["https://www.tripadvisor.com/Hotel_Review-g60763-d208453-Reviews-Hilton_New_York_Times_Square-New_York_City_New_York.html", "126260", "Lotte New York Palace"]

Optional Parameters

Parameter	Type	Default	Description
reviewsPerPlace	Integer	50	Number of reviews to scrape per location (ignored if parseAllReviews is true)
parseAllReviews	Boolean	false	Extract all available reviews regardless of count limit
sortBy	String	"most_recent"	Sort order: "most_recent" or "detailed_reviews"
ratingIs	Array	null	Filter by specific star ratings (1, 2, 3, 4, 5)
travelerType	Array	null	Filter by traveler type: "business", "couples", "family", "friends", "solo"
monthsOfVisit	Array	null	Filter by visitation months: "jan", "feb", "mar", etc.
keyword	String	null	Search for specific keywords in review titles or content
since	String	null	Filter reviews published since specific date (YYYY-MM-DD format)
lang	String	null	Language filter (e.g., "es,fr" for Spanish and French)
locale	String	"en-US"	Regional locale for localized content (30+ options available)

📊 Output Data Structure

Each review extracted includes the following comprehensive data fields:

Core Review Information

• review_id: Unique TripAdvisor review identifier
• rating: Star rating (1-5)
• title: Review title
• text: Complete review text content
• review_link: Direct URL to the review
• published_at_date: When the review was published
• created_at_date: When the review was originally written
• language: Review language code
• is_translated: Boolean indicating if review was translated
• original_language: Original language if translated
• like_count: Number of helpful votes
• review_tip: Review tip/summary if available

Reviewer Details

• reviewer.name: Reviewer's display name
• reviewer.username: Reviewer's username
• reviewer.profile_link: Link to reviewer's profile
• reviewer.contribution_count: Number of reviews written by reviewer
• reviewer.is_verified: Whether reviewer is verified
• reviewer.hometown.location_name_detailed: Reviewer's hometown

Trip Information

• trip.trip_type: Type of travel (business, leisure, etc.)
• trip.stay_date: Date of stay/visit

Owner Response

• owner_response.published_date: When response was posted
• owner_response.connection_to_place: Respondent's role
• owner_response.profile_link: Link to respondent's profile
• owner_response.text: Response text content

Additional Content

• subratings: Detailed sub-ratings (cleanliness, service, etc.)
• images: Array of images associated with the review

🌍 Supported Locales

The scraper supports 30+ regional TripAdvisor versions:

• Americas: en-US, en-CA, fr-CA, pt-BR, es-MX, es-AR, es-CL, es-CO, es-PE, es-VE
• Europe: en-GB, it-IT, es-ES, de-DE, fr-FR, sv-SE, nl-NL, tr-TR, da-DK, en-IE, de-AT, el-GR, nb-NO, pt-PT, ru-RU
• Asia-Pacific: ja-JP, en-IN, en-AU, en-MY, en-NZ, en-PH, en-SG
• Multilingual: de-CH, fr-CH, it-CH, fr-BE, nl-BE

💡 Usage Examples

Basic Usage - Extract Recent Reviews

{
  "query": ["https://www.tripadvisor.com/Hotel_Review-g60763-d208453-Reviews-Hilton_New_York_Times_Square-New_York_City_New_York.html"],
  "reviewsPerPlace": 100,
  "sortBy": "most_recent"
}

Advanced Filtering - Business Travelers

{
  "query": ["126260"],
  "travelerType": ["business"],
  "ratingIs": ["4", "5"],
  "reviewsPerPlace": 50,
  "sortBy": "detailed_reviews"
}

Comprehensive Extraction - All Reviews

{
  "query": ["Lotte New York Palace", "The Plaza Hotel"],
  "parseAllReviews": true,
  "monthsOfVisit": ["jun", "jul", "aug"],
  "keyword": "service",
  "locale": "en-US"
}

Multi-language Analysis

{
  "query": ["https://www.tripadvisor.com/Restaurant_Review-g187147-d10240950-Reviews-Le_Comptoir_du_Relais-Paris_Ile_de_France.html"],
  "lang": "fr,en",
  "reviewsPerPlace": 200,
  "parseAllReviews": false
}

🐛 Troubleshooting

Common Issues

Issue: No reviews found for a location Solution:

• Verify the TripAdvisor URL or ID is correct
• Check if the location has reviews available
• Try different sorting options

Issue: Rate limiting errors Solution:

• Reduce the number of concurrent requests
• Increase delays between requests
• Consider upgrading to a paid plan for higher limits

Issue: Incomplete data extraction Solution:

• Check if specific data fields are available for the target location
• Some locations may not have all data fields (e.g., owner responses)
• Try with different locales or language settings

Error Messages

• "No queries provided": Ensure the query parameter is provided with valid values
• "Request failed with status code": Temporary API issue, retry the request
• "No more reviews found": All available reviews have been extracted

📞 Support

For technical support, feature requests, or bug reports:

1. Documentation: Check this README and inline code comments
2. Community: Join our developer community for tips and best practices
3. Issues: Report bugs or request features through the platform's issue tracker

🔄 Updates & Changelog

Version 1.0

• Initial release with comprehensive review extraction
• Support for multiple query types (URLs, IDs, location names)
• Advanced filtering and sorting capabilities
• Multi-language and locale support
• Structured JSON output with detailed review data

📄 License

This actor is provided under the standard Apify license. Please ensure compliance with TripAdvisor's terms of service when using this tool.

---

Note: This tool is designed for legitimate data extraction and research purposes. Users are responsible for ensuring compliance with applicable laws, regulations, and platform terms of service.