# Trip.com Hotels Scraper (`fetch_cat/trip-com-hotels-scraper`) Actor Scrape public Trip.com hotel listings, prices, ratings, amenities, and URLs by destination. - **URL**: https://apify.com/fetch\_cat/trip-com-hotels-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** Travel - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.06 / 1,000 hotel result extracteds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 Collect public Trip.com hotel listings for destinations, market research, price monitoring, and travel planning workflows. ### What does Trip.com Hotels Scraper do? Trip.com Hotels Scraper extracts public hotel listing data from Trip.com destination pages. Provide one or more Trip.com hotel list URLs and the actor returns hotel names, Trip.com URLs, ratings, review counts, images, addresses when visible, prices when visible, and source metadata. ### Who is it for? - 🧳 Travel agencies comparing hotel inventory across destinations - 🏨 Hotel revenue teams monitoring nearby properties - 📊 Tourism analysts building destination supply datasets - 🛫 OTAs and metasearch teams checking public Trip.com coverage - 💼 Consultants preparing travel market reports ### Why use this actor? Manual hotel research is slow. This actor turns public Trip.com destination pages into structured rows that can be exported to JSON, CSV, Excel, or consumed from the Apify API. ### What data can you extract? | Field | Description | | --- | --- | | hotelName | Hotel name shown on Trip.com | | hotelUrl | Trip.com hotel detail URL | | destination | Destination detected from the listing page | | district | District or area when visible | | starRating | Hotel star rating when available | | guestRating | Guest review score | | reviewCount | Number of reviews | | price | Public price when visible in the page | | currency | Parsed currency code when visible | | taxesFeesText | Taxes or fee text when visible | | amenities | Amenity labels when visible | | imageUrl | Primary hotel image | | address | Address or location text when visible | | sourceUrl | Listing page URL scraped | | scrapedAt | ISO timestamp of extraction | ### How much does it cost to scrape Trip.com hotels? The actor uses pay-per-event pricing: a small start event plus a per-result event for each saved hotel listing. Final tiered pricing is calculated from cloud validation runs before publication so users pay in proportion to the number of hotels collected. ### Input The main input is `searchUrls`, an array of public Trip.com hotel list URLs. ```json { "searchUrls": [ { "url": "https://www.trip.com/hotels/tokyo-hotels-list-228/" } ], "maxItems": 20 } ```` ### Optional stay details You can provide optional stay parameters: - `checkIn` in `YYYY-MM-DD` format - `checkOut` in `YYYY-MM-DD` format - `adults` - `rooms` These values are appended to the Trip.com URLs when dates are supplied. ### Output example ```json { "hotelName": "KOKO HOTEL Tokyo Nishikasai", "hotelUrl": "https://www.trip.com/hotels/tokyo-hotel-detail-129054778/koko-hotel-tokyo-nishikasai/", "destination": "Tokyo", "district": null, "starRating": 3, "guestRating": 8.4, "reviewCount": 842, "price": null, "currency": null, "taxesFeesText": null, "amenities": [], "imageUrl": "https://ak-d.tripcdn.com/images/0221712000oahl31u544A.jpg", "address": null, "sourceUrl": "https://www.trip.com/hotels/tokyo-hotels-list-228/", "scrapedAt": "2026-06-29T10:43:35.793Z" } ``` ### How to run 1. Open the actor on Apify. 2. Paste one or more Trip.com hotel list URLs. 3. Set `maxItems` to the number of hotels you need. 4. Start the run. 5. Export results from the Dataset tab. ### Tips for best results - Use destination listing pages, not the Trip.com home page. - Start with a small `maxItems` value for your first run. - Use URLs copied from the Trip.com website in the same language/market you want to monitor. - If prices are important, include Trip.com URLs where prices are visible to public visitors. ### Integrations Use this actor in workflows such as: - Daily hotel market snapshots exported to Google Sheets - Destination inventory monitoring in a BI dashboard - Travel content enrichment pipelines - Hotel competitor lists for revenue management - Tourism research datasets for recurring reports ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('/trip-com-hotels-scraper').call({ searchUrls: [{ url: 'https://www.trip.com/hotels/tokyo-hotels-list-228/' }], maxItems: 20, }); console.log(run.defaultDatasetId); ``` ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient('MY-APIFY-TOKEN') run = client.actor('/trip-com-hotels-scraper').call(run_input={ 'searchUrls': [{'url': 'https://www.trip.com/hotels/tokyo-hotels-list-228/'}], 'maxItems': 20, }) print(run['defaultDatasetId']) ``` ### API usage with cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/~trip-com-hotels-scraper/runs?token=MY-APIFY-TOKEN' \ -H 'Content-Type: application/json' \ -d '{"searchUrls":[{"url":"https://www.trip.com/hotels/tokyo-hotels-list-228/"}],"maxItems":20}' ``` ### MCP for AI agents Connect this actor to Claude Desktop, Claude Code, or another MCP client through Apify MCP Server. MCP URL: ```text https://mcp.apify.com/?tools=/trip-com-hotels-scraper ``` Claude Code setup: ```bash claude mcp add apify-trip-hotels "https://mcp.apify.com/?tools=/trip-com-hotels-scraper" ``` Claude Desktop JSON config: ```json { "mcpServers": { "apify-trip-hotels": { "url": "https://mcp.apify.com/?tools=/trip-com-hotels-scraper" } } } ``` Example prompts: - "Scrape 20 hotels from this Trip.com Tokyo URL and summarize the average guest rating." - "Collect hotel names and Trip.com URLs for this destination and create a CSV." - "Compare review counts for the top hotels in these Trip.com destination pages." ### Legality and responsible use This actor collects publicly available information from Trip.com pages. Always use the data responsibly, respect applicable laws, and review Trip.com's terms and local regulations for your use case. ### Limits Trip.com page content can vary by destination, locale, dates, and availability. Some fields may be null when Trip.com does not expose them publicly on the supplied page. Large runs should use sensible `maxItems` values. ### FAQ and troubleshooting #### Why are some prices empty? Trip.com does not always expose public prices on every hotel list response. Add check-in and check-out dates or use a listing page where prices are visibly shown. #### Why did I get zero results? Check that your input URL is a Trip.com hotel list page such as `/hotels/tokyo-hotels-list-228/`. Home pages, search landing pages, and unsupported pages may not contain hotel cards. ### Related scrapers - https://apify.com/\/airbnb-listings-scraper - https://apify.com/\/airbnb-reviews-scraper - https://apify.com/\/agoda-reviews-scraper ### Changelog #### 0.1 Initial version for public Trip.com hotel listing pages. ### Dataset export Results can be downloaded from Apify as JSON, CSV, XML, RSS, Excel, or HTML table. Use CSV for spreadsheets and JSON for application workflows. ### Quality notes The actor is designed for hotel listing rows. It does not scrape private account data, booking confirmations, user-only prices, or data behind a login. ### Support If a Trip.com URL does not work, share the run URL and the exact input so the actor can be improved. ### Field coverage Field coverage depends on the public content Trip.com returns for each destination page. The actor saves the source URL and scrape timestamp so records can be audited later. ### Best practices Run smaller recurring jobs instead of very large one-off jobs when monitoring destinations over time. This makes changes easier to compare and keeps individual runs fast. ### Example destinations Tokyo, Bangkok, London, Paris, New York, Singapore, Seoul, and other Trip.com destination pages can be supplied as long as they use public hotel list URLs. ### Data freshness Every run fetches current public page content from Trip.com. The actor does not reuse old dataset rows between runs. ### Automation ideas Schedule this actor daily or weekly, send the dataset to a database, and compare rating or price changes over time. ### Privacy The actor extracts hotel listing information only. It does not collect user accounts, private bookings, or payment data. # Actor input Schema ## `searchUrls` (type: `array`): Public Trip.com destination hotel list URLs, for example https://www.trip.com/hotels/tokyo-hotels-list-228/ ## `checkIn` (type: `string`): Optional check-in date in YYYY-MM-DD format. The date is appended to each Trip.com URL. ## `checkOut` (type: `string`): Optional check-out date in YYYY-MM-DD format. The date is appended to each Trip.com URL. ## `adults` (type: `integer`): Optional number of adults for date-specific Trip.com URLs. ## `rooms` (type: `integer`): Optional number of rooms for date-specific Trip.com URLs. ## `maxItems` (type: `integer`): Maximum number of hotel listings to save across all URLs. ## `proxyConfiguration` (type: `object`): Optional Apify Proxy settings. Datacenter proxies are usually enough; use residential only if your run is blocked. ## Actor input object example ```json { "searchUrls": [ { "url": "https://www.trip.com/hotels/tokyo-hotels-list-228/" } ], "adults": 2, "rooms": 1, "maxItems": 20, "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 = { "searchUrls": [ { "url": "https://www.trip.com/hotels/tokyo-hotels-list-228/" } ], "checkIn": "", "checkOut": "", "adults": 2, "rooms": 1, "maxItems": 20, "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/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 = { "searchUrls": [{ "url": "https://www.trip.com/hotels/tokyo-hotels-list-228/" }], "checkIn": "", "checkOut": "", "adults": 2, "rooms": 1, "maxItems": 20, "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/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 '{ "searchUrls": [ { "url": "https://www.trip.com/hotels/tokyo-hotels-list-228/" } ], "checkIn": "", "checkOut": "", "adults": 2, "rooms": 1, "maxItems": 20, "proxyConfiguration": { "useApifyProxy": false } }' | apify call fetch_cat/trip-com-hotels-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/trip-com-hotels-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Trip.com Hotels Scraper", "description": "Scrape public Trip.com hotel listings, prices, ratings, amenities, and URLs by destination.", "version": "0.1", "x-build-id": "TQ3VSa60iNMPEkprD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~trip-com-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-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/fetch_cat~trip-com-hotels-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-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/fetch_cat~trip-com-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-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": [ "searchUrls" ], "properties": { "searchUrls": { "title": "Trip.com hotel list URLs", "type": "array", "description": "Public Trip.com destination hotel list URLs, for example https://www.trip.com/hotels/tokyo-hotels-list-228/", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Optional check-in date in YYYY-MM-DD format. The date is appended to each Trip.com URL." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Optional check-out date in YYYY-MM-DD format. The date is appended to each Trip.com URL." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 20, "type": "integer", "description": "Optional number of adults for date-specific Trip.com URLs.", "default": 2 }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 10, "type": "integer", "description": "Optional number of rooms for date-specific Trip.com URLs.", "default": 1 }, "maxItems": { "title": "Maximum hotels", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of hotel listings to save across all URLs.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify Proxy settings. Datacenter proxies are usually enough; use residential only if your run is blocked." } } }, "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 } } } } } } } } } } ```