# TripAdvisor Hotel Reviews Scraper Get hotel reviews (hotel name, rating/ user name/ review content, etc.) from Tripadvisor by Hotel URL. - Template page: [https://www.octoparse.com/template/tripadvisor-hotel-reviews-scraper](https://www.octoparse.com/template/tripadvisor-hotel-reviews-scraper) - Categories: Travel - Status: `PUBLISHED` - Run mode: `CLOUD` ## Pricing Current price: **$0.8/1,000 lines**. Billing is based on output rows; an Octoparse subscription may be required. ## What is an Octoparse template? An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters. ## Overview This ready-to-use template collects structured data from review pages. ## Output The current workflow extracts 31 fields, including `Cleanliness_rating`, `Contributions`, `Country`, `CurrentReviewPage`, `Current_page_URL`, `Date_of_stay`, `Helpful_votes`, `HotelName`, `Hotel_Class`, `Hotel_location`, `Hotel_number`, `Hotel_rating`, `Location_rating`, `Number_of_review`, `Rating`, `Review`, `Review_Date`, `Rooms_rating`, `Service_rating`, `Sleep_quality_rating`, `Title`, `Trip_type`, `User`, `User_Address`, `User_cleanliness_rating`, `User_location_rating`, `User_rooms_rating`, `User_service_rating`, `User_sleep_quality`, `User_value_rating`, `Value_rating`. ## Use Cases - Use structured results for research, comparison, and monitoring. - Collect rows without building the extraction workflow from scratch. - Combine results with other templates for downstream enrichment. - Review a representative result before starting a large batch. ## Why Octoparse - **No coding required:** complete Hotel details page URLs (up to 1,000 per run), Sort by (default to Most recent), language and start the template in cloud mode. - **Flexible export:** review and export results as CSV, Excel, or JSON. ## Input ### Hotel details page URLs (up to 1,000 per run) Required. URL list Constraints: minItems=1; maxItems=1000; items.minLength=1; items.maxLength=11111111. ### Sort by (default to Most recent) Optional. Sort by Constraints: minLength=1; maxLength=100. ### language Optional. language Callable values are the `const` keys in JSON `oneOf`, not the option titles. ### Number of Reviews Optional. Number of Reviews ## How to Use # TripAdvisor Hotel Reviews Scraper Collect structured hotel and traveler review records from [Tripadvisor](https://www.tripadvisor.com/). Use the data for customer feedback/sentiment analysis, engagement comparison via `Helpful_votes`, ratings benchmarking via `Hotel_rating`/`Location_rating`/`Rooms_rating`, and geographic segmentation via `Hotel_location`/`User_Address`. ## Pricing - **$0.8 / 1,000 lines**. Billing is based on the number of output lines produced by the task. ## Input Parameters - **Hotel details page URLs** (Required) — URL list. Up to **1,000 entries per run**. - **Sort by (default to Most recent)** (Optional) - **language** (Optional) — All languages, English, German, French, Araic, Danish, Greek, Spanish, Indonesian, Italian, Japanese, Korean, Dutch, Norwegian, Portuguese, Russian, Swedish, Thai, Turkish, Chinese(Sim.), Chinese(Trad.), Vietnamese, Hebres. - **Number of Reviews** (Optional) The workflow opens each supplied hotel details page URL, applies the selected Sort by, language, and Number of Reviews settings, follows the configured page loops on Tripadvisor review pages, and emits structured rows containing fields such as `HotelName`, `Hotel_location`, `Hotel_number`, `Hotel_rating`, `Number_of_review`, and `Current_page_URL`. ## How to Use 1. Open **TripAdvisor Hotel Reviews Scraper** and click **Try it!**. 2. Complete **Hotel details page URLs**, **Sort by (default to Most recent)**, **language**, and optionally **Number of Reviews**, using the formats and limits in the Input Parameters section. 3. Run it in the Octoparse cloud and start the task. 4. Review fields such as `HotelName`, `Current_page_URL`, and `Hotel_rating`, then export the rows in the format you need. ## Tips - Test one representative value in **Hotel details page URLs** before submitting a large batch. - Keep `Current_page_URL` in the export so every row can be traced to its originating input or page. - The template processes Tripadvisor review pages; each run accepts up to 1,000 hotel details page URLs. ## Limitations Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above. ## Tips Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed. ## FAQ ### What do I need to enter? Use the exact inputs and limits listed above. ### What data does this template return? See Output Schema below; availability can vary by source record. ### How is usage billed? See the Pricing section above for current pricing and billing details. ## Related Templates - [TripAdvisor Scraper (Hotel Details)](https://www.octoparse.com/template/tripadvisor-scraper-hotel-details) - [TripAdvisor Scraper (Hotel Listing)](https://www.octoparse.com/template/tripadvisor-scraper-hotel-listing) - [TripAdvisor Hotel Review Scraper (for Italy)](https://www.octoparse.com/template/crawler-recensioni-hotel-tripadvisor) - [TripAdvisor Hotel Detail Scraper (for Italy)](https://www.octoparse.com/template/crawler-dettagli-hotel-tripadvisor) - [TripAdvisor Reviews Scraper (for Australia)](https://www.octoparse.com/template/tripadvisor-reviews-scraper-for-australia) ## Input Schema ```json { "title": "TripAdvisor Hotel Reviews Scraper input", "description": "Input parameters configured for the current published template version.", "type": "object", "schemaVersion": 1, "additionalProperties": false, "properties": { "hotel_details_page_URLs": { "title": "Hotel details page URLs (up to 1,000 per run)", "description": "URL list", "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 11111111 }, "minItems": 1, "maxItems": 1000, "x-octoparse": { "apiEnabled": true } }, "sort_by": { "title": "Sort by (default to Most recent)", "description": "Sort by", "type": "string", "minLength": 1, "maxLength": 100, "x-octoparse": { "apiEnabled": true } }, "language": { "title": "language", "description": "language", "type": "string", "oneOf": [ { "title": "All languages", "const": "All languages" }, { "title": "English", "const": "English" }, { "title": "German", "const": "German" }, { "title": "French", "const": "French" }, { "title": "Araic", "const": "Araic" }, { "title": "Danish", "const": "Danish" }, { "title": "Greek", "const": "Greek" }, { "title": "Spanish", "const": "Spanish" }, { "title": "Indonesian", "const": "Indonesian" }, { "title": "Italian", "const": "Italian" }, { "title": "Japanese", "const": "Japanese" }, { "title": "Korean", "const": "Korean" }, { "title": "Dutch", "const": "Dutch" }, { "title": "Norwegian", "const": "Norwegian" }, { "title": "Portuguese", "const": "Portuguese" }, { "title": "Russian", "const": "Russian" }, { "title": "Swedish", "const": "Swedish" }, { "title": "Thai", "const": "Thai" }, { "title": "Turkish", "const": "Turkish" }, { "title": "Chinese(Sim.)", "const": "Chinese(Sim.)" }, { "title": "Chinese(Trad.)", "const": "Chinese(Trad.)" }, { "title": "Vietnamese", "const": "Vietnamese" }, { "title": "Hebres", "const": "Hebres" } ], "x-octoparse": { "apiEnabled": true } }, "number_of_Reviews": { "title": "Number of Reviews", "description": "Number of Reviews", "type": "integer", "x-octoparse": { "apiEnabled": true } } }, "required": [ "hotel_details_page_URLs" ] } ``` ## Input JSON Example Example 1 ```json { "hotel_details_page_URLs": [ "https://www.tripadvisor.com.hk/Hotel_Review-g294217-d20970177-Reviews-Mondrian_Hong_Kong-Hong_Kong.html" ], "language": "All languages", "number_of_Reviews": 100, "sort_by": "positive review" } ``` Example 2 ```json { "hotel_details_page_URLs": [ "https://th.trip.com/travel-guide/attraction/phuket/chinpracha-house-22846340/" ], "language": "All languages", "number_of_Reviews": 1000 } ``` Example 3 ```json { "hotel_details_page_URLs": [ "https://www.tripadvisor.com/Attraction_Review-g23752162-d2178230-Reviews-Deyrulzafaran_Monastery-Alimli_Mardin_Province.html", "https://www.tripadvisor.com/Attraction_Review-g33286339-d2651171-Reviews-Mor_Gabriel_Monastery-Gungoren_Mardin_Province.html", "https://www.tripadvisor.com/Attraction_Review-g672951-d2534382-Reviews-KasImiye_Medresesi-Mardin_Mardin_Province.html", "https://www.tripadvisor.com/Attraction_Review-g672951-d2612974-Reviews-Zinciriye_Medresesi-Mardin_Mardin_Province.html", "https://www.tripadvisor.com/Attraction_Review-g672951-d2612977-Reviews-Great_Mosque_of_Mardin-Mardin_Mardin_Province.html" ], "language": "All languages" } ``` Example 4 ```json { "hotel_details_page_URLs": [ "https://www.tripadvisor.es/Attraction_Review-g562647-d4891871-Reviews-Casa_de_Oficios_y_Caballeros-Aranjuez.html", "https://www.tripadvisor.es/Attraction_Review-g562647-d4928301-Reviews-Casa_de_los_Infantes-Aranjuez.html", "https://www.tripadvisor.es/Attraction_Review-g562647-d5998817-Reviews-Casa_del_Labrador-Aranjuez.html", "https://www.tripadvisor.es/Attraction_Review-g562647-d4866884-Reviews-Real_Iglesia_de_San_Antonio-Aranjuez.html", "https://www.tripadvisor.es/Attraction_Review-g562647-d2358499-Reviews-Jardin_de_Isabel_II-Aranjuez.html" ], "language": "All languages", "number_of_Reviews": 100 } ``` Example 5 ```json { "hotel_details_page_URLs": [ "https://www.tripadvisor.es/Attraction_Review-g187514-d4602737-Reviews-Edificio_Metropolis-Madrid.html" ], "language": "All languages", "number_of_Reviews": 1500 } ``` ## Output Schema ```json { "schemaVersion": 1, "type": "object", "properties": { "Cleanliness_rating": { "type": "string", "description": "" }, "Contributions": { "type": "string", "description": "" }, "Country": { "type": "string", "description": "" }, "CurrentReviewPage": { "type": "string", "description": "" }, "Current_page_URL": { "type": "string", "description": "" }, "Date_of_stay": { "type": "string", "description": "" }, "Helpful_votes": { "type": "string", "description": "" }, "HotelName": { "type": "string", "description": "" }, "Hotel_Class": { "type": "string", "description": "" }, "Hotel_location": { "type": "string", "description": "" }, "Hotel_number": { "type": "string", "description": "" }, "Hotel_rating": { "type": "string", "description": "" }, "Location_rating": { "type": "string", "description": "" }, "Number_of_review": { "type": "string", "description": "" }, "Rating": { "type": "string", "description": "" }, "Review": { "type": "string", "description": "" }, "Review_Date": { "type": "string", "description": "" }, "Rooms_rating": { "type": "string", "description": "" }, "Service_rating": { "type": "string", "description": "" }, "Sleep_quality_rating": { "type": "string", "description": "" }, "Title": { "type": "string", "description": "" }, "Trip_type": { "type": "string", "description": "" }, "User": { "type": "string", "description": "" }, "User_Address": { "type": "string", "description": "" }, "User_cleanliness_rating": { "type": "string", "description": "" }, "User_location_rating": { "type": "string", "description": "" }, "User_rooms_rating": { "type": "string", "description": "" }, "User_service_rating": { "type": "string", "description": "" }, "User_sleep_quality": { "type": "string", "description": "" }, "User_value_rating": { "type": "string", "description": "" }, "Value_rating": { "type": "string", "description": "" } }, "title": "TripAdvisor Hotel Reviews Scraper output", "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.", "additionalProperties": false } ``` ## Output Example Example 1 ```json { "Cleanliness_rating": "", "Contributions": "15", "Country": "新加坡新加坡", "CurrentReviewPage": "1", "Current_page_URL": "https://www.tripadvisor.com.hk/Hotel_Review-g294217-d20970177-Reviews-Mondrian_Hong_Kong-Hong_Kong.html", "Date_of_stay": "2026-08", "Helpful_votes": "2", "HotelName": "香港梦卓恩酒店", "Hotel_Class": "", "Hotel_location": "8A Hart Avenue Tsim Sha Tsui, HK", "Hotel_number": "3550 0388", "Hotel_rating": "4.9", "Location_rating": "", "Number_of_review": "1801", "Rating": "5", "Review": "Location: 5/5\nComfort: 5/5\nCleanliness: 5/5\n\nLocation is very near to the MTR station making it very convenient for us to travel around. There's also a lot of eateries and bar/bistro nearby, so if you want to chill out in the night there are many options available.\n\nThe room is clean and comfortable. \n\nStaff members were all very friendly giving off a very welcoming vibe everytime we enter or leaves the hotel. Housekeeping team was very friendly too, asking if we need anything everytime she sees us coming out the room.\n\nYou should definitely drop by the rooftop to have a look at the night view. \n\nOnly con is that the shower area a little small, everytime we bend over we will almost hit our head. So if you're about 1.6m tall and above do be careful when bending over.", "Review_Date": "2026-09-02T03:03:45.228Z", "Rooms_rating": "", "Service_rating": "", "Sleep_quality_rating": "", "Title": "Comfortable Stay", "Trip_type": "COUPLES", "User": "Asta1988", "User_Address": "新加坡新加坡", "User_cleanliness_rating": "", "User_location_rating": "", "User_rooms_rating": "", "User_service_rating": "", "User_sleep_quality": "", "User_value_rating": "", "Value_rating": "" } ``` Example 2 ```json { "Cleanliness_rating": "", "Contributions": "12148", "Country": "Maryland", "CurrentReviewPage": "1", "Current_page_URL": "https://www.tripadvisor.com/Attraction_Review-g293920-d2704719-Reviews-Chinpracha_House-Phuket.html", "Date_of_stay": "2024-02", "Helpful_votes": "1054", "HotelName": "", "Hotel_Class": "", "Hotel_location": "", "Hotel_number": "", "Hotel_rating": "4.0", "Location_rating": "", "Number_of_review": "63,\"bestRating\":5", "Rating": "5", "Review": "After paying 150 Thb each, we joined a 90 minute tour given by the fifth generation owner/resident, Mr Tan. His historic family ventured from Fujian, China to Penang, Malaysia as traders, then settled here with the Tin mining industry. They built, then preserved, this mansion which displays original furnishings in an Asian and European style called Peranakan. He detailed the home’s blended architecture using special concrete, air circulation, stairway woodwork detailing life goals, Chinese furniture, blended fabrics and clothing and finally the wife’s kitchen.\nHaving visited the other 3 historical Peranakan museums here, this is the one I wouldn't have missed.", "Review_Date": "2024-02-25", "Rooms_rating": "", "Service_rating": "", "Sleep_quality_rating": "", "Title": "Wonderful tour of a 1903 Sino-colonial home.", "Trip_type": "COUPLES", "User": "Gene R J", "User_Address": "Silver Spring, Maryland", "User_cleanliness_rating": "", "User_location_rating": "", "User_rooms_rating": "", "User_service_rating": "", "User_sleep_quality": "", "User_value_rating": "", "Value_rating": "" } ``` Example 3 ```json { "Cleanliness_rating": "", "Contributions": "7", "Country": "Türkiye", "CurrentReviewPage": "1", "Current_page_URL": "https://www.tripadvisor.com/Attraction_Review-g33286339-d2651171-Reviews-Mor_Gabriel_Monastery-Gungoren_Mardin_Province.html", "Date_of_stay": "2025-11", "Helpful_votes": "None", "HotelName": "", "Hotel_Class": "", "Hotel_location": "", "Hotel_number": "", "Hotel_rating": "4.7", "Location_rating": "", "Number_of_review": "284,\"bestRating\":5", "Rating": "2", "Review": "Monastery Midiat is 23 km away. It looks like a palace built on a high hill. It''s a quiet, truly clean place. They don’t even smoke in any area, which is nice. The Guide was just too short and dislike questions. He was constantly busy with the phone.You can see a 20%-like section of the monastery, 2 rooms and courtyard, and the rest are not allowed because the rest are living areas. The guide needs improvement. We visited late November 2025. Museum card etc is not valid all entrance 150 tl. \nIn short , the cleanliness is super , information , promotion is not enough , the areas shown are very limited.", "Review_Date": "2025-11-26", "Rooms_rating": "", "Service_rating": "", "Sleep_quality_rating": "", "Title": "GUIDE SERVICE MUST BE IMPLEMENTED", "Trip_type": "FRIENDS", "User": "Ayşe Nur B", "User_Address": "Istanbul, Türkiye", "User_cleanliness_rating": "", "User_location_rating": "", "User_rooms_rating": "", "User_service_rating": "", "User_sleep_quality": "", "User_value_rating": "", "Value_rating": "" } ``` Example 4 ```json { "Cleanliness_rating": "", "Contributions": "368", "Country": "Spain", "CurrentReviewPage": "1", "Current_page_URL": "https://www.tripadvisor.es/Attraction_Review-g562647-d4928301-Reviews-Casa_de_los_Infantes-Aranjuez.html", "Date_of_stay": "2022-09", "Helpful_votes": "121", "HotelName": "", "Hotel_Class": "", "Hotel_location": "", "Hotel_number": "", "Hotel_rating": "3.7", "Location_rating": "", "Number_of_review": "29,\"bestRating\":5", "Rating": "1", "Review": "Aranjuez en general su patrimonio es decepción total, sin mantenimiento,muy sucio y descuidado. No hay nada exterior que merezca la pena ver ", "Review_Date": "2022-09-09", "Rooms_rating": "", "Service_rating": "", "Sleep_quality_rating": "", "Title": "Nada que ver", "Trip_type": "COUPLES", "User": "MGV2808", "User_Address": "Spain", "User_cleanliness_rating": "", "User_location_rating": "", "User_rooms_rating": "", "User_service_rating": "", "User_sleep_quality": "", "User_value_rating": "", "Value_rating": "" } ``` Example 5 ```json { "Cleanliness_rating": "", "Contributions": "267", "Country": "Uruguay", "CurrentReviewPage": "1", "Current_page_URL": "https://www.tripadvisor.es/Attraction_Review-g187514-d4602737-Reviews-Edificio_Metropolis-Madrid.html", "Date_of_stay": "2026-06", "Helpful_votes": "None", "HotelName": "", "Hotel_Class": "", "Hotel_location": "", "Hotel_number": "", "Hotel_rating": "4.4", "Location_rating": "", "Number_of_review": "1876,\"bestRating\":5", "Rating": "5", "Review": "Club Metrópolis is a place that stands out for its elegance and its distinguished atmosphere. From the first moment, the attention to detail is perceived. The service was impeccable: professional, attentive, and always willing to make the experience perfect. A place with a lot of style, excellent service, and an atmosphere that invites you to return. Without a doubt, a very good experience that we will repeat on our next visit to Madrid.", "Review_Date": "2026-07-05", "Rooms_rating": "", "Service_rating": "", "Sleep_quality_rating": "", "Title": "Elegance and excellence in every detail", "Trip_type": "COUPLES", "User": "VeroRusso1973", "User_Address": "Montevideo, Uruguay", "User_cleanliness_rating": "", "User_location_rating": "", "User_rooms_rating": "", "User_service_rating": "", "User_sleep_quality": "", "User_value_rating": "", "Value_rating": "" } ``` ## API `POST https://openapi.octoparse.com/api/agentTools/executeTask` This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token. Request body: `templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional. Obtain a token: ```http POST https://openapi.octoparse.com/token Content-Type: application/json { "username": "YOUR_USERNAME", "password": "YOUR_PASSWORD", "grant_type": "password" } ``` Use `data.access_token` as `Authorization: Bearer `. After starting, poll `getTaskStatus` and export with `exportData`. ```json { "templateName": "tripadvisor-hotel-reviews-scraper", "taskName": "TripAdvisor Hotel Reviews Scraper", "parameters": "{\"hotel_details_page_URLs\":[\"https://www.tripadvisor.com.hk/Hotel_Review-g294217-d20970177-Reviews-Mondrian_Hong_Kong-Hong_Kong.html\"],\"language\":\"All languages\",\"number_of_Reviews\":100,\"sort_by\":\"positive review\"}" } ``` ## Python Example ```python import json import requests OPENAPI_BASE = "https://openapi.octoparse.com" ACCESS_TOKEN = "YOUR_ACCESS_TOKEN" parameters = json.loads("{\"hotel_details_page_URLs\":[\"https://www.tripadvisor.com.hk/Hotel_Review-g294217-d20970177-Reviews-Mondrian_Hong_Kong-Hong_Kong.html\"],\"language\":\"All languages\",\"number_of_Reviews\":100,\"sort_by\":\"positive review\"}") response = requests.post( f"{OPENAPI_BASE}/api/agentTools/executeTask", headers={ "Authorization": f"Bearer {ACCESS_TOKEN}", "Content-Type": "application/json", }, json={ "templateName": "tripadvisor-hotel-reviews-scraper", "taskName": "TripAdvisor Hotel Reviews Scraper", "parameters": json.dumps(parameters, ensure_ascii=False), }, timeout=60, ) print(response.status_code) print(response.json()) ``` ## HTTP/cURL Example ```bash curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ --data-binary @- <<'JSON' { "templateName": "tripadvisor-hotel-reviews-scraper", "taskName": "TripAdvisor Hotel Reviews Scraper", "parameters": "{\"hotel_details_page_URLs\":[\"https://www.tripadvisor.com.hk/Hotel_Review-g294217-d20970177-Reviews-Mondrian_Hong_Kong-Hong_Kong.html\"],\"language\":\"All languages\",\"number_of_Reviews\":100,\"sort_by\":\"positive review\"}" } JSON ``` ## MCP Setup Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `tripadvisor-hotel-reviews-scraper`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results. ## Machine-readable Resources - [Template contract](https://www.octoparse.com/templates/tripadvisor-hotel-reviews-scraper.json) - [Manifest](https://www.octoparse.com/templates/tripadvisor-hotel-reviews-scraper-manifest.json)