# Trip.com Hotels Scraper β€” Price, Score & Location (`memo23/tripcom-hotels-scraper`) Actor Scrape Trip.com hotels AND their guest reviews. Search a city by dates for hotels β€” name, star, guest score, price + total incl. taxes, coordinates β€” or pull every review for a hotel with ratings, sub-ratings, trip type and the hotel's reply. No login. JSON or CSV - **URL**: https://apify.com/memo23/tripcom-hotels-scraper.md - **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community) - **Categories:** Travel, AI, Agents - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.49 / 1,000 hotels This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Trip.com Hotels Scraper 🏨 **Scrape hotels and guest reviews from [Trip.com](https://www.trip.com).** Search a city by dates to pull matching hotels β€” name, star rating, guest score, price (with total incl. taxes), coordinates and more β€” or point it at a hotel to pull **every guest review** with ratings, sub-ratings, trip type, room and the hotel's reply. Pure HTTP β€” no login, no browser, no CAPTCHA. JSON or CSV. ![How the Trip.com Hotels Scraper works](https://raw.githubusercontent.com/muhamed-didovic/muhamed-didovic.github.io/main/assets/how-it-works-tripcom.png) ### ✨ Why use this scraper - **Two verticals in one actor.** Scrape **hotels** (search a city + dates) *and* **reviews** (per hotel) β€” most scrapers do only one. - **The deepest hotel schema β€” up to 60 fields.** Name, star rating, guest score + review count, **nightly price and total incl. taxes**, discount strike-price, coordinates, address, city, category, images, tags and Trip.com rankings. - **Full reviews with sub-ratings.** Every review carries the text, overall rating **and** sub-ratings (location / service / room / facility), trip type, room, check-in date, language, helpful-count, photos β€” and **the hotel's reply**. - **Real prices, real totals.** Both the nightly rate and the all-in total (incl. taxes & fees), plus discounts β€” as Trip.com actually shows them. - **Pure HTTP.** No headless browser, no CAPTCHA solver β€” via residential proxies. Fast, cheap, reliable. - **Flat, spreadsheet-ready rows.** One row per hotel or per review. Open the CSV and filter. ### 🎯 Use cases | You are… | Use it to… | |---|---| | **Revenue / OTA analyst** | Track hotel prices (incl. taxes) and availability across a city over time. | | **Hotel / brand** | Monitor competitors' scores, rankings and guest sentiment (reviews mode). | | **Reputation / CX team** | Pull every review for a property with sub-ratings and trip type for analysis. | | **Travel app / aggregator** | Feed structured hotel + review data into your own product. | | **Researcher** | Build a dataset of hotel pricing, quality and guest feedback by market. | ### πŸ“₯ Supported inputs | Mode | Input | Output | |---|---|---| | **Hotels β€” city** | `cityId: "338"` + `checkIn` / `checkOut` | Matching hotels for that city + dates | | **Hotels β€” URL** | `searchUrls: ["https://www.trip.com/hotels/list?city=338&checkin=…"]` | Hotels for that pasted list URL | | **Reviews** | `hotelUrls: ["https://www.trip.com/hotels/detail/?hotelId=2194717"]` (or `hotelIds`) | Every guest review for each hotel | The **city ID** is the `city=` value in any Trip.com hotel list URL (e.g. `338` = London). **Not supported:** booking, member-only prices, or anything behind a Trip.com login. ### πŸ”„ How it works 1. **Hotels** β€” for each city/URL the actor reads Trip.com's own hotel-list data and pages through the results, flattening each hotel to one row. 2. **Reviews** β€” for each hotel it calls Trip.com's guest-review API and paginates to the full review count. 3. **Emit** β€” hotels are de-duplicated by hotel ID, reviews by review ID; everything is pushed as flat rows, via rotating residential proxies, no browser. ### βš™οΈ Input parameters | Field | Type | Default | Description | |---|---|---|---| | `cityId` | string | β€” | Trip.com city ID (the `city=` value in a list URL). | | `checkIn` / `checkOut` | string | β€” | Dates, `YYYY-MM-DD`. | | `adults` / `rooms` | integer | 2 / 1 | Occupancy. | | `currency` | string | `USD` | Price currency. | | `searchUrls` | array | β€” | Paste Trip.com hotel list URLs (alternative to city + dates). | | `hotelUrls` | array | β€” | Hotel detail URLs β†’ scrape their **reviews**. | | `hotelIds` | array | β€” | Hotel IDs β†’ scrape their **reviews**. | | `maxReviewsPerHotel` | integer | 100 | Cap on reviews per hotel (reviews mode). | | `maxItems` | integer | 200 | Max rows per run. Free-tier capped at 100. | | `maxConcurrency` | integer | 6 | Parallel fetches. | | `proxy` | object | Residential | Residential rotation keeps large pulls stable. | #### Example β€” hotels ```json { "cityId": "338", "checkIn": "2026-07-20", "checkOut": "2026-07-21", "maxItems": 100 } ```` #### Example β€” reviews ```json { "hotelUrls": ["https://www.trip.com/hotels/detail/?hotelId=2194717"], "maxReviewsPerHotel": 200 } ``` ### πŸ“Š Output overview Two row shapes share one dataset. **Hotel** rows (hotels mode) carry the property, pricing and location; **review** rows (reviews mode) carry one guest review each. Prices come both as the nightly rate and the all-in total incl. taxes, exactly as Trip.com displays them. ### πŸ“¦ Output samples **Hotel row:** ```json { "hotelId": "2194717", "name": "The Dorchester", "url": "https://www.trip.com/hotels/detail/?hotelId=2194717", "starRating": 5, "guestScore": 9.8, "scoreDescription": "Outstanding", "reviewCount": 95, "price": 1690, "displayPrice": "US$1,690", "totalPrice": "Total (incl. taxes & fees): US$2,028", "cityName": "London", "address": "Mayfair", "latitude": 51.507018, "longitude": -0.152243, "category": "Hotel", "rankLabel": "2026 Global 100 - Luxury Hotels", "imageCount": 6, "source": "search" } ``` **Review row:** ```json { "reviewId": "1784337459", "hotelId": "2194717", "content": "From entering until leaving the standard of service is unsurpassed…", "rating": 10, "ratingLevel": "Outstanding", "ratingLocation": 10, "ratingService": 10, "ratingRoom": 10, "travelType": "Business traveler", "roomName": "Superior Room", "createDate": "2025-12-16 23:10:22", "checkinDate": "2025-12-01 00:00:00", "language": "en", "usefulCount": 0, "hotelReply": null, "source": "review" } ``` ### πŸ—‚ Key output fields | Field | Meaning | |---|---| | `name` / `starRating` / `guestScore` / `reviewCount` | Hotel name, official stars, guest score and how many reviews. | | `price` / `displayPrice` / `totalPrice` / `strikePrice` | Nightly price, as displayed, the all-in total incl. taxes, and any pre-discount price. | | `latitude` / `longitude` / `address` / `cityName` | Where the hotel is. | | `category` / `rankLabel` / `tags` | Property type, Trip.com ranking, highlights. | | `content` / `rating` / `ratingLevel` | *(review)* The review text, overall score and label. | | `ratingLocation` / `ratingService` / `ratingRoom` / `ratingFacility` | *(review)* Sub-ratings. | | `travelType` / `roomName` / `checkinDate` | *(review)* Trip type, room stayed in, stay date. | | `hotelReply` / `usefulCount` / `imageUrls` | *(review)* The hotel's reply, helpful votes, review photos. | ### ❓ FAQ **Do I need a Trip.com account or API key?** No β€” no login and nothing to supply. The actor reads public data only. **Where do I find the city ID?** Open a hotel search on Trip.com and copy the `city=` value from the URL (e.g. `.../hotels/list?city=338` β†’ `338`). **How many hotels does a city search return?** The top hotels for that city and dates (ranked as Trip.com ranks them), each with the full field set. For a specific hotel's complete data, use reviews mode with its URL. **How many reviews can I get per hotel?** Up to the hotel's full review count β€” paginated automatically. Cap it with `maxReviewsPerHotel`. **Why is `price` sometimes null?** Some listings show no bookable rate for the given dates; `displayPrice` reflects what Trip.com returns. **How fresh is the data?** Live β€” each run hits the current listings and reviews. ### πŸ’¬ Support Found a bug or need an extra field? Open an issue on the actor's **Issues** tab and we'll take a look. ### πŸ›  Additional services Need scheduled runs, another travel site, or a custom feed? Reach out via the Apify contact form on the actor page. ### πŸ”Ž Explore more scrapers See the [full memo23 actor catalog β†’](https://apify.com/memo23) *** ### ⚠️ Disclaimer This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Trip.com, Trip.com Group, Ctrip, or any of their subsidiaries or affiliates. All trademarks mentioned are the property of their respective owners. The scraper accesses only publicly available hotel and review pages β€” no authenticated endpoints, member-only prices, or content behind a Trip.com login. Users are responsible for ensuring their use complies with Trip.com's Terms of Service, applicable data-protection law (GDPR, CCPA, etc.), and any contractual obligations of their own organisation. *** ### SEO Keywords trip.com scraper, trip.com hotels scraper, scrape trip.com, trip.com api, trip.com hotel data, trip.com reviews scraper, hotel price scraper, hotel reviews scraper, ctrip scraper, travel data scraper, hotel data extractor, ota price monitoring, hotel rate scraper, guest reviews scraper, trip.com hotel prices, hotel ranking data, apify trip.com, hotel json csv export, hotel review sentiment data, trip.com listings scraper # Actor input Schema ## `searchUrls` (type: `array`): Trip.com hotel list URLs, e.g. https://www.trip.com/hotels/list?city=338\&checkin=2026/07/20\&checkout=2026/07/21. On-page filters and sort in the URL are carried over. ## `cityId` (type: `string`): Trip.com city ID (the `city=` value in a hotel list URL). E.g. 338 = London, 359 = Paris, 347 = New York. ## `checkIn` (type: `string`): Check-in date, YYYY-MM-DD (e.g. 2026-07-20). ## `checkOut` (type: `string`): Check-out date, YYYY-MM-DD (e.g. 2026-07-21). ## `adults` (type: `integer`): Number of adult guests. ## `rooms` (type: `integer`): Number of rooms. ## `currency` (type: `string`): Price currency. ## `hotelUrls` (type: `array`): Trip.com hotel detail URLs, e.g. https://www.trip.com/hotels/detail/?hotelId=2194717 β€” their reviews are scraped. ## `hotelIds` (type: `array`): Hotel IDs to scrape reviews from (alternative to Hotel URLs above). ## `maxReviewsPerHotel` (type: `integer`): Cap on reviews pulled per hotel in reviews mode. ## `maxItems` (type: `integer`): Hard cap on hotel rows per run. Each kept hotel is one paid result. Default 200. Free-tier users are capped at 100. ## `maxConcurrency` (type: `integer`): How many search sources to paginate in parallel. 5-8 is the reliable sweet spot. ## `proxy` (type: `object`): Proxy settings. The site works direct, but residential rotation keeps large pulls stable. The default works out of the box. ## Actor input object example ```json { "searchUrls": [ "https://www.trip.com/hotels/list?city=338&checkin=2026/07/20&checkout=2026/07/21" ], "adults": 2, "rooms": 1, "currency": "USD", "maxReviewsPerHotel": 100, "maxItems": 200, "maxConcurrency": 6, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchUrls": [ "https://www.trip.com/hotels/list?city=338&checkin=2026/07/20&checkout=2026/07/21" ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("memo23/tripcom-hotels-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchUrls": ["https://www.trip.com/hotels/list?city=338&checkin=2026/07/20&checkout=2026/07/21"], "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("memo23/tripcom-hotels-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchUrls": [ "https://www.trip.com/hotels/list?city=338&checkin=2026/07/20&checkout=2026/07/21" ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call memo23/tripcom-hotels-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=memo23/tripcom-hotels-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Trip.com Hotels Scraper β€” Price, Score & Location", "description": "Scrape Trip.com hotels AND their guest reviews. Search a city by dates for hotels β€” name, star, guest score, price + total incl. taxes, coordinates β€” or pull every review for a hotel with ratings, sub-ratings, trip type and the hotel's reply. No login. JSON or CSV", "version": "0.0", "x-build-id": "gZm60L2I9ZxFr1lLQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~tripcom-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-tripcom-hotels-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/memo23~tripcom-hotels-scraper/runs": { "post": { "operationId": "runs-sync-memo23-tripcom-hotels-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/memo23~tripcom-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-tripcom-hotels-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchUrls": { "title": "Hotel list URLs", "type": "array", "description": "Trip.com hotel list URLs, e.g. https://www.trip.com/hotels/list?city=338&checkin=2026/07/20&checkout=2026/07/21. On-page filters and sort in the URL are carried over.", "items": { "type": "string" } }, "cityId": { "title": "City ID", "type": "string", "description": "Trip.com city ID (the `city=` value in a hotel list URL). E.g. 338 = London, 359 = Paris, 347 = New York." }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Check-in date, YYYY-MM-DD (e.g. 2026-07-20)." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Check-out date, YYYY-MM-DD (e.g. 2026-07-21)." }, "adults": { "title": "Adults", "minimum": 1, "type": "integer", "description": "Number of adult guests.", "default": 2 }, "rooms": { "title": "Rooms", "minimum": 1, "type": "integer", "description": "Number of rooms.", "default": 1 }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "AUD", "CAD", "SGD", "HKD", "JPY", "CNY" ], "type": "string", "description": "Price currency.", "default": "USD" }, "hotelUrls": { "title": "Hotel URLs (for reviews)", "type": "array", "description": "Trip.com hotel detail URLs, e.g. https://www.trip.com/hotels/detail/?hotelId=2194717 β€” their reviews are scraped.", "items": { "type": "string" } }, "hotelIds": { "title": "Hotel IDs (for reviews)", "type": "array", "description": "Hotel IDs to scrape reviews from (alternative to Hotel URLs above).", "items": { "type": "string" } }, "maxReviewsPerHotel": { "title": "Max reviews per hotel", "minimum": 1, "type": "integer", "description": "Cap on reviews pulled per hotel in reviews mode.", "default": 100 }, "maxItems": { "title": "Maximum hotels", "minimum": 1, "type": "integer", "description": "Hard cap on hotel rows per run. Each kept hotel is one paid result. Default 200. Free-tier users are capped at 100.", "default": 200 }, "maxConcurrency": { "title": "Max parallel fetches", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many search sources to paginate in parallel. 5-8 is the reliable sweet spot.", "default": 6 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. The site works direct, but residential rotation keeps large pulls stable. The default works out of the box.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```