# ๐Ÿ”ฅ Trip.com Hotels Scraper โ€” Prices & Reviews (`bebity/trip-com-hotels-scraper`) Actor ๐Ÿš€ Scrape Trip.com hotels by city name or search URL: prices, star ratings, guest scores, reviews, rooms, facilities, photos, addresses. Deep pagination โ€” ask for 1,000, get 1,000. ๐Ÿค– LLM- and agent-optimized: one uniform JSON row per hotel, priced per hotel, ready for RAG and MCP pipelines. - **URL**: https://apify.com/bebity/trip-com-hotels-scraper.md - **Developed by:** [Bebity](https://apify.com/bebity) (community) - **Categories:** Travel, Automation, Lead generation - **Stats:** 81 total users, 0 monthly users, 100.0% runs succeeded, 4 bookmarks - **User rating**: No ratings yet ## Pricing $20.00/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** โ€” the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** โ€” [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** โ€” the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** โ€” the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** โ€” 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 [![Trip.com Hotels Scraper โ€” extract hotel names, prices, guest scores, rooms and photos from Trip.com](https://i.postimg.cc/cLRYsvpW/banner-compressed.jpg)](https://apify.com/bebity/trip-com-hotels-scraper) Extract **hotel names, prices, star ratings, guest review scores, photos, rooms, facilities and nearby landmarks** from [trip.com](https://www.trip.com/) โ€” no login, no scraping code to write. Paste a Trip.com search URL, or just type a city name and let the scraper build the search for you. Results arrive as clean JSON, one row per hotel, downloadable as **JSON, CSV, Excel, HTML or XML**. *** ### ๐Ÿค” What does Trip.com Hotels Scraper do? This actor turns any [Trip.com](https://www.trip.com/) hotel search into a structured dataset. You give it **any combination** of Trip.com search-result URLs, hotel detail URLs, bare hotel IDs, or a **destination name plus filters** โ€” and it returns hotel names, star ratings, guest scores, review counts, nightly and total prices, photos, and location data. Turn on **Scrape detail pages** and each hotel gets a second fetch that enriches the row with **room types and rates, facilities, amenities, the full photo gallery, the hotel's own FAQ, and nearby points of interest**. **What makes it different:** - **Deep pagination that actually reaches your limit.** Trip.com's "load more" is gated behind a signed request token, so a destination search drives a stealth browser to collect results, then hands every hotel back to the fast HTTP path. Ask for 100 hotels and you get 100. - **HTTP-fast for small runs.** Below 20 items the browser never starts โ€” a lightweight HTTP client with browser-grade TLS fingerprinting handles the whole run in seconds. Detail pages always use this path, whatever the size. - **No duplicate rows.** Results are de-duplicated by `hotelId` across every source, so overlapping searches never spend your item budget twice on the same hotel. - **Nothing fails silently.** Every timeout, block, unresolved city or parse error becomes a visible `failed: true` row with a machine-readable `reason` โ€” never a crashed run and never a silently short dataset. - **You only pay for what parses.** Failed rows are never billed. *** ### ๐Ÿ“ฆ What data can you extract from Trip.com? | Data point | Example | Available in | | --- | --- | --- | | Hotel name + Trip.com hotel ID | `Radisson Collection Hyland Shanghai` ยท `375477` | Both modes | | Star rating | `5` | Both modes | | Guest score, label and review count | `8.7` ยท `Excellent` ยท `1842 reviews` | Both modes | | Nightly price + total stay price + currency | `179` / `537` `USD` | Both modes | | Primary listing photo | image URL | Both modes | | City and country | `Shanghai`, `China` | Both modes | | Landmarks and amenity tags on the card | `The Bund (0.6 km)`, `Free WiFi` | Both modes | | Trip.com award label | `Trip.com Choice Award 2025` | Both modes | | Long-form hotel description | full marketing copy | Detail pages | | Structured address | street, region, postal code | Detail pages | | Room types and rates | name, price, breakfast, cancellation policy, occupancy | Detail pages | | Facilities and amenities | `Outdoor pool`, `Spa`, `Air conditioning`, `Minibar` | Detail pages | | Full photo gallery | every gallery image URL | Detail pages | | Nearby points of interest | `The Bund โ€” 0.6 km`, `Metro โ€” 0.2 km` | Detail pages | | Hotel FAQ | question / answer pairs | Detail pages | Every row uses the **same shape** in both modes โ€” fields that need a detail page are simply absent in lite mode. Your downstream code never has to branch on which mode produced the row. *** ### ๐Ÿ‘ค Who is this Trip.com scraper for? - **Travel aggregators** comparing Trip.com inventory against Booking.com, Agoda or Expedia to find gaps and pricing discrepancies. - **Hotel rate analysts** who need a scheduled snapshot of prices, scores and availability for a destination. - **Revenue managers** benchmarking their property against local competitors on price and guest score. - **ML and data engineers** building structured hotel-attribute datasets from real listings. - **Lead-gen teams selling to hospitality** discovering properties newly added to a city. - **Travel content publishers** who need descriptions, photos and FAQ copy to seed review pages or a CMS. *** ### ๐Ÿš€ How to scrape Trip.com hotels 1. Open **[Trip.com Hotels Scraper](https://apify.com/bebity/trip-com-hotels-scraper)** on Apify Store and click **Try for free**. 2. Either type a city into **Destination** (for example `Shanghai`), or switch to **Search by URL** and paste a Trip.com search URL straight from your browser. 3. Optionally set your dates, guests and filters โ€” or leave everything at its default. 4. Set **Max items** low (say `10`) for your first run to confirm the results look right. 5. Click **Save & Start**. 6. When the run finishes, open the **Dataset** tab and export as JSON, CSV, Excel, HTML or XML โ€” or pull it straight from the [Apify API](https://docs.apify.com/api/v2). Minimal input to get 10 hotels in Shanghai: ```json { "searchMode": "byUrls", "urls": ["https://us.trip.com/hotels/shanghai-hotels-list-2/"], "scrapeDetails": false, "maxItems": 10 } ``` Expected output: 10 hotel rows in roughly 5 seconds, each with `hotelId`, `name`, `stars`, `score`, `priceMain` and `detailUrl`. *** ### ๐Ÿ“ฅ Example input A filter-based search โ€” 4- and 5-star hotels in Bangkok for 2 adults, 3 nights, cheapest first: ```json { "searchMode": "byFilters", "destination": "Bangkok", "checkIn": "2026-09-15", "checkOut": "2026-09-18", "adults": 2, "rooms": 1, "sortBy": "priceAsc", "stars": [4, 5], "scrapeDetails": false, "maxItems": 30, "currency": "USD", "locale": "en-US" } ``` *** ### ๐Ÿ“ค Example output **Successful lite row** (search results only, `scrapeDetails: false`): ```json { "hotelId": 375477, "name": "Radisson Collection Hyland Shanghai", "detailUrl": "https://us.trip.com/hotels/shanghai-hotel-detail-375477/radisson-collection-hyland-shanghai/", "city": "Shanghai", "country": "China", "stars": 5, "score": 8.7, "scoreLabel": "Excellent", "reviewCount": 1842, "primaryPhotoUrl": "https://ak-d.tripcdn.com/images/hotel/375477/exterior.jpg", "priceMain": "179", "priceTotal": "537", "currency": "USD", "landmarks": ["The Bund (0.6 km)", "Nanjing Road (0.4 km)"], "tags": ["Free WiFi", "Pool", "Breakfast available"], "scrapedAt": "2026-05-03T05:00:00.000Z" } ``` **Successful rich row** (`scrapeDetails: true`, selected fields shown): ```json { "hotelId": 375477, "name": "Radisson Collection Hyland Shanghai", "detailUrl": "https://us.trip.com/hotels/shanghai-hotel-detail-375477/radisson-collection-hyland-shanghai/", "city": "Shanghai", "country": "China", "stars": 5, "score": 8.7, "description": "A landmark 5-star hotel on Nanjing Road East, steps from The Bund...", "fullAddress": { "street": "No. 505 Jiujiang Road, Huangpu District, Shanghai, 200001, China", "region": "Shanghai", "postalCode": "200001" }, "priceRange": "$$$", "rooms": [ { "name": "Business Twin Suite", "occupancy": 2, "photoUrl": "https://aw-d.tripcdn.com/images/1mc3b12000bmezgn2BA83.jpg" } ], "facilities": ["Outdoor pool", "Fitness centre", "Spa", "Business centre"], "amenities": [{ "category": "Room", "items": ["Air conditioning", "Minibar", "Safe"] }], "photos": [ "https://ak-d.tripcdn.com/images/hotel/375477/photo1.jpg", "https://ak-d.tripcdn.com/images/hotel/375477/photo2.jpg" ], "surroundings": [ { "type": "Landmark", "name": "The Bund", "distance": "0.6 km" }, { "type": "Metro", "name": "Nanjing Road East Station", "distance": "0.2 km" } ], "faq": [ { "question": "Is there parking at Radisson Collection Hyland Shanghai?", "answer": "Yes, the hotel offers valet parking at CNY 120 per day." } ], "scrapedAt": "2026-05-03T05:00:00.000Z" } ``` **Failed row** (destination could not be resolved): ```json { "failed": true, "reason": "destination-unresolved", "inputUrl": "destination:Springfield", "error": "Autocomplete returned 0 candidates for 'Springfield' โ€” too ambiguous.", "scrapedAt": "2026-05-03T05:00:00.000Z" } ``` *** ### โš™๏ธ Input parameters Every field below is also documented in the **Input** tab, with tooltips. Click any `?` icon there for format details and examples. #### Top-level (always relevant) | Field | Type | Default | Description | | --------------- | ----------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `searchMode` | `"byFilters" \| "byUrls"` | `"byFilters"` | Choose how the actor finds hotels. **`byFilters`** โ€” pick a destination + filters and the actor builds the Trip.com search URL for you. **`byUrls`** โ€” paste Trip.com URLs you've already crafted in your browser. | | `urls` | `string[]` | `[]` | **Used only when `searchMode = byUrls`.** Any combination of: SEO landing URLs (`us.trip.com/hotels/{slug}-hotels-list-{cityId}/`), interactive SERPs with filters (`www.trip.com/hotels/list?cityId=N&...&listFilters=...`), hotel detail URLs, or bare hotel IDs. | | `scrapeDetails` | `boolean` | `false` | Fetch each hotel's detail page and enrich the row with rooms, facilities, amenities, photos, FAQ, surroundings. Also unlocks deep pagination โ€” see the **Limitations** section. **About 10ร— more expensive** than lite mode. | | `maxItems` | `integer` | `100` | Stop after this many hotels are scraped. Set low (e.g. `5`) for a first test run. | #### ๐ŸŽฏ Where & when (used when `searchMode = byFilters`) | Field | Type | Default | Description | | -------------- | ----------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `destination` | `string` | โ€” | City name (`Paris`), numeric Trip.com city ID (`192`), or a Trip.com SERP URL. Ambiguous names produce a `destination-unresolved` failed row. | | `checkIn` | `string` | โ€” | Check-in date (`YYYY-MM-DD`). Must be today or later. | | `checkOut` | `string` | โ€” | Check-out date (`YYYY-MM-DD`). Must be at least 1 day after `checkIn`. | | `adults` | `integer` | `2` | Number of adult guests (1โ€“30). | | `children` | `integer` | `0` | Number of child guests. If > 0, fill `childrenAges` too. | | `childrenAges` | `integer[]` | `[]` | One age per child (0โ€“17). Required when `children > 0`. | | `rooms` | `integer` | `1` | Number of rooms (1โ€“30). | #### ๐Ÿ” Filters (used when `searchMode = byFilters`, applied server-side) | Field | Type | Default | Description | | ------------------ | ------------------------------------------------------------------------------------------ | --------------- | ------------------------------------------------------------------------------------------------------------------------ | | `sortBy` | `"recommended" \| "topReviewed" \| "priceAsc" \| "priceDesc" \| "starsDesc"` | `"recommended"` | Sort order. Maps to Trip.com's "Trip.com recommended", "Top reviewed", "Lowest price (incl. tax)", "Highest price", "Star rating (high to low)". | | `stars` | `integer[]` | `[]` | Multi-select hotel stars (1โ€“5). Empty = no star filter. | | `priceMin` | `integer` | โ€” | Minimum price per room per night (in selected currency, excl. taxes & fees). | | `priceMax` | `integer` | โ€” | Maximum price per room per night (in selected currency, excl. taxes & fees). | | `minScore` | `"6" \| "7" \| "8"` | โ€” | Minimum guest review score, picked from a dropdown. Trip.com exposes 3 thresholds: Pleasant 6+, Good 7+, Very Good 8+. Numbers are accepted too if you call the API directly. | | `propertyType` | `("Hotels" \| "HomesAndApts" \| "Hostels")[]` | `[]` | Property type buckets. `Hotels` includes resorts; `HomesAndApts` includes apartments and villas; `Hostels` includes inns. | | `mealPlan` | `"any" \| "breakfast" \| "dinner" \| "breakfastDinner"` | `"any"` | Meal plan included in the rate. | | `freeCancellation` | `boolean` | `false` | Restrict to properties offering free cancellation. | | `paymentOption` | `"any" \| "prepayOnline" \| "payLater" \| "payAtHotel"` | `"any"` | Restrict to properties offering the chosen payment terms. | #### ๐ŸŒ Localization | Field | Type | Default | Description | | ---------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `currency` | `string` | `USD` | Currency for price fields. One of: `USD`, `EUR`, `GBP`, `JPY`, `AUD`, `CAD`, `NZD`, `CHF`, `CNY`, `HKD`, `SGD`, `THB`, `KRW`, `MYR`, `INR`, `BRL`, `MXN`. | | `locale` | `string` | `en-US` | Locale for content language. One of: `en-US`, `en-GB`, `fr-FR`, `de-DE`, `es-ES`, `it-IT`, `pt-PT`, `ja-JP`, `ko-KR`, `zh-CN`, `zh-HK`, `th-TH`, `vi-VN`. | #### ๐Ÿ”ง Advanced | Field | Type | Default | Description | | -------------------- | -------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `proxyConfiguration` | `object` | Apify Residential (US) | Apify proxy settings. Defaults to residential US proxies, which are required for reliable Trip.com access. Only change this if you have a specific geo requirement โ€” see FAQ below. | *** ### ๐Ÿ“‹ Output schema Every successful row is a `HotelRow`. Every failure is a `FailedRow`. Download either as JSON, CSV, Excel, HTML or XML from the **Dataset** tab, or fetch them through the API. The dataset ships with **two built-in views**: `overview` (successful hotels) and `failed_items` (everything that failed, with its reason). One click switches between them. #### HotelRow fields | Field | Type | Availability | Description | | ----------------- | ----------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------- | | `hotelId` | `number` | Always | Trip.com's numeric hotel identifier. | | `name` | `string` | Always | Hotel display name as shown on Trip.com. | | `detailUrl` | `string` | Always | Canonical Trip.com hotel detail URL (tracking params stripped). | | `city` | `string` | Always | City the hotel is located in. | | `country` | `string` | Always | Country the hotel is located in. | | `scrapedAt` | `string` (ISO 8601) | Always | UTC timestamp of when the row was scraped. | | `stars` | `1\|2\|3\|4\|5` | SERP | Official star rating. | | `score` | `number` | SERP | Guest review score (0โ€“10 scale). | | `scoreLabel` | `string` | SERP | Human label for the score (e.g. `Excellent`, `Good`, `Very good`). | | `reviewCount` | `number` | SERP | Total number of guest reviews. | | `primaryPhotoUrl` | `string` | SERP | URL of the hotel's primary listing photo. | | `priceMain` | `string` | SERP | Per-night price as displayed on the SERP. | | `priceTotal` | `string` | SERP | Total price for the stay duration as displayed on the SERP. | | `currency` | `string` | SERP | Currency code for price fields (e.g. `USD`). | | `landmarks` | `string[]` | SERP | Landmark names and distances shown on the card (e.g. `"The Bund (0.6 km)"`). | | `tags` | `string[]` | SERP | Amenity tags shown on the listing card (e.g. `"Free WiFi"`, `"Pool"`). | | `awardRank` | `string` | SERP | Trip.com award label if present (e.g. `"Trip.com Choice Award 2025"`). | | `description` | `string` | Detail only | Long-form hotel description from the detail page. | | `fullAddress` | `object` | Detail only | Structured address: `{ street?, region?, postalCode? }`. Postal code is omitted when Trip.com has none. | | `aggregateRating` | `object` | Detail only | Structured rating: `{ ratingValue: number, bestRating: number }`. | | `priceRange` | `string` | Detail only | Price tier indicator (e.g. `$$$`). | | `faq` | `{ question, answer }[]` | Detail only | Hotel FAQ items as extracted from the detail page. | | `rooms` | `object[]` | Detail only | Room types offered. Each: `{ name, occupancy?, photoUrl? }`. Nightly rates, breakfast and cancellation terms are **not** included โ€” Trip.com loads those separately, per set of dates. | | `facilities` | `string[]` | Detail only | Hotel-level facilities (e.g. `"Outdoor pool"`, `"Spa"`, `"Fitness centre"`). | | `amenities` | `{ category, items[] }[]` | Detail only | Amenities grouped by category (e.g. `{ category: "Room", items: ["Air conditioning", ...] }`). | | `photos` | `string[]` | Detail only | All hotel photo URLs from the gallery. | | `surroundings` | `{ type, name, distance? }[]` | Detail only | Nearby points of interest: transport, landmarks, restaurants, etc. | #### FailedRow fields | Field | Type | Description | | ----------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | `failed` | `true` | Always `true` โ€” identifies this as a failed row. Filter your dataset by this field to see all errors at a glance. | | `reason` | `string` | Error classification. One of: `parse-error`, `destination-unresolved`, `timeout`, `rate-limited`, `waf-blocked`, `not-found`. | | `inputUrl` | `string` | The URL or identifier that triggered the failure. | | `error` | `string` | Human-readable error summary (โ‰ค200 chars, sanitised โ€” no credentials or tokens). | | `scrapedAt` | `string` (ISO 8601) | UTC timestamp. | **Failure reasons explained:** | Reason | Cause | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------ | | `parse-error` | Trip.com returned a 200 OK but the response had no extractable hotel data (empty SSR shell, layout change). | | `destination-unresolved` | The autocomplete API returned 0 or multiple ambiguous candidates for the city name provided. | | `timeout` | The request exceeded the network timeout. Usually a proxy issue โ€” retry typically succeeds. | | `rate-limited` | HTTP 429 received. The actor will retry automatically; a persistent `rate-limited` row means all retries were exhausted. | | `waf-blocked` | The response matched a WAF/CAPTCHA challenge fingerprint. Rare on residential proxies. | | `not-found` | HTTP 404 โ€” the hotel ID or URL is no longer valid on Trip.com. | *** ### ๐Ÿ’ฐ How much does it cost to scrape Trip.com? This actor uses **pay-per-event (PPE)** pricing. You pay only for pages that successfully parse โ€” **failed rows are never charged**, and neither are internal steps like resolving a city name. | Event | Cost | When billed | | -------------- | ---------- | --------------------------------------------------------------------------------------- | | `serp-page` | **$0.005** | Once per successfully parsed search-results page. | | `hotel-detail` | **$0.01** | Once per successfully parsed hotel detail page. Only billed when `scrapeDetails: true`. | **Worked examples:** | Scenario | Calculation | Total | | ----------------------------------------------------------- | ----------------------------------------------- | ----------- | | First test run โ€” 5 hotels, lite mode | 1 search page ร— $0.005 | **$0.005** | | 10 search URLs pasted, lite mode (~10 hotels each) | 10 search pages ร— $0.005 | **$0.05** | | Filter search, lite mode, `maxItems: 100` | ~3โ€“14 search pages ร— $0.005 | **~$0.02โ€“0.07** | | Filter search, rich mode, 100 hotels | ~10 search pages ร— $0.005 + 100 details ร— $0.01 | **~$1.05** | | Deep run, rich mode, 400 hotels in a large city | ~40 search pages ร— $0.005 + 400 details ร— $0.01 | **~$4.20** | | A destination that can't be resolved | nothing parsed | **$0.00** | Rule of thumb: **$1 buys roughly 100 fully-enriched hotels**, or **thousands of hotels in lite mode**. Lite mode is essentially free at exploratory scale โ€” a full first pass on a city costs a few cents. > **Tip:** always run with `scrapeDetails: false` and a small `maxItems` first, to confirm your destination and filters produce the hotels you expect. Then re-run with details enabled. *** ### ๐ŸŽฏ Search modes The actor offers two search modes, selected by the top-level `searchMode` field: | Mode | When to use | Required field | | ------------ | --------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | | `byFilters` | Describe a destination + optional filters and let the actor build the Trip.com search URL. Best for scheduled monitoring runs. | `destination` | | `byUrls` | Paste Trip.com URLs you already crafted in your browser โ€” search results, hotel details, or hotel IDs. Most deterministic option. | `urls` (โ‰ฅ1) | In **`byFilters` mode**, you pick a city, dates, and any of the 9 supported filters (`sortBy`, `stars`, `priceMin/Max`, `minScore`, `propertyType`, `mealPlan`, `freeCancellation`, `paymentOption`). The actor resolves the city ID, encodes your filters into the Trip.com search URL, and โ€” for larger `maxItems` โ€” automatically fans the search out across Trip.com's geo domains to widen coverage. In **`byUrls` mode**, paste any combination of: - Search-results URLs โ€” `/hotels/{slug}-hotels-list-{cityId}/` or `/hotels/list?cityId=N&...&listFilters=...` - Hotel detail URLs โ€” `/hotels/{slug}-hotel-detail-{hotelId}/` or `/hotels/detail/?hotelId=N&...` - Bare hotel IDs โ€” `375477` (promoted to a detail URL automatically) Power users with niche filter combinations prefer **`byUrls` mode**: open Trip.com, fill in the filter sidebar in your browser, and copy the resulting URL into the `urls` field. Whatever filters Trip.com supports, the actor fetches as-is. *** ### โšก Runs on the Apify platform The scraper is only half of what you get. Because it runs on [Apify](https://apify.com/), you also get: - **Scheduling** โ€” run it nightly or hourly and build a price history without touching a cron server. Save your input as a **Task** and reuse it. - **A full REST API** โ€” start runs and pull datasets from your own code. See the **API** tab on the actor page. - **Integrations** โ€” push results straight to Google Sheets, Slack, Zapier, Make, Airtable, AWS S3 or a webhook. - **Residential proxy rotation** โ€” included and configured. No proxy list to buy or maintain. - **Monitoring and alerts** โ€” get notified when a run fails or returns fewer results than usual. - **Storage and history** โ€” every run's dataset is kept, versioned and exportable. *** ### โš ๏ธ Limitations **How many hotels you get depends on the mode.** Measured on real runs, July 2026: | Setup | Typical yield | | ------------------------------------------------------------ | ------------------------------------------------- | | **`byFilters`** (destination + filters), `maxItems` above 20 | **Your `maxItems`** โ€” 100 requested โ†’ 100 returned | | `byFilters` with `maxItems` of 20 or less | ~19 hotels, collected over HTTP in a few seconds | | **`byUrls`**, one search URL, lite mode | ~9โ€“12 hotels (the page's own cards) | | **`byUrls`**, one search URL, rich mode (`scrapeDetails`) | ~70 unique hotels for a large city | **Why `byFilters` goes deeper.** Trip.com's infinite scroll is gated behind a signed request token, so above the 20-item threshold a destination search drives a stealth browser to collect the full result set. Below it, the browser would cost more time than the extra hotels are worth, so the run stays on the HTTP path โ€” which tops out at one search page plus the SEO landings, about 19 unique hotels. A run that cannot reach your `maxItems` says so in the log rather than leaving you to count rows. **`byUrls` never starts the browser.** Pasted URLs are fetched over HTTP. In rich mode the actor still expands coverage by following the extra hotel IDs each landing page references and walking district pages breadth-first โ€” that is where the ~70 comes from. **No guest reviews.** Review text is not extracted. A separate reviews actor is planned โ€” see **Other scrapers by Bebity** below. **No per-date price calendar.** The actor captures the price shown for the dates you specify. Sweeping a 60-day price curve isn't supported; schedule daily runs instead to build the history yourself. **Locale is applied via URL parameters and headers, not geo domains.** Currency and locale are set with `?curr=` and `?locale=` plus an `Accept-Language` header. Content reflects the locale you set rather than your IP's local edition. **Prices are indicative.** Trip.com search-page prices can differ from final checkout prices because of taxes, fees and live availability. Verify on Trip.com before acting on them. *** ### ๐Ÿ’ก Tips **Enable `scrapeDetails` when you want volume, not just depth.** It's the switch that turns on deep pagination โ€” the difference between ~10 hotels and several hundred. **Validate before enriching.** Run with `scrapeDetails: false` and `maxItems: 10`. Confirm the hotels match your destination and filters, then re-run with details enabled and your real `maxItems`. This avoids paying for detail pages on a misconfigured run. **Paste several URLs to widen a lite-mode search.** Apply different filter combinations in your browser (star rating, price band, district) and drop each resulting URL into `urls`. The actor de-duplicates by `hotelId`, so overlapping searches never produce duplicate rows. **Use Tasks for repeatable monitoring.** Save your input as a named Task in Apify Console, then schedule it. Nightly price snapshots with no reconfiguration. **Always check the `failed_items` view.** Switch the dataset view after each run to see what failed and why. Most failures are transient (timeouts, empty SSR shells) and clear on a re-run. **Target a country with proxies.** For region-specific pricing or language defaults, pass `proxyConfiguration: { "useApifyProxy": true, "groups": ["RESIDENTIAL"], "countryCode": "JP" }` and pair it with `locale: "ja-JP"` and `currency: "JPY"`. **Bare hotel IDs make great watchlists.** Once you've identified a shortlist of properties, paste their numeric `hotelId` values straight into `urls`. Bare integers are treated as detail-page requests and return rich data even with `scrapeDetails: false`. *** ### โš–๏ธ Is it legal to scrape Trip.com? Scraping publicly available data is legal in many jurisdictions, and this actor only collects what Trip.com shows to any anonymous visitor: hotel names, prices, ratings, photos and descriptions. It does **not** extract private user data, guest names, contact details or anything behind a login. That said, your results may still contain data that is regulated โ€” and how you use them is your responsibility. Personal data is protected by the GDPR in the European Union and by comparable laws elsewhere. You should not scrape or store personal data without a legitimate reason, and you remain responsible for complying with Trip.com's terms of service, applicable law, and your own data governance policies. If you're unsure whether your use case qualifies, consult your lawyers. Apify's [blog post on the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/) is a good starting point. *** ### ๐Ÿงฐ Other scrapers by Bebity Browse everything we publish on the **[Bebity profile](https://apify.com/bebity)**. | Actor | What it does | Status | | --- | --- | --- | | **Trip.com Hotels Scraper** | This actor โ€” hotel listings, prices, rooms, facilities and photos. | Available | | **Trip.com Reviews Scraper** | Guest review text, ratings and reviewer metadata per hotel. | Planned โ€” [tell us if you need it](https://apify.com/bebity/trip-com-hotels-scraper/issues) | Need a different travel site, or a customised version of this one? Open an issue on the actor's **Issues** tab and describe what you're after. *** ### โ“ FAQ **How many hotels can I get from one Trip.com search?** With **`byFilters`** (a destination plus filters) and `maxItems` above 20, you get your `maxItems` โ€” a 100-hotel request returns 100. Below that threshold the run stays on the fast HTTP path and tops out near 19. Pasting a single search URL in **`byUrls`** mode gives ~9โ€“12 hotels in lite mode, or ~70 for a large city in rich mode. The **Limitations** section has the full breakdown and explains why the modes differ. **How do I filter by district, hotel chain, or proximity to a landmark?** These aren't exposed in `byFilters` mode because Trip.com encodes them as city-specific tag IDs that change between destinations and deploys. Use `byUrls` mode instead: open Trip.com, apply the district / chain / landmark filter in the sidebar, copy the resulting URL (it looks like `/hotels/list?cityId=...&listFilters=...`), and paste it into `urls`. The actor fetches it as-is and Trip.com applies the filters server-side. **Can I scrape multiple cities in one run?** Yes โ€” put one search URL per city in the `urls` array. Each row carries its own `city` and `country`, so you can split them downstream. For large jobs, one scheduled Task per city keeps the datasets separate and easier to monitor. **When will guest reviews be available?** Reviews are planned as a separate actor. No date is locked โ€” it's driven by demand, so open an issue if you need it and we'll prioritise accordingly. **Why does my run show `failed: true` rows?** By design: the actor never swallows an error. Every failure becomes a visible row with a `reason` instead of crashing the run or silently shortening your dataset. The common ones: - `destination-unresolved` โ€” the city name was ambiguous (for example "Springfield"). Use a more specific name or a numeric city ID. - `parse-error` โ€” Trip.com returned an empty page shell. Usually transient; retry. - `timeout` โ€” a slow proxy connection. Retry usually clears it. **Can I target a specific country's Trip.com version?** Pass a `countryCode` in `proxyConfiguration` to route through a residential IP in that country โ€” for example `{ "useApifyProxy": true, "groups": ["RESIDENTIAL"], "countryCode": "AU" }` for Australian IPs. Combine with the matching `locale` and `currency`. **What currencies are supported?** USD, EUR, GBP, JPY, AUD, CAD, NZD, CHF, CNY, HKD, SGD, THB, KRW, MYR, INR, BRL and MXN. Set `currency` in the Localization section. **Does Trip.com have an official API?** Trip.com offers partner APIs, but they require a commercial agreement and are not open to the public. This actor is a practical stand-in for reading publicly displayed hotel data at scale, with no onboarding and no contract. **How often does Trip.com change its layout?** Trip.com runs Next.js with React Server Components streaming. The actor anchors extraction on stable backend tracking attributes rather than CSS class names, so cosmetic redeploys don't break it. A significant redesign still can โ€” if you see a spike in `parse-error` rows, check the changelog and the Issues tab. We push fixes promptly. **Can I get the data into Google Sheets / a database / my app?** Yes. Export from the Dataset tab (JSON, CSV, Excel, HTML, XML), pull it via the [Apify API](https://docs.apify.com/api/v2), or wire up an integration โ€” Google Sheets, Slack, Zapier, Make, Airtable, S3 and generic webhooks are all supported from the actor's **Integrations** tab. *** ### ๐Ÿ†˜ Support and feedback Found a bug, hit an unexpected `failed` reason, or need a field the actor doesn't extract yet? Open a ticket on the **[Issues tab](https://apify.com/bebity/trip-com-hotels-scraper/issues)** โ€” it's monitored, and it's the fastest way to get a fix or a feature. Feature requests genuinely shape the roadmap: reviews scraping, calendar pricing and deeper pagination are all prioritised by what people ask for. *** ### ๐Ÿ“œ Changelog Current version: **1.1.0**. The full version history lives in **[CHANGELOG.md](./CHANGELOG.md)**, which is also what renders on the **Changelog** tab of this actor's Apify Store page. *** **Built by [Bebity](https://apify.com/bebity).** # Actor input Schema ## `searchMode` (type: `string`): Choose how you want to find hotels. By filters โ€” pick a destination + dates + filters and the actor builds the trip.com search URL for you. By URLs โ€” paste trip.com URLs (search results, hotel details, or hotel IDs) you've already crafted. ## `urls` (type: `array`): Used only when Search mode = By URLs. Paste any combination of:
โ€ข Search-results URLs (/hotels/{slug}-hotels-list-{cityId}/ or /hotels/list?cityId=N\&checkin=โ€ฆ\&listFilters=โ€ฆ) โ€” returns up to 12 hotels each
โ€ข Hotel detail URLs (/hotels/{slug}-hotel-detail-{hotelId}/ or /hotels/detail/?hotelId=N&โ€ฆ)
โ€ข Bare hotel IDs (375477) โ€” promoted to a detail URL automatically ## `scrapeDetails` (type: `boolean`): If on, the actor fetches each hotel's detail page (rooms, facilities, amenities, photos, FAQ, surroundings). About 10ร— more expensive than the lite mode. Defaults off so first runs are cheap and fast. ## `maxItems` (type: `integer`): Stop after this many hotels are scraped. Set to a low value (e.g. 10) for the first test run, then ramp up. ## `destination` (type: `string`): Used only when Search mode = By filters. City to search. Accepts a city name (Paris, Bangkok), a numeric trip.com city ID (192 for Paris), or a trip.com SERP URL we'll parse the cityId from. Ambiguous names produce a failed row with reason: 'destination-unresolved'. ## `checkIn` (type: `string`): Check-in date. Format YYYY-MM-DD. Must be today or later. ## `checkOut` (type: `string`): Check-out date. Format YYYY-MM-DD. Must be at least 1 day after check-in. ## `adults` (type: `integer`): Number of adult guests (1โ€“30). ## `children` (type: `integer`): Number of child guests (0โ€“10). When greater than 0, fill childrenAges with one age per child. ## `childrenAges` (type: `array`): Required when children > 0. One integer per child, each 0โ€“17. ## `rooms` (type: `integer`): Number of rooms requested (1โ€“30). Maps to trip.com's crn URL parameter. ## `sortBy` (type: `string`): Sort the search results. ## `stars` (type: `array`): Multi-select hotel stars (1โ€“5). Empty = no star filter. ## `priceMin` (type: `integer`): Minimum price per room per night, excluding taxes & fees, in the selected currency. ## `priceMax` (type: `integer`): Maximum price per room per night, excluding taxes & fees, in the selected currency. ## `minScore` (type: `string`): Minimum guest review score. Trip.com exposes three thresholds: Pleasant (6+), Good (7+), Very Good (8+). ## `propertyType` (type: `array`): Multi-select property type buckets. Empty = no property-type filter. Trip.com's UI groups specific sub-types into these three user-facing buckets. ## `mealPlan` (type: `string`): Meal plan included in the rate. ## `freeCancellation` (type: `boolean`): Restrict to properties offering free cancellation. ## `paymentOption` (type: `string`): Restrict to properties offering the chosen payment terms. ## `currency` (type: `string`): Currency for price fields. ## `locale` (type: `string`): Site locale for content language. ## `proxyConfiguration` (type: `object`): Apify proxy. Defaults to residential. Override only if you know why. ## Actor input object example ```json { "searchMode": "byFilters", "urls": [ "https://us.trip.com/hotels/paris-hotels-list-192/", "https://www.trip.com/hotels/list?cityId=192&checkin=2026-05-15&checkout=2026-05-16&adult=2&crn=1&curr=USD&locale=en-US", "https://us.trip.com/hotels/paris-hotel-detail-717490/", "375477" ], "scrapeDetails": false, "maxItems": 100, "destination": "Paris", "adults": 2, "children": 0, "childrenAges": [], "rooms": 1, "sortBy": "recommended", "stars": [], "propertyType": [], "mealPlan": "any", "freeCancellation": false, "paymentOption": "any", "currency": "USD", "locale": "en-US", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `hotels` (type: `string`): Scraped hotels, one row per hotel. Always includes hotelId, name, detailUrl, city, country and scrapedAt; search-result fields (stars, score, scoreLabel, reviewCount, priceMain, priceTotal, currency, primaryPhotoUrl) are present for hotels found through a search page; detail-page fields (description, rooms, facilities, amenities, photos, surroundings, faq, fullAddress) are present when scrapeDetails is enabled. ## `failedItems` (type: `string`): Rows where scraping did not succeed, each with failed=true and a reason of parse-error, destination-unresolved, timeout, rate-limited, waf-blocked or not-found, plus the inputUrl that triggered it and a sanitised error message. Empty on a fully successful run. Failed items are never charged. # 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 = { "urls": [ "https://us.trip.com/hotels/paris-hotels-list-192/", "https://www.trip.com/hotels/list?cityId=192&checkin=2026-05-15&checkout=2026-05-16&adult=2&crn=1&curr=USD&locale=en-US", "https://us.trip.com/hotels/paris-hotel-detail-717490/", "375477" ], "maxItems": 100, "destination": "Paris" }; // Run the Actor and wait for it to finish const run = await client.actor("bebity/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 = { "urls": [ "https://us.trip.com/hotels/paris-hotels-list-192/", "https://www.trip.com/hotels/list?cityId=192&checkin=2026-05-15&checkout=2026-05-16&adult=2&crn=1&curr=USD&locale=en-US", "https://us.trip.com/hotels/paris-hotel-detail-717490/", "375477", ], "maxItems": 100, "destination": "Paris", } # Run the Actor and wait for it to finish run = client.actor("bebity/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 '{ "urls": [ "https://us.trip.com/hotels/paris-hotels-list-192/", "https://www.trip.com/hotels/list?cityId=192&checkin=2026-05-15&checkout=2026-05-16&adult=2&crn=1&curr=USD&locale=en-US", "https://us.trip.com/hotels/paris-hotel-detail-717490/", "375477" ], "maxItems": 100, "destination": "Paris" }' | apify call bebity/trip-com-hotels-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bebity/trip-com-hotels-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/1v2a4yJSX9mvqyopM/builds/OX5zGkSilNsj1wRkE/openapi.json