# Purplle Reviews Scraper (`stealth_mode/purplle-reviews-scraper`) Actor Scrape product reviews from Purplle.com with precision. Extract ratings, user feedback, images, highlights, and 20+ fields per review — perfect for beauty brands, retailers, and market researchers analyzing cosmetics trends. - **URL**: https://apify.com/stealth\_mode/purplle-reviews-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 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 ## Purplle.com Reviews Scraper: Collect Beauty Product Ratings & Feedback --- ### About Purplle.com Purplle.com is India's prominent online beauty and personal care e-commerce platform, hosting thousands of cosmetics, skincare, and wellness products with customer reviews. Each product page accumulates hundreds of authentic customer reviews, ratings, and feedback — valuable data for brands monitoring reputation, researchers studying consumer preferences, and retailers analyzing product performance. Manually collecting this review data is labor-intensive; the **Purplle.com Reviews Scraper** automates extraction, delivering structured review data at scale. --- ### Overview The **Purplle Reviews Scraper** automatically extracts customer reviews, ratings, and metadata from product pages on Purplle.com. It captures both helpful and recent reviews, handling pagination automatically. The scraper is built for: - **Brand managers** monitoring product perception and customer satisfaction - **E-commerce analysts** tracking competitive products and review trends - **Market researchers** analyzing beauty consumer preferences in India - **Data scientists** building sentiment analysis and review datasets - **Retailers** aggregating customer feedback for business intelligence Key features include flexible sorting (most recent vs. most helpful), multi-page pagination, image capture, and configurable volume limits to match your collection scope. --- ### Input Format & Configuration The scraper accepts a JSON configuration object: ```json { "urls": [ "https://www.purplle.com/product/faces-canada-comfy-matte-wow-liquid-lipstick-cocoa-crush-07-3-8ml/reviews" ], "sort_by": "mh", "page": 2, "max_items_per_url": 200, "ignore_url_failures": true } ```` #### Configuration Parameters Explained | Parameter | Type | Description | Example | |---|---|---|---| | `urls` | Array | Product review page URLs from Purplle.com | `["https://www.purplle.com/product/.../reviews"]` | | `sort_by` | String | Sorting preference for reviews | `"mr"` (most recent) or `"mh"` (most helpful) | | `page` | Integer | Number of review pages to scrape per URL | `2` means 2 pages of reviews | | `max_items_per_url` | Integer | Maximum reviews collected per product URL | `200` | | `ignore_url_failures` | Boolean | Continue if some URLs fail instead of stopping | `true` or `false` | > **Tip:** Use `sort_by: "mh"` to prioritize verified, helpful reviews. Use `sort_by: "mr"` for latest customer feedback. *** ### Output Format & Field Definitions **Sample output** ```json { "created_on": "18/8/2025", "creator_id": 40196988, "rating": 5, "module_id": 379581, "title": "very good👍\n", "review_id": 19547589, "is_liked": 0, "body": "this is my second purchase. it's very good product 💗", "commen_lgt": 53, "count_like": 1, "count_dislike": 0, "user_details": { "name": "Guest", "image": "https://media6.ppl-media.com/mediafiles/ecomm/promo/1493299751_female.png", "review_count": 1, "followers_count": 0, "is_follow": 0, "slug": "16b0kc-16b5gk", "expert_text": null }, "certified_buyer_review": 1, "highlights": "Moisturizing, Transfer-Proof, Long Lasting, Smooth In Finish, Value For Money", "highlight_texts": [ { "id": "264~1", "text": "Moisturizing", "type": "positive" }, { "id": "319~1", "text": "Transfer-Proof", "type": "positive" }, { "id": "373~1", "text": "Long Lasting", "type": "positive" }, { "id": "393~1", "text": "Smooth In Finish", "type": "positive" }, { "id": "10~1", "text": "Value For Money", "type": "positive" } ], "user_persona": [], "variant": { "group_id": 18843, "group_value": "options", "group_type": "options", "group_display_type": "image", "group_display_text": "Shade", "selected_index": 0, "items": [ { "id": 137013, "product_id": 379581, "slug": "faces-canada-comfy-matte-wow-liquid-lipstick-cocoa-crush-07-3-8ml-one-swipe-application-highly-pigmented-comfortable-wear-glides-smoothly-long-lasting-transferproof", "stock_status": 1, "our_price": 249, "app_discount": 0, "price": 299, "app_our_price": 299, "product_name": "FACES CANADA Comfy Matte Wow Liquid Lipstick - Cocoa Crush 07, 3.8 ml | One Swipe Application | Highly Pigmented | Comfortable Wear | Glides Smoothly | Long Lasting | Transferproof", "option_display_name": "Cocoa Crush 07", "option_display_value": "https://media6.ppl-media.com/tr:h-100,w-100,c-at_max,bg-FFFFFF,dpr-2/mediafiles/ecomm/misc/1717673999_9.jpg", "group_id": 18843, "group_value": "options", "group_type": "options", "group_display_type": "image", "group_display_text": "Shade", "is_selected": 1 } ], "count": 1 }, "score": 0, "is_same_variant": 1, "review_images": [ { "image_id": 633040, "url": "https://media4.ppl-media.com/tr:h-750,w-750,c-at_max,dpr-2/mediafiles/reviews/images/379581/19547577/32741755493246.jpg" } ], "from_url": "https://www.purplle.com/product/faces-canada-comfy-matte-wow-liquid-lipstick-cocoa-crush-07-3-8ml-one-swipe-application-highly-pigmented-comfortable-wear-glides-smoothly-long-lasting-transferproof/reviews" } ``` Each scraped review returns 20+ fields of structured data: #### Review Identification | Field | Description | Example | |---|---|---| | `Review ID` | Unique identifier for the review in the Purplle system | `12345678` | | `Module ID` | Product module identifier linked to the review | `product_98765` | | `Creator ID` | Unique identifier of the reviewer (anonymized) | `user_4521` | #### Review Content & Metadata | Field | Description | Example | |---|---|---| | `Title` | Summary headline written by the reviewer | `"Great long-lasting lipstick!"` | | `Body` | Full review text with detailed feedback | `"The color is vibrant and stays all day without flaking..."` | | `Rating` | Star rating given by the reviewer | `4` or `5` | | `Score` | Calculated review quality or relevance score | `0.85` | | `Created On` | Timestamp when the review was posted | `2024-01-15T10:30:00Z` | #### Engagement & Verification | Field | Description | Example | |---|---|---| | `Count Like` | Number of users who found the review helpful | `342` | | `Count Dislike` | Number of users who found the review unhelpful | `8` | | `Is Liked` | Whether the current user liked the review | `true` | | `Certified Buyer Review` | Flag indicating if reviewer purchased the product | `true` | | `Is Same Variant` | Whether reviewer purchased the exact product variant | `true` | #### User & Product Details | Field | Description | Example | |---|---|---| | `User Details` | Reviewer profile information (name, verified status) | `{"name": "Sarah M.", "verified": true}` | | `User Persona` | Inferred user category (e.g., first-time buyer, regular) | `"Regular Buyer"` | | `Variant` | Product variant reviewed (shade, size, etc.) | `"Cocoa Crush 07 - 3.8ml"` | #### Review Components & Media | Field | Description | Example | |---|---|---| | `Highlights` | Key positive/negative points extracted from review | `["Long-lasting", "Rich color"]` | | `Highlight Texts` | Full text of highlighted review sections | `["The color is incredibly pigmented", "Smooth application"]` | | `Review Images` | URLs of images uploaded with the review | `["https://cdn.purplle.com/review_img_1.jpg"]` | | `Commen Lgt` | Character count or length metric of the review body | `245` | *** ### How to Use 1. **Find product review URLs** — Navigate to any Purplle.com product page, scroll to "Reviews" section, and copy the full review page URL (e.g., `https://www.purplle.com/product/.../reviews`). 2. **Configure your input** — Paste 1 or more review URLs into the `urls` array. Decide on sorting: use `"mh"` for most helpful, `"mr"` for most recent. 3. **Set pagination & limits** — Choose how many pages (`page: 2` = 2 pages) and max items per URL (`max_items_per_url: 200`) you need. 4. **Enable error handling** — Set `ignore_url_failures: true` for bulk runs to skip broken links without stopping the scraper. 5. **Launch & export** — Run the actor and download results as JSON, CSV, or connect directly to your data pipeline. **Best practices:** - Start with `page: 1` to test, then increase once working smoothly. - For popular products, `max_items_per_url` can be set to 500+ to capture diverse opinions. - Certified buyer reviews (`Certified Buyer Review: true`) tend to be more reliable for analysis. *** ### Real-World Use Cases - **Brand monitoring:** Track how customers perceive your cosmetics line; identify recurring complaints or praise - **Competitive intelligence:** Analyze reviews of rival products to spot market opportunities - **Sentiment analysis:** Process review bodies and ratings to measure product satisfaction trends - **Product development:** Use highlights and feedback to guide reformulation or variant launches - **Content marketing:** Leverage authentic customer testimonials from review data for campaigns The **Purplle Reviews Scraper** transforms scattered customer feedback into clean, machine-readable datasets ready for Excel, SQL databases, or machine learning pipelines. *** ### Conclusion The **Purplle.com Reviews Scraper** is the fastest way to collect authentic beauty product reviews at scale. With 20+ data fields covering ratings, text, images, and user verification, it provides complete insight into product perception. Whether you're a brand, retailer, or researcher, this scraper unlocks the customer intelligence hidden in Purplle's review ecosystem. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the Products details urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `sort_by` (type: `string`): Select your option to sort reviews ## `page` (type: `integer`): Enter the number of pages to scrape ## `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.purplle.com/product/faces-canada-comfy-matte-wow-liquid-lipstick-cocoa-crush-07-3-8ml-one-swipe-application-highly-pigmented-comfortable-wear-glides-smoothly-long-lasting-transferproof/reviews" ], "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 = { "urls": [ "https://www.purplle.com/product/faces-canada-comfy-matte-wow-liquid-lipstick-cocoa-crush-07-3-8ml-one-swipe-application-highly-pigmented-comfortable-wear-glides-smoothly-long-lasting-transferproof/reviews" ], "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/purplle-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 = { "urls": ["https://www.purplle.com/product/faces-canada-comfy-matte-wow-liquid-lipstick-cocoa-crush-07-3-8ml-one-swipe-application-highly-pigmented-comfortable-wear-glides-smoothly-long-lasting-transferproof/reviews"], "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/purplle-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 '{ "urls": [ "https://www.purplle.com/product/faces-canada-comfy-matte-wow-liquid-lipstick-cocoa-crush-07-3-8ml-one-swipe-application-highly-pigmented-comfortable-wear-glides-smoothly-long-lasting-transferproof/reviews" ], "page": 1, "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/purplle-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/purplle-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Purplle Reviews Scraper", "description": "Scrape product reviews from Purplle.com with precision. Extract ratings, user feedback, images, highlights, and 20+ fields per review — perfect for beauty brands, retailers, and market researchers analyzing cosmetics trends.", "version": "0.0", "x-build-id": "NGRnYBdWh9gmWmGAE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~purplle-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-purplle-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~purplle-reviews-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-purplle-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~purplle-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-purplle-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": { "urls": { "title": "URLs of the Products details urls to scrape", "type": "array", "description": "Add the URLs of the Products details 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" } }, "sort_by": { "title": "Sort by", "enum": [ "mr", "mh" ], "type": "string", "description": "Select your option to sort reviews" }, "page": { "title": "Number of pages to scrape", "type": "integer", "description": "Enter the number of pages to scrape" }, "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 } } } } } } } } } } ```