# Smartcustomer Reviews Scraper (`stealth_mode/smartcustomer-reviews-scraper`) Actor Scrape tour product reviews from Smartcustomer.com by domain, keyword, and sort order. Collect 50+ fields per listing including ratings, pricing, tour types, destinations, and operator details — ideal for travel analysts and tour operators. - **URL**: https://apify.com/stealth\_mode/smartcustomer-reviews-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.80 / 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 ## Smartcustomer.com Reviews Scraper: Extract Tour Reviews & Ratings at Scale --- ### What Is Smartcustomer.com? Smartcustomer.com is a review aggregation platform where travelers rate and review tour products from operators worldwide. It hosts detailed product pages covering multi-day tours, cruises, eco tours, private experiences, and more. For travel businesses and researchers, manually extracting this review and product data is impractical at scale — the **Smartcustomer.com Reviews Scraper** automates collection, delivering structured records ready for analysis. --- ### Overview The **Smartcustomer Reviews Scraper** targets tour product listings on Smartcustomer.com, extracting rich metadata alongside review content. It supports filtering by keyword, sorting preference, and starting page — making it flexible for both broad market scans and targeted competitor research. Typical users include: - **Tour operators** benchmarking competitor ratings and pricing - **Travel analysts** studying destination trends and tour demand - **Aggregator developers** building tour comparison tools - **Market researchers** analyzing traveler sentiment at scale --- ### Input Format ```json { "domain": "ssls.com", "keyword": "happy", "sort_by": "helpful-", "page": 1, "max_items_per_url": 200, "ignore_url_failures": true, "urls": [] } ```` | Field | Type | Description | |---|---|---| | `domain` | string | Business domain as it appears in the Smartcustomer URL path (e.g., `reviews/ssls.com` → `ssls.com`) | | `keyword` | string | Filter reviews containing this keyword (e.g., `"happy"`, `"guide"`, `"value"`) | | `sort_by` | string | Sort order for reviews. Options: `""` (Relevant), `"created-desc"` (Newest), `"helpful-"` (Helpful), `"rating-"` (Rating) | | `page` | integer | Page number to start scraping from. Defaults to `1` | | `max_items_per_url` | integer | Maximum records to collect per URL. Defaults to `20`; set higher (e.g., `200`) for bulk runs | | `ignore_url_failures` | boolean | If `true`, skips failed URLs and continues the run instead of halting | | `urls` | array | Optional list of direct product page URLs. Leave empty to rely on `domain` + `keyword` discovery | > **Tip:** To collect the most useful reviews first, use `sort_by: "helpful-"`. For fresh data, use `"created-desc"`. *** ### Output Format **Sample output** ```json { "id": 26910471, "review_no": 83093, "title": "Smooth Experience – Worth the Wait", "tip": null, "content": "I purchased an SSL certificate from SSLS.com, and the overall process was smooth and easy to follow. Although it took a bit longer than I expected to issue the certificate, everything worked out well in the end. The platform is user-friendly and the pricing is great. Given the quality and reliability, I'm happy to forgive the delay. I'd recommend SSLS.com to others looking for affordable SSL solutions.", "rating": 5, "published": "2025-05-30T14:18:36+00:00", "pending": false, "activated": "2025-05-30T07:18:36+00:00", "ratings": { "service": { "value": null, "reason": null }, "value": { "value": null, "reason": null }, "shipping": { "value": null, "reason": null }, "returns": { "value": null, "reason": null }, "quality": { "value": null, "reason": null } }, "verification": { "label": "Solicited", "title": "The business invited this reviewer to submit feedback" }, "num_positive_votes": 0, "num_negative_votes": 0, "num_comments": 0, "num_views": 1, "author": { "id": 24157298, "first_name": "TEMUR", "last_name": "EGAMBERDIYEV", "username": "temure", "num_reviews": 1, "num_positive_votes": 0, "avatar_url": "https://www.smartcustomer.com/img/user-avatar-default%402x.1765813271.webp", "is_removed": false, "identity_verified": false }, "updated_review": { "id": null }, "photos": [], "videos": [], "thank_you": null, "helpful": null, "products_used": [], "business_comment": null, "is_updatable": true, "order_id": null, "attributes": [], "location": { "alpha_2": "UZ", "title": "Uzbekistan", "region_name": "Toshkent" }, "experience_date": "2025-05-30T07:00:00+00:00", "resolution_status": null, "require_confirmation": false, "answers": [], "customer_service_experience": null, "source": "requested_review", "is_verified": true, "url": { "id": 1361355, "name": "SSLs.com", "title": "", "subindustry": null, "address": "http://ssls.com", "display_address": "ssls.com", "logos": { "original": "https://static.smartcustomer.com/img/urls/1361355/logo.1618494390.png", "biz": "https://static.smartcustomer.com/img/urls/1361355/thumbnail_logo_biz.1618494391.png", "review_desktop1x": "https://static.smartcustomer.com/img/urls/1361355/thumbnail_logo_review_desktop1x.1643034196.png", "review_desktop2x": "https://static.smartcustomer.com/img/urls/1361355/thumbnail_logo_review_desktop2x.1643034196.png", "review_mobile1x": "https://static.smartcustomer.com/img/urls/1361355/thumbnail_logo_review_mobile1x.1643034195.png", "review_mobile2x": "https://static.smartcustomer.com/img/urls/1361355/thumbnail_logo_review_mobile2x.1643034195.png", "review_tablet1x": "https://static.smartcustomer.com/img/urls/1361355/thumbnail_logo_review_tablet1x.1643034195.png", "review_tablet2x": "https://static.smartcustomer.com/img/urls/1361355/thumbnail_logo_review_tablet2x.1643034195.png", "trimmed": "https://static.smartcustomer.com/img/urls/1361355/thumbnail_logo_trimmed.1618494391.png", "default": "https://static.smartcustomer.com/img/websites/s/ssl/ssls.com-desktop%402x.1652806881.jpg" }, "average_ratings": { "rating": 4.47, "instant_feedback": 3.9 }, "review_numbers": { "reviews": 10138, "instant_feedback": 71745, "sj": 137, "short": 2280 }, "urls": { "wikipedia": null, "facebook": "https://www.facebook.com/SSLsCom", "twitter": "https://twitter.com/SSLscom", "linkedin": null, "youtube": "https://www.youtube.com/channel/UCwKGb0jm9ZYHyR8OO9xbfJA", "instagram": null, "tiktok": null, "pinterest": null, "crunchbase": null } }, "updated_reviews": [], "video_testimonials": [], "from_url": "https://api.smartcustomer.com/v2/businesses/ssls.com/reviews?per_page=100&sorting[field]=helpful&search=happy&page=1" } ``` Each record returns 50+ fields covering product identity, tour characteristics, pricing, and review content. #### Product Identity | Field | Meaning | |---|---| | `Product ID` | Unique internal identifier for the tour product | | `Product Title` | Full display name of the tour | | `Product Slug` | URL-friendly version of the title | | `Featured Image` | Primary product image URL | | `Search Image` | Thumbnail used in search result listings | | `Map Snapshot Image` | Static map preview of the tour route | #### Tour Classification Flags | Field | Meaning | |---|---| | `Is Multi Day Tour` | Tour spans multiple days | | `Is Private Tour` | Exclusively private bookings | | `Is Private And Group Tour` | Offers both private and group options | | `Is Group Tour` | Standard group departure | | `Is Small Group Tour` | Capped group size for intimate experience | | `Is Independent Tour` | Self-guided or flexible itinerary | | `Is Cruise Tour` | Cruise-based itinerary | | `Is Eco Tour` | Sustainability-focused experience | | `Is Solo Tour` | Designed for solo travelers | | `Is Single Country Tour` | Stays within one country | | `Is Multi Country Tour` | Crosses multiple countries | | `Is Tour Customizable` | Allows itinerary customization | | `Is API Operator` | Operator connected via API integration | #### Tour Details | Field | Meaning | |---|---| | `Duration` | Length of the tour (numeric value) | | `Duration Type` | Unit of duration (e.g., days, hours) | | `Duration In Minutes` | Normalized duration for comparison | | `Min Age` / `Max Age` | Participant age restrictions | | `Start Destination` | Tour departure location | | `End Destination` | Tour end location | | `Countries` | Countries visited | | `Destinations` | Specific destinations covered | | `Continents` | Continent(s) of the tour | | `Tour Types` | Category tags (e.g., adventure, cultural) | | `Trip Language` | Language the tour is conducted in | | `Guide Language` | Language(s) spoken by guides | | `Accommodations` | Accommodation types included | | `Accommodation Labels` | Descriptive labels (e.g., budget, boutique) | | `Activities` | Included activity types | | `Physical Rating Level` | Physical difficulty rating | #### Review & Rating Data | Field | Meaning | |---|---| | `Review Text` | Full text of the matched review | | `Description Text` | Product description from the listing | | `Rating Score` | Average rating score | | `Rating Count` | Total number of reviews | | `Is Best Seller` | Flagged as a best-selling product | | `Is Selling Fast` | High-demand availability indicator | #### Pricing | Field | Meaning | |---|---| | `Original Price` | Base price before discounts | | `Discounted Price` | Final price after discount | | `Discount Percentage` | Percentage reduction applied | | `Product Has Discount` | Boolean flag for active discount | | `Is Budget Tour` | Positioned as budget-friendly | | `Is Luxury Tour` | Premium tier product | #### Operator & Configuration | Field | Meaning | |---|---| | `Tour Operator ID` | Unique ID of the operating company | | `Tour Operator` | Operator name and metadata | | `Cutoff Days` | Booking cutoff days before departure | | `Default Region Code` | Primary region for pricing/availability | | `Default Version ID` | Default tour version identifier | | `Available Regions` | Regions where booking is available | *** ### How to Use 1. **Find your domain** — Go to Smartcustomer.com, open a business review page, and copy the domain segment from the URL (e.g., `reviews/yourbrand.com` → use `yourbrand.com`). 2. **Set your keyword** — Use a word likely to appear in relevant reviews (e.g., `"guide"`, `"price"`, `"recommend"`). Leave empty to collect all reviews. 3. **Choose sort order** — Use `"helpful-"` for highest-quality reviews or `"created-desc"` for the most recent. 4. **Set page and limit** — Start at `page: 1` and set `max_items_per_url` based on how many reviews you need. 5. **Run and export** — Download results as JSON or CSV for analysis in Excel, Python, or your BI tool. **Common issues:** - If output is empty, verify the `domain` value matches exactly what appears in the Smartcustomer URL. - Use `ignore_url_failures: true` for multi-domain batch runs to prevent single failures from stopping the job. *** ### Use Cases & Business Value - **Competitive pricing analysis:** Compare `Original Price` vs `Discounted Price` across operators in the same destination - **Sentiment research:** Filter reviews by keyword to identify common praise or complaints - **Tour benchmarking:** Use rating scores and best-seller flags to assess market positioning - **Inventory monitoring:** Track tour types, durations, and availability across regions *** ### Conclusion The **Smartcustomer.com Reviews Scraper** turns a complex, paginated review platform into clean, queryable datasets. With granular filtering by keyword and sort order, plus 50+ output fields spanning reviews, pricing, and tour metadata, it delivers the depth needed for serious travel market analysis. Configure your domain, run the scraper, and start extracting insights immediately. # Actor input Schema ## `domain` (type: `string`): Enter Business Domain. For example, reviews/ssls.com -> ssls.com) ## `keyword` (type: `string`): Keyword to search for ## `sort_by` (type: `string`): Select your option to sort reviews ## `page` (type: `integer`): Page to start from ## `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 { "domain": "ssls.com", "keyword": "happy", "page": 1, "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 = { "domain": "ssls.com", "keyword": "happy", "page": 1, "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/smartcustomer-reviews-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 = { "domain": "ssls.com", "keyword": "happy", "page": 1, "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/smartcustomer-reviews-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 '{ "domain": "ssls.com", "keyword": "happy", "page": 1, "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/smartcustomer-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/smartcustomer-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Smartcustomer Reviews Scraper", "description": "Scrape tour product reviews from Smartcustomer.com by domain, keyword, and sort order. Collect 50+ fields per listing including ratings, pricing, tour types, destinations, and operator details — ideal for travel analysts and tour operators.", "version": "0.0", "x-build-id": "mXe5dyrGoS9ybAxyP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~smartcustomer-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-smartcustomer-reviews-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~smartcustomer-reviews-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-smartcustomer-reviews-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~smartcustomer-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-smartcustomer-reviews-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": { "domain": { "title": "Domain of business (Business Domain on smartcustomer.com tour review page url, e.g. reviews/ssls.com -> ssls.com)", "type": "string", "description": "Enter Business Domain. For example, reviews/ssls.com -> ssls.com)" }, "keyword": { "title": "Keyword", "type": "string", "description": "Keyword to search for" }, "sort_by": { "title": "Sort by", "enum": [ "", "created-desc", "helpful-", "rating-" ], "type": "string", "description": "Select your option to sort reviews" }, "page": { "title": "Page", "type": "integer", "description": "Page to start from" }, "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 } } } } } } } } } } ```