# Trip.com Hotels Scraper (`shahidirfan/trip-com-hotels-scraper`) Actor Extract real-time hotel listings, prices, reviews & availability from Trip.com. Perfect for travel research, price monitoring & competitive analysis. Get structured data instantly. - **URL**: https://apify.com/shahidirfan/trip-com-hotels-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** Travel, Automation, Lead generation - **Stats:** 5 total users, 3 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 Collect Trip.com hotel search results with hotel names, room offers, review scores, star ratings, map coordinates, and live pricing. Provide a Trip.com hotel search URL and the actor derives the request context directly from it. ### Features - **Hotel search extraction** — Capture listings directly from Trip.com hotel search result pages - **Price and room coverage** — Collect headline room names, live display prices, deleted prices, and currencies - **Review insights** — Save review score, review summary, review count text, and sub-score breakdowns - **Location context** — Keep city, address, area description, zones, and map coordinates together - **Lean dataset output** — Empty and null fields are removed before records are saved ### Use Cases #### Travel Research Build accommodation shortlists for a city and compare ratings, room names, and displayed prices across many hotels in one run. #### Pricing Intelligence Monitor price shifts for a destination and store snapshots for trend analysis, alerts, or reporting workflows. #### Market Comparison Compare hotel categories, review performance, and location positioning across neighborhoods or travel dates. #### Content Enrichment Populate internal travel dashboards, destination guides, or search indexes with structured hotel listing data. ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `startUrl` | String | Yes | None | Trip.com hotel search URL used as the source of destination, dates, guest settings, and currency | | `results_wanted` | Integer | No | `20` | Maximum number of hotel records to save | | `max_pages` | Integer | No | `3` | Safety cap for paginated requests | | `proxyConfiguration` | Object | No | `{"useApifyProxy": false}` | Optional proxy settings for repeated or blocked runs | ### Output Data Each dataset item can contain: | Field | Type | Description | |-------|------|-------------| | `hotelId` | String | Trip.com hotel identifier | | `masterHotelId` | String | Master hotel identifier | | `hotelType` | String | Hotel type label returned by Trip.com | | `hotelName` | String | Displayed hotel name | | `hotelNameEn` | String | English hotel name | | `hotelCategory` | String | Category such as hotel or apartment | | `starRating` | Number | Star category | | `reviewScore` | Number | Headline review score | | `reviewDescription` | String | Review sentiment label | | `reviewCount` | Number | Parsed review count | | `reviewCountText` | String | Original review count text | | `featuredReview` | String | Short featured review sentence | | `reviewSubScores` | Array | Sub-score breakdowns such as cleanliness or location | | `cityId` | Number | Destination city identifier | | `cityName` | String | Destination city name | | `countryId` | Number | Country identifier | | `provinceId` | Number | Province identifier | | `address` | String | Address or area label | | `positionDescription` | String | Trip.com location summary | | `positionHighlights` | Array | Nearby area highlights | | `zoneNames` | Array | Zone names returned by Trip.com | | `latitude` | Number | Primary latitude | | `longitude` | Number | Primary longitude | | `imageUrl` | String | Main hotel image | | `imageUrls` | Array | Additional hotel images | | `hotelDetailUrl` | String | Trip.com hotel detail page | | `roomId` | String | Room identifier | | `roomName` | String | Headline room name | | `roomType` | String | Room result type | | `roomQuantity` | Number | Room quantity in the offer | | `displayPrice` | String | Formatted price shown on the listing | | `price` | Number | Numeric price value | | `currency` | String | Currency code | | `originalPrice` | Number | Deleted price before discount | | `originalDisplayPrice` | String | Deleted price as displayed text | | `priceExplanation` | String | Total price explanation from the listing | | `payType` | Number | Payment type returned by Trip.com | | `checkIn` | String | Check-in date in compact format | | `checkOut` | String | Check-out date in compact format | | `freeCancellation` | Boolean | Whether free cancellation is shown | | `advantageTags` | Array | Advantage tag titles | | `promotionTags` | Array | Promotion tag titles | | `discountTags` | Array | Discount tag titles | | `encourageTags` | Array | Urgency tag titles | | `resultPage` | Number | Result page number | | `positionOnPage` | Number | Approximate result position | | `searchUrl` | String | Search URL used for the request | | `fetchedAt` | String | ISO timestamp when the record was saved | ### Usage Examples #### Basic Extraction Collect the first 20 hotels from the provided Trip.com search URL: ```json { "startUrl": "https://us.trip.com/hotels/list?city=228&provinceId=0&countryId=78&checkIn=2026-05-18&checkOut=2026-05-30&lat=0&lon=0&districtId=0&barCurr=PKR&searchType=CT&searchValue=undefined&crn=1&adult=2&children=0&searchBoxArg=t&ctm_ref=ix_sb_dl&travelPurpose=0&domestic=false", "results_wanted": 20 } ```` #### Extended Collection Increase the cap and enable a proxy configuration for larger production runs: ```json { "startUrl": "https://us.trip.com/hotels/list?city=228&provinceId=0&countryId=78&checkIn=2026-05-18&checkOut=2026-05-30&lat=0&lon=0&districtId=0&barCurr=PKR&searchType=CT&searchValue=undefined&crn=1&adult=2&children=0&searchBoxArg=t&ctm_ref=ix_sb_dl&travelPurpose=0&domestic=false", "results_wanted": 60, "max_pages": 4, "proxyConfiguration": { "useApifyProxy": true } } ``` ### Sample Output ```json { "hotelId": "994584", "masterHotelId": "994584", "hotelType": "NORMAL", "hotelName": "Sunshine City Prince Hotel Ikebukuro Tokyo(Sunshine City Prince Hotel Ikebukuro Tokyo)", "hotelNameEn": "Sunshine City Prince Hotel Ikebukuro Tokyo", "hotelCategory": "Hotel", "starRating": 4, "reviewScore": 9, "reviewDescription": "Great", "reviewCount": 3359, "reviewCountText": "3,359 reviews", "featuredReview": "The hotel has an excellent location with an airport shuttle conveniently available right at the entrance.", "cityId": 228, "cityName": "Tokyo", "countryId": 78, "provinceId": 0, "address": "Ikebukuro Commercial", "positionDescription": "Near Ikebukuro Commercial | Otsuka Station", "zoneNames": [ "Ikebukuro Commercial" ], "latitude": 35.729534, "longitude": 139.719546, "imageUrl": "https://ak-d.tripcdn.com/images/0226912000ar2syzo655B_R_600_600_R5_D.jpg", "hotelDetailUrl": "https://us.trip.com/hotels/detail/?hotelId=994584", "roomId": "1399464744", "roomName": "City Floor Semi Double Room (17th-24th Floor)", "displayPrice": "PKR 47,784", "price": 47784, "currency": "PKR", "originalPrice": 50856, "originalDisplayPrice": "PKR 50,856", "priceExplanation": "Total price: PKR 631,977\n1 room x 12 nights incl. taxes and fees\nAdditional charges may apply", "freeCancellation": true, "advantageTags": [ "Free Cancellation" ], "promotionTags": [ "Special Discount" ], "discountTags": [ "6% off" ], "resultPage": 1, "positionOnPage": 1, "searchUrl": "https://us.trip.com/hotels/list?city=228&provinceId=0&countryId=78&checkIn=2026-05-18&checkOut=2026-05-30&lat=0&lon=0&districtId=0&barCurr=PKR&searchType=CT&searchValue=undefined&crn=1&adult=2&children=0&searchBoxArg=t&ctm_ref=ix_sb_dl&travelPurpose=0&domestic=false", "fetchedAt": "2026-04-13T00:00:00.000Z" } ``` ### Tips for Best Results #### Use A Working Search URL - Start from a Trip.com hotel result URL that already shows the destination and dates you want - Keep the stay details inside the URL accurate because the actor derives its request context from that URL #### Keep Runs Fast - Start with `results_wanted: 20` for validation and QA-friendly checks - Increase `max_pages` only when you need deeper pagination #### Use Currency Intentionally - Use a search URL that already contains the currency you want reflected in the saved price fields - Keep the same currency across comparison runs for cleaner downstream analysis #### Use Proxies When Needed - Larger or repeated production runs can benefit from `proxyConfiguration` - If a destination gets inconsistent responses, retry with Apify Proxy enabled ### Integrations - **Google Sheets** — Export hotel prices and ratings for side-by-side comparison - **Airtable** — Build searchable accommodation databases - **Make** — Trigger downstream travel workflows automatically - **Zapier** — Send hotel snapshots into business tools - **Webhooks** — Forward structured search results to internal systems #### Export Formats - **JSON** — For APIs, warehouses, and engineering workflows - **CSV** — For spreadsheet analysis - **Excel** — For travel ops and reporting teams - **XML** — For custom integrations ### Frequently Asked Questions #### Does the actor need a Trip.com hotel search URL? Yes. The actor is designed to derive destination, dates, guest counts, and currency directly from a Trip.com hotel search URL. #### Does it collect prices in other currencies? Yes. Use a Trip.com search URL that already includes the currency you want, such as `barCurr=PKR`. #### Does the dataset include empty fields? No. Empty strings, null values, empty arrays, and empty objects are removed before each record is saved. #### How many hotels can I collect? You can collect as many as the search result pagination provides, constrained by your `results_wanted` and `max_pages` settings. #### How is deep pagination kept stable? The actor keeps Trip.com's search session alive across requests, which prevents older result blocks from repeating on deeper pages. #### Does it include ratings and room details? Yes. The output includes review score, review text, star category, room name, pricing fields, and offer tags when Trip.com returns them. ### Support For issues or feature requests, use the Apify Console issue channel for this actor. #### Resources - [Apify Documentation](https://docs.apify.com/) - [Apify API Reference](https://docs.apify.com/api/v2) - [Scheduling Runs](https://docs.apify.com/platform/schedules) ### Legal Notice This actor is intended for legitimate data collection, travel research, and automation workflows. Users are responsible for complying with website terms and applicable laws in their jurisdiction. # Actor input Schema ## `startUrl` (type: `string`): Trip.com hotel search URL. The actor derives destination, dates, guests, and currency directly from this URL. ## `results_wanted` (type: `integer`): Maximum number of hotel records to save. ## `max_pages` (type: `integer`): Safety cap for paginated Trip.com search requests. ## `proxyConfiguration` (type: `object`): Optional proxy settings. Enable Apify Proxy if you need extra resilience for repeated production runs. ## Actor input object example ```json { "startUrl": "https://us.trip.com/hotels/list?city=228&provinceId=0&countryId=78&checkIn=2026-05-18&checkOut=2026-05-30&lat=0&lon=0&districtId=0&barCurr=PKR&searchType=CT&searchValue=undefined&crn=1&adult=2&children=0&searchBoxArg=t&ctm_ref=ix_sb_dl&travelPurpose=0&domestic=false", "results_wanted": 20, "max_pages": 3, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 = { "startUrl": "https://us.trip.com/hotels/list?city=228&provinceId=0&countryId=78&checkIn=2026-05-18&checkOut=2026-05-30&lat=0&lon=0&districtId=0&barCurr=PKR&searchType=CT&searchValue=undefined&crn=1&adult=2&children=0&searchBoxArg=t&ctm_ref=ix_sb_dl&travelPurpose=0&domestic=false", "results_wanted": 20, "max_pages": 3 }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/trip-com-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 = { "startUrl": "https://us.trip.com/hotels/list?city=228&provinceId=0&countryId=78&checkIn=2026-05-18&checkOut=2026-05-30&lat=0&lon=0&districtId=0&barCurr=PKR&searchType=CT&searchValue=undefined&crn=1&adult=2&children=0&searchBoxArg=t&ctm_ref=ix_sb_dl&travelPurpose=0&domestic=false", "results_wanted": 20, "max_pages": 3, } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/trip-com-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 '{ "startUrl": "https://us.trip.com/hotels/list?city=228&provinceId=0&countryId=78&checkIn=2026-05-18&checkOut=2026-05-30&lat=0&lon=0&districtId=0&barCurr=PKR&searchType=CT&searchValue=undefined&crn=1&adult=2&children=0&searchBoxArg=t&ctm_ref=ix_sb_dl&travelPurpose=0&domestic=false", "results_wanted": 20, "max_pages": 3 }' | apify call shahidirfan/trip-com-hotels-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/trip-com-hotels-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Trip.com Hotels Scraper", "description": "Extract real-time hotel listings, prices, reviews & availability from Trip.com. Perfect for travel research, price monitoring & competitive analysis. Get structured data instantly.", "version": "0.0", "x-build-id": "g5sZuLXGQIClNpwdF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~trip-com-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-trip-com-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/shahidirfan~trip-com-hotels-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-trip-com-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/shahidirfan~trip-com-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-trip-com-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", "required": [ "startUrl" ], "properties": { "startUrl": { "title": "Trip.com search URL", "type": "string", "description": "Trip.com hotel search URL. The actor derives destination, dates, guests, and currency directly from this URL." }, "results_wanted": { "title": "Maximum number of hotels", "minimum": 1, "type": "integer", "description": "Maximum number of hotel records to save.", "default": 20 }, "max_pages": { "title": "Maximum pages", "minimum": 1, "type": "integer", "description": "Safety cap for paginated Trip.com search requests.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy settings. Enable Apify Proxy if you need extra resilience for repeated production runs.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```