# Trip.com Hotels Scraper: Prices, Ratings and Reviews by Date (`themineworks/trip-com-hotels-scraper`) Actor

Trip.com hotels for any city and dates: price per night and total with taxes, star rating, guest rating, review count, room, free cancellation and location. Optional hotel pages add address, facilities, check in times and the 10 latest reviews. No login.

- **URL**: https://apify.com/themineworks/trip-com-hotels-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Travel, E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.89 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Trip.com Hotels Scraper: Prices, Ratings and Reviews by Date

[![Trip.com hotels for any city and dates, with the live price per night and the total for the stay](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/trip-com-hotels-scraper-hero.png)](https://console.apify.com/actors/dR8itWSgoRXkHY9bi/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns Trip.com hotels for any city and dates, one row per hotel with the live price per night and the total for the stay with taxes and fees, star rating, guest rating with sub ratings, review count, the cheapest room, free cancellation, district and coordinates. Turn on hotel pages for the full address, facilities, check in and check out times, room types and the 10 latest guest reviews. No login, no cookies, no API key. You pay $2.70 per 1,000 hotels on the Free plan and $1.89 per 1,000 on the Gold plan, plus a $0.003 start fee per run, and hotel pages cost nothing extra.

**Part of The Mine Works Food and local services family:** [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

Updated 12 Nov 2026: first release. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **Prices for your dates, not a list of names.** Every row carries the check in and check out you asked for, `price_per_night`, `total_price` for the whole stay, `taxes_and_fees`, the struck through price and the discount tags, in the currency you pick.
- **More than one screen of hotels.** Trip.com shows about 10 hotels per list view and loads the rest through a call it signs in its own script. This actor walks the city by price instead: each request starts where the last one ended, per star level, so a run keeps finding new hotels until it reaches your limit. In our Apify tests it returned 300 Bangkok hotels in 3 minutes and 100 Paris 4 and 5 star hotels in 95 seconds.
- **Type a city.** "Lisbon", "Tokyo" or "Bangkok" is looked up through Trip.com's own search box, so you do not need to find a city id first. Ids and pasted Trip.com links work too.
- **Hotel pages at the same price.** With `includeDetails` on, each hotel's page adds the address, opening year, facilities marked Free or Additional charge, check in and check out times, front desk hours, room types, nearby places, the share of guests who recommend it and the 10 latest reviews.
- **Cheap to run and to schedule.** Plain HTTP, no browser, 256 MB. A city with nothing bookable for your dates ends after one request and is not charged per hotel.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/dR8itWSgoRXkHY9bi/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### How it compares

| | This actor | bebity/trip-com-hotels-scraper | datawebot/trip-hotel-scraper | shahidirfan/Trip-com-Hotels-Scraper |
|---|---|---|---|---|
| Price per 1,000 hotels, Free plan | $2.70 | Free (platform usage only) | $4.50 | $1.00 |
| Price per 1,000 hotels, Gold plan | $1.89 | Free (platform usage only) | $4.50 | $0.80 |
| Start fee per run | $0.003 | none | $0.00005 | $0.0005 |
| Input | City name, city id, list or hotel links | City name or links | Hotel page links | Search link |
| Live price for your dates | Yes, per night and total with taxes | Yes | Yes, per room | Yes |
| Hotel details (address, facilities, times) | Yes, same price | Yes | Room attributes | Address label |
| Latest reviews | 10 per hotel | Not listed | Not listed | Featured sentence |
| Browser | No | Above 20 hotels | Yes | Not listed |

Checked 12 Nov 2026 from the public Store listings.

### Try it in one minute

Paste this into the JSON tab of the input page and press Start. It returns 30 Lisbon hotels for a 2 night stay 30 days from today. Our test run finished in 8 seconds.

```json
{
  "locations": ["Lisbon"],
  "maxItems": 30
}
```

Apify's free plan includes $5 of credit every month, which covers about 1,800 hotels at this actor's price.

#### Copy to your AI assistant

```text
themineworks/trip-com-hotels-scraper on Apify. Returns Trip.com hotels with live prices for a city and dates, no login. Input: locations (array of city names or Trip.com city ids), checkIn and checkOut (YYYY-MM-DD; default 30 days from today for 2 nights), adults (default 2), rooms (default 1), currency (default USD), sortBy (recommended, price_low or price_high), maxItems (per city, default 50, up to 3000), starRatings (array of "1" to "5"), minPrice, maxPrice (per night), includeDetails (default false), startUrls (Trip.com hotel list or hotel links). Output, one row per hotel: hotel_id, name, category, star_rating, rating, rating_text, review_count, sub_ratings, price_per_night, price_before_discount, total_price, taxes_and_fees, currency, price_note, room_name, bed, free_cancellation, pay_at_hotel, discount_tags, available, is_ad, city, district, location, latitude, longitude, image_url, hotel_url, check_in, check_out, nights, adults, rooms, position; with includeDetails also address, country, opening_year, facilities, check_in_time, check_out_time, room_types, recommend_percent, latest_reviews. Rows with _type are summary, info or error rows and are never charged. Run: POST https://api.apify.com/v2/acts/themineworks~trip-com-hotels-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN with the input as JSON.
```

### Key features

- **Three orders.** `recommended` is Trip.com's own first screen, then one screen per star level, then the rest by price. `price_low` and `price_high` walk the whole city by price, which is the order to use for a full export or for the cheapest and most expensive hotels.
- **Filters that Trip.com applies.** Star levels, a minimum and a maximum price per night, adults and rooms are sent to Trip.com, so rows match what a guest sees with the same filters.
- **Any currency.** `currency` takes a three letter code (USD, EUR, GBP, INR, SGD, JPY, AUD and more); Trip.com converts the prices.
- **Several cities per run.** Up to 50 cities, each with its own `maxItems`. A hotel found twice in one run is delivered and charged once.
- **Hotel links.** A pasted hotel link returns that hotel's page details (address, facilities, times, reviews). Live prices come from a city search, so add the city as well when you need prices.
- **Stops cleanly.** Blocked pages are retried on a new IP, 6 failures in a row end the run, and the run stops before its time limit and keeps every row.

### How to use it

#### Track hotel prices for a date

```json
{
  "locations": ["Bangkok"],
  "checkIn": "2026-12-20",
  "checkOut": "2026-12-23",
  "sortBy": "price_low",
  "maxItems": 300,
  "currency": "EUR"
}
```

Save it as a task and schedule it daily. Each row carries `check_in`, `check_out` and `scraped_at`, so the dataset becomes a price history for the stay.

#### Compare 4 and 5 star hotels in a price band

```json
{
  "locations": ["Paris"],
  "checkIn": "2027-01-15",
  "checkOut": "2027-01-17",
  "starRatings": ["5", "4"],
  "minPrice": 150,
  "maxPrice": 400,
  "currency": "EUR",
  "maxItems": 100
}
```

#### Hotel facts and the latest reviews

```json
{
  "locations": ["Tokyo"],
  "maxItems": 40,
  "includeDetails": true,
  "currency": "JPY"
}
```

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `locations` | array of strings | required unless `startUrls` is set | City names or Trip.com city ids, up to 50 per run. |
| `checkIn` | string | 30 days from today | First night, YYYY-MM-DD. |
| `checkOut` | string | check in plus 2 nights | Departure day, at most 28 nights after check in. |
| `adults` | integer | `2` | Adults per booking. |
| `rooms` | integer | `1` | Rooms per booking. |
| `currency` | string | `USD` | Currency of the prices. |
| `sortBy` | string | `recommended` | `recommended`, `price_low` or `price_high`. |
| `maxItems` | integer | `50` | Most hotels per city, up to 3,000. |
| `starRatings` | array | all | Star levels to keep, "1" to "5". |
| `minPrice`, `maxPrice` | integer | none | Price per night range, in `currency`. |
| `includeDetails` | boolean | `false` | Open each hotel's page for address, facilities, times, room types and the latest reviews. |
| `startUrls` | array | empty | Trip.com hotel list links (searched like a city) or hotel links (page details only). |

### What data do you get?

One row per hotel.

| Field | What it holds |
|---|---|
| `hotel_id`, `master_hotel_id`, `name`, `name_en` | Trip.com ids and the hotel name. |
| `category`, `hotel_type`, `star_rating` | Property type (Hotel, Resort, Hostel, Apartment) and star level. |
| `rating`, `rating_max`, `rating_text`, `review_count`, `sub_ratings`, `review_highlight` | Guest rating out of 10, label, number of reviews, cleanliness, amenities, location and service scores, and one line from reviews. |
| `price_per_night`, `price_before_discount` | Price per night as Trip.com shows it for your dates and guests, and the struck through price. |
| `total_price`, `room_subtotal`, `taxes_and_fees`, `discount_total`, `currency`, `price_note`, `taxes_included` | What the whole stay costs and how it adds up, as shown in Trip.com's price breakdown. |
| `room_name`, `bed`, `free_cancellation`, `pay_at_hotel` | The cheapest bookable room and its terms. |
| `room_tags`, `promotion_tags`, `discount_tags`, `demand_tags` | Tags on the rate, for example "Early Bird Deal", "25% off", "Only 1 left at this price". |
| `available`, `is_ad` | Bookable for the dates, and sponsored listing. |
| `city`, `city_id`, `district`, `location`, `latitude`, `longitude` | Where it is. |
| `image_url`, `images` | Photos from the list card. |
| `hotel_url`, `check_in`, `check_out`, `nights`, `adults`, `rooms` | The hotel page for the same stay, and the stay searched. |
| `search_location`, `search_city_id`, `sort_by`, `position`, `scraped_at` | Which search found it, its place in that search, and when. |

With `includeDetails` on, rows also carry `address`, `province`, `country`, `opening_year`, `hotel_group`, `airport_transfer`, `nearby`, `highlights`, `facilities`, `facility_groups`, `check_in_time`, `check_out_time`, `front_desk_hours`, `recommend_percent`, `review_tags`, `room_types` and `latest_reviews` (date, stay month, rating, text, language, traveler type, room, reviewer, reviewer country, photo count and the hotel's reply), plus `details_scraped`.

Other row types carry `_type`: `summary` (one per run), `info` and `error` (for example a city Trip.com does not know). They are never charged. Filter on `_type` being empty for hotel rows.

#### Stable fields for automations

Present in every hotel row from a city search: `hotel_id`, `name`, `price_per_night`, `currency`, `hotel_url`, `check_in`, `check_out`, `city`, `position`, `scraped_at`. Empty fields are left out of a row rather than sent as null, so check for a field before you read it.

#### Output example

```json
{
  "hotel_id": "54563964",
  "name": "Kenran Resort Ubud by Soscomma",
  "category": "Resort",
  "star_rating": 5,
  "rating": 8.8,
  "rating_text": "Very good",
  "review_count": 414,
  "sub_ratings": { "cleanliness": 9, "amenities": 8.7, "location": 8.5, "service": 8.8 },
  "price_per_night": 79,
  "price_before_discount": 109,
  "total_price": 174.36,
  "taxes_and_fees": 31.44,
  "currency": "USD",
  "price_note": "Total price: $174 1 room × 2 nights incl. taxes & fees",
  "room_name": "Kenran Double Suite",
  "bed": "1 queen bed",
  "free_cancellation": true,
  "discount_tags": ["25% off"],
  "city": "Bali",
  "district": "Ubud",
  "latitude": -8.473657,
  "longitude": 115.285999,
  "hotel_url": "https://www.trip.com/hotels/detail/?hotelId=54563964&checkIn=2026-12-12&checkOut=2026-12-14&adult=2&crn=1&curr=USD&locale=en-US",
  "check_in": "2026-12-12",
  "check_out": "2026-12-14",
  "nights": 2,
  "position": 1
}
```

### Pricing

Pay per event: $2.70 per 1,000 hotels on the Free plan, $2.43 on Bronze, $2.16 on Silver and $1.89 on Gold, plus $0.003 once per run, charged only after the first hotels were found. Hotel pages, error rows, info rows, the summary row and duplicates are free. Set a maximum cost per run in Apify and the actor stops below it.

### FAQ

#### Is it legal to scrape Trip.com?

The actor reads only pages any visitor can open without logging in: hotel lists, hotel pages and the reviews shown on them. Reviews carry the display names Trip.com publishes next to them. You are responsible for using the data in line with the law where you are and Trip.com's terms; ask a lawyer about your own case.

#### Do I need an account, cookies or an API key?

No. The actor never logs in and needs no Trip.com key or partner account.

#### Why is a price missing for some hotels?

Trip.com shows a price only when a room is bookable for your dates, guests and rooms. A hotel with nothing bookable has no price, and price ordered searches skip it.

#### Is `price_per_night` with taxes?

It is the nightly price Trip.com shows on the list for your market. `total_price` is the whole stay as shown in Trip.com's price breakdown, and `price_note` says whether it includes taxes and fees. Quote `total_price` when you compare stays.

#### How many hotels can one city return?

As many as Trip.com has bookable for your search, up to `maxItems` (3,000). Each request returns about 10 hotels. In the busiest budget ranges, where dozens of hotels share one price, some hotels at that exact price can be skipped; star level slicing keeps that small.

#### Can I get every review of a hotel?

Not yet. The hotel page shows the 10 latest reviews, and those come with `includeDetails`. Older reviews load through a call Trip.com signs in its own script.

#### How long does a run take?

About 30 hotels in 10 to 20 seconds, 300 in 3 minutes, and 40 with hotel pages in about a minute in our Apify tests.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/trip-com-hotels-scraper

### Integrations

- **Google Sheets**: send each run's rows to a sheet with Apify's Google Sheets integration, using the Hotels or Prices by date view.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "post tomorrow's cheapest 4 star hotels to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).

### More from The Mine Works

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

If this actor saved you time, a short rating on the Store helps other buyers find it.

### Support

Found a city that shows hotels in your browser but not here, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need, email dmineworks@gmail.com.

*Trip.com hotels for any city and dates: live price per night and total with taxes, stars, guest rating, reviews, room, free cancellation and location, with optional hotel pages and the latest reviews, no login.*

# Actor input Schema

## `locations` (type: `array`):

City names as you would type them on Trip.com, or Trip.com city ids, one per line. Examples: Lisbon, Bangkok, Tokyo, 723 (Bali). Each city is one search. Up to 50 per run.

## `checkIn` (type: `string`):

First night, as YYYY-MM-DD, for example 2026-12-20. Leave empty for 30 days from today, which keeps scheduled runs current.

## `checkOut` (type: `string`):

Departure day, as YYYY-MM-DD, after the check-in date, at most 28 nights later. Leave empty for a 2 night stay.

## `adults` (type: `integer`):

Guests per search, 1 to 30. Prices are for this many adults.

## `rooms` (type: `integer`):

Rooms per booking, 1 to 10.

## `currency` (type: `string`):

Three letter code for prices, for example USD, EUR, GBP, INR, SGD, JPY, AUD. Trip.com converts the prices.

## `sortBy` (type: `string`):

Recommended: Trip.com's own first screen, then each star level, then the rest by price. Price low to high and high to low walk the whole city by price, so large exports cover every bookable hotel.

## `maxItems` (type: `integer`):

The most hotels to return for each city, 1 to 3,000. Each list request returns about 10 hotels.

## `starRatings` (type: `array`):

Only hotels with these star levels, for example 4 and 5. Leave empty for all.

## `minPrice` (type: `integer`):

Lowest nightly price, in the chosen currency.

## `maxPrice` (type: `integer`):

Highest nightly price, in the chosen currency.

## `includeDetails` (type: `boolean`):

On: each hotel's own page is opened too, for the full address, opening year, facilities, check in and check out times, front desk hours, room types, nearby places, recommend percent and the 10 latest guest reviews. Off: rows come from the list only, which is faster. Same price either way.

## `startUrls` (type: `array`):

Hotel list links (https://www.trip.com/hotels/list?city=1231 or https://www.trip.com/hotels/lisbon-hotels-list-1231/) are searched like a city with the dates above. Hotel links (https://www.trip.com/hotels/detail/?hotelId=982030) return that hotel's page details; live prices come from a city search.

## Actor input object example

```json
{
  "locations": [
    "Lisbon"
  ],
  "adults": 2,
  "rooms": 1,
  "currency": "USD",
  "sortBy": "recommended",
  "maxItems": 30,
  "includeDetails": false
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        "Lisbon"
    ],
    "maxItems": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "locations": ["Lisbon"],
    "maxItems": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/trip-com-hotels-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    "Lisbon"
  ],
  "maxItems": 30
}' |
apify call themineworks/trip-com-hotels-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/trip-com-hotels-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/dR8itWSgoRXkHY9bi/builds/4LR57UyBq4JQ5nXda/openapi.json
