# Trip Tours Search Scraper (`stealth_mode/trip-tours-search-scraper`) Actor Scrape Trip.com's Things-To-Do search pages to collect structured POI and tour data including names, prices, rankings, coordinates, tags, and 35+ fields per listing — perfect for travel researchers, aggregators, and destination analysts. - **URL**: https://apify.com/stealth\_mode/trip-tours-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, Travel - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results 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 Tours Search Scraper: Extract POI & Tour Listings at Scale --- ### What Is Trip.com Things-To-Do? Trip.com's Things-To-Do section is a curated directory of Points of Interest (POIs), tours, attractions, and activities across major global destinations. Each search result page lists ranked POIs with rich metadata — pricing, reviews, coordinates, images, and more. Collecting this data manually is impractical at scale; the **Trip.com Tours Search Scraper** automates extraction from any search results URL. --- ### Overview This scraper targets Trip.com's tour/activity search listing pages and extracts structured records for every POI returned. It supports pagination via URL parameters and is suited for: - **Travel aggregators** building destination content databases - **Market researchers** analyzing tourism supply by city or district - **Tour operators** benchmarking pricing and rankings - **Data engineers** feeding travel data pipelines --- ### Input Format ```json { "urls": [ "https://www.trip.com/things-to-do/list?pagetype=city&keyword=Shanghai&kwdfrom=recommend&ext-searchpage=2" ], "ignore_url_failures": true, "max_items_per_url": 200 } ```` | Field | Type | Description | |---|---|---| | `urls` | `array` | One or more Trip.com Things-To-Do search listing URLs. Supports bulk entry. Example: filter by city, keyword, or page via URL parameters (`keyword=Tokyo`, `ext-searchpage=3`). | | `ignore_url_failures` | `boolean` | If `true`, the scraper continues running when a URL fails instead of stopping the entire run. Recommended for bulk jobs. Default: `true`. | | `max_items_per_url` | `integer` | Maximum number of POI records collected per URL. Default: `20`. Set up to `200` for comprehensive page coverage. | > **Tip:** To paginate, increment `ext-searchpage` in the URL (e.g., `ext-searchpage=1`, `ext-searchpage=2`). Add each page as a separate URL entry. *** ### Output Format **Sample output** ```json { "address": "Zhongshan East Road, Huangpu District, Shanghai (Close to Huangpu River)", "business_id": 736, "comment_info": { "comment_count": 157349, "comment_score": 4.8 }, "coordinate": { "coordinate_type": "BD09", "latitude": 31.23855, "longitude": 121.499319 }, "cover_image_url": "https://ak-d.tripcdn.com/images/0102p1200082jbvtcD451.jpg", "detail_url": "https://www.trip.com/travel-guide/attraction/shanghai/the-bund-75611?curr=USD&locale=en-XX&poiType=3&scene=ticket", "distance_info": { "location": "China · Shanghai" }, "district_id": 2, "district_name": "Shanghai", "dynamic_cover_image_url": "https://ak-d.tripcdn.com/images/0102p1200082jbvtcD451.jpg", "explain_desc": "Trending now", "explain_type": "popular", "extend_map": [ { "key": "ticketMetricMsg", "value": "{\"showContestSaleStatus\":\"0\",\"tags\":[]}" } ], "f_poi_jump_sight_detail": false, "favorite_info": { "favorite_id": 0, "has_favorited": false, "is_activity_favorite": false }, "has_video": false, "hot_event_info": { "name": "Shanghai strolls inspired by \"No Myth of Love\"" }, "hot_score": "10", "introduction": "Arguably Shanghai's most-famous tourist attraction, the Bund is a waterfront promenade and famous business district in central Shanghai. Historically, the Bund was the city’s main financial and trading center, and was located within the Shanghai International Settlement, an area under nominal British control between 1843 and 1941. The walking areas extend roughly 1.6 km along the west bank of the Huangpu River. Owing to its historic status and zoning restrictions, the Bund contains fantastic examples of classic Shanghai architecture. For this reason, it is a popular spot for photography. No visit to Shanghai would be complete without a visit to the Bund.", "is_advertisement": false, "is_insert_poi": false, "is_jump_activity_detail": false, "is_near_by": false, "is_recommend": false, "name_not_match_locale": false, "open_time_desc": "Open year-round, 24/7", "other_tag_list": null, "poi_e_name": "The Bund", "poi_id": 75611, "poi_name": "The Bund", "poi_subtitle_name": "外滩", "poi_type": 3, "price_info": { "card_count_desc": "View all 40+ products", "market_price": "7.36", "price_type": "4" }, "ranking_info": { "rank_desc": "2026 Global 100 - Best Things to Do", "ranking_category": 2, "recommend_reason": "Take a stroll along The Bund to admire the Renaissance-style buildings." }, "tag_name_list": [ "Historic landmark", "Boat tour", "Night view" ], "timestamp": 1779512509833, "zone_name": "The Bund Area", "from_url": "https://www.trip.com/things-to-do/list?pagetype=city&keyword=Shanghai&kwdfrom=recommend&ext-searchpage=1" } ``` Each record represents one POI or activity listing. Fields are grouped below by category: #### Identity & Location | Field | Meaning | |---|---| | `POI ID` | Unique Trip.com identifier for the point of interest | | `POI Name` | Display name in the user's locale | | `POI English Name` | Standardized English name for the POI | | `POI Subtitle Name` | Secondary label or tagline shown under the main name | | `POI Type` | Category classification (e.g., attraction, tour, museum) | | `Address` | Full address string | | `Coordinate` | Latitude/longitude object for mapping | | `District ID` | Internal ID of the administrative district | | `District Name` | Human-readable district/neighborhood name | | `Zone Name` | Broader zone or area grouping (e.g., "Bund Area") | #### Content & Media | Field | Meaning | |---|---| | `Introduction` | Short descriptive text about the POI | | `Explain Description` | Extended explanation, often used for promotional context | | `Explain Type` | Type/format of the explanation content | | `Cover Image URL` | Static thumbnail image URL | | `Dynamic Cover Image URL` | Animated or dynamic version of the cover image | | `Has Video` | Boolean indicating whether a video is available | | `Open Time Description` | Human-readable opening hours string | #### Pricing & Ranking | Field | Meaning | |---|---| | `Price Info` | Pricing object including starting price, currency, and display format | | `Ranking Info` | Ranking position within the destination or category | | `Hot Score` | Internal Trip.com popularity/hotness score | #### Reviews & Social | Field | Meaning | |---|---| | `Comment Info` | Aggregated review data: count, average score | | `Favorite Info` | Save/favorite count from Trip.com users | | `Hot Event Info` | Active promotions or featured events tied to the POI | #### Tags & Classification | Field | Meaning | |---|---| | `Tag Name List` | Array of descriptive tags (e.g., "Family-friendly", "Outdoor") | | `Other Tag List` | Additional system or editorial tags | | `Distance Info` | Distance from search center point (when location-based) | #### Flags & Metadata | Field | Meaning | |---|---| | `Is Advertisement` | `true` if the listing is a paid placement | | `Is Insert POI` | Whether the POI was injected (not organically ranked) | | `Is Recommend` | Marked as recommended by Trip.com editorial | | `Is Near By` | Whether the POI appears in a "nearby" context | | `Is Jump Activity Detail` | Whether clicking redirects to an activity detail page | | `POI Jump Sight Detail` | Target detail URL when `Is Jump Activity Detail` is true | | `Name Not Match Locale` | Flag when the POI name does not match the requested locale | | `Extend Map` | Extended map/geo metadata object | | `Detail URL` | Full URL to the POI's detail page on Trip.com | | `Timestamp` | Record extraction timestamp | *** ### How to Use 1. **Find search URLs** — Go to `trip.com/things-to-do`, search by city or keyword, then copy the results page URL. 2. **Add pagination** — Adjust `ext-searchpage` to cover multiple pages; add each as a separate entry in `urls`. 3. **Set item limit** — Use `max_items_per_url: 200` for full-page coverage, lower for quick samples. 4. **Enable failure tolerance** — Keep `ignore_url_failures: true` for bulk runs. 5. **Export** — Download results as JSON or CSV for analysis or database ingestion. **Common issues:** - If `POI Name` shows garbled text, ensure your URL targets the correct locale (e.g., `en-xx` in the domain). - Listings with `Is Advertisement: true` should be filtered out for organic ranking analysis. *** ### Use Cases & Business Value - **Destination content databases:** Bulk-collect POI data for city guide apps or travel blogs - **Pricing intelligence:** Track starting prices across tour categories by city - **Ranking analysis:** Monitor how POIs shift in `Ranking Info` and `Hot Score` over time - **Geo-mapping:** Use `Coordinate` and `District Name` fields to power interactive maps *** ### Conclusion The **Trip.com Tours Search Scraper** delivers structured, analysis-ready POI data from one of the world's largest travel platforms. With 35+ fields per record and configurable pagination support, it's a practical tool for anyone building travel datasets or monitoring destination activity markets. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the tours list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://www.trip.com/things-to-do/list?pagetype=city&keyword=Shanghai&kwdfrom=recommend&ext-searchpage=2" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # 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://www.trip.com/things-to-do/list?pagetype=city&keyword=Shanghai&kwdfrom=recommend&ext-searchpage=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/trip-tours-search-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://www.trip.com/things-to-do/list?pagetype=city&keyword=Shanghai&kwdfrom=recommend&ext-searchpage=2"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/trip-tours-search-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://www.trip.com/things-to-do/list?pagetype=city&keyword=Shanghai&kwdfrom=recommend&ext-searchpage=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/trip-tours-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/trip-tours-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Trip Tours Search Scraper", "description": "Scrape Trip.com's Things-To-Do search pages to collect structured POI and tour data including names, prices, rankings, coordinates, tags, and 35+ fields per listing — perfect for travel researchers, aggregators, and destination analysts.", "version": "0.0", "x-build-id": "MuBMXYShho3ZfQsoR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~trip-tours-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-trip-tours-search-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/stealth_mode~trip-tours-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-trip-tours-search-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/stealth_mode~trip-tours-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-trip-tours-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "URLs of the tours list urls to scrape", "type": "array", "description": "Add the URLs of the tours list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "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 } } } } } } } } } } ```