# Sociolla Product Search Scraper (`stealth_mode/sociolla-product-search-scraper`) Actor Extract detailed beauty product information from Sociolla.com search results, including pricing, availability, discounts, stock status, and 46+ fields per product. Perfect for price monitoring, competitor analysis, and beauty market intelligence. - **URL**: https://apify.com/stealth\_mode/sociolla-product-search-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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Sociolla Products Scraper: Scrape Beauty Product Data at Scale *** ### What Is Sociolla? Sociolla is a leading Southeast Asian e-commerce platform specializing in beauty, skincare, and cosmetics products. It aggregates thousands of brands and SKUs with real-time pricing, discounts, and availability across multiple markets (Indonesia, Vietnam). For researchers, price analysts, and market intelligence teams, manually collecting this product data is labor-intensive — the **Sociolla Products Scraper** automates extraction, delivering structured datasets ready for analysis. *** ### Overview The **Sociolla Products Scraper** extracts product listings from Sociolla.com search results, capturing comprehensive product metadata, pricing, promotion details, and stock information. It is ideal for: - **Price monitoring platforms** tracking beauty product costs across regions - **Competitive intelligence teams** analyzing market positioning and promotional tactics - **Market researchers** studying beauty sector trends and product availability - **E-commerce aggregators** building multi-source product catalogs - **Dropshippers and retailers** identifying sourcing opportunities The scraper handles paginated search results efficiently, with configurable item limits and robust error handling via `ignore_url_failures`. *** ### Input Format The scraper accepts a JSON configuration object with the following structure: ```json { "urls": [ "https://www.sociolla.com/search?q=lip&page=2" ], "ignore_url_failures": true, "max_items_per_url": 200 } ``` | Field | Type | Description | |---|---|---| | `urls` | Array | Add product search result URLs from Sociolla.com. Supports pagination (e.g., `?page=1`, `?page=2`) and any search query parameter (e.g., `?q=lip`, `?q=moisturizer`). One URL per line in bulk edit mode. | | `ignore_url_failures` | Boolean | If `true`, the scraper continues running even if individual URLs fail to load or return no results. Useful for large batch runs. Default: `true`. | | `max_items_per_url` | Integer | Maximum number of products to extract per URL (e.g., `20`, `200`). Limits data volume and run time. Default: `20`. | > **Example:** To scrape all lip products across pages 1–5, add five URLs: `https://www.sociolla.com/search?q=lip&page=1`, `&page=2`, etc. *** ### Output Format **Sample output** ```json { "brand": { "id": "5d3ac307a6992471b7c97a2d", "name": "BLP Beauty", "slug": "237_blp-beauty" }, "default_category": { "id": "5d3d502437382b158ee6ddc7", "name": "Lip Gloss", "slug": "172-lip-gloss", "my_soco_sql_id": 165, "rating_types": [ "is_star_long_wear", "is_star_packaging", "is_star_pigmentation", "is_star_texture", "is_star_value_for_money" ] }, "review_stats": { "average_rating_by_types": { "star_value_for_money": 4.678362573099415, "star_long_wear": 4.608187134502924, "star_packaging": 4.707602339181286, "star_texture": 4.713450292397661 }, "average_rating": 4.535911602209945, "total_reviews": 181, "total_recommended_count": 172, "total_repurchase_maybe_count": 49, "total_repurchase_no_count": 13, "total_repurchase_yes_count": 119, "last_updated_at": "2026-06-02T06:35:56.246Z" }, "is_sale": true, "is_flashsale": false, "is_pre_order": false, "is_active_in_review": true, "is_active_in_sociolla": true, "is_active_in_lulla": false, "is_active_in_offline_store": true, "is_active_in_event_microsite": false, "is_active_in_event_microsite_vn": false, "is_active_in_sociolla_vn": false, "is_active_in_review_vn": false, "total_orders": 10807, "is_out_of_stock_sociolla": false, "is_out_of_stock_sociolla_vn": false, "is_in_stock_sociolla": true, "is_in_stock_lulla": false, "is_red_carpet": false, "name": "Lip Petals", "images": [ { "url": "https://images.soco.id/2e17c506-f6f7-4b09-902b-2ee58a6ca245-.jpg", "is_cover": true, "is_lilla_cover": false, "is_cosrx_cover": false }, { "url": "https://images.soco.id/509559e5-426e-4008-bf3f-f17ae36f77da-.jpg", "is_cover": false, "is_lilla_cover": false, "is_cosrx_cover": false }, { "url": "https://images.soco.id/bd893f90-e697-455b-8216-2365b2648066-.jpg", "is_cover": false, "is_lilla_cover": false, "is_cosrx_cover": false }, { "url": "https://images.soco.id/77b77490-9235-47b5-8120-b05c7f1ae9c0-.jpg", "is_cover": false, "is_lilla_cover": false, "is_cosrx_cover": false }, { "url": "https://images.soco.id/060f3b15-20d4-428d-8c7c-7e0b55a5af99-.jpg", "is_cover": false, "is_lilla_cover": false, "is_cosrx_cover": false }, { "url": "https://images.soco.id/72f9f788-ec67-4600-a565-5d4463e38683-.jpg", "is_cover": false, "is_lilla_cover": false, "is_cosrx_cover": false } ], "combinations": [ { "is_default": true, "attributes": { "shade": { "id": "65af6a3362b6bd61570da1c5", "value": "https://images.soco.id/c4ee6148-383f-4b60-aaa2-288b3829b98b-.jpg", "my_soco_sql_id": 38789, "name": "Shade Cedar" } }, "images": [ { "url": "https://images.soco.id/2e17c506-f6f7-4b09-902b-2ee58a6ca245-.jpg", "is_cover": false, "is_lilla_cover": false, "is_cosrx_cover": false }, { "url": "https://images.soco.id/509559e5-426e-4008-bf3f-f17ae36f77da-.jpg", "is_cover": true, "is_lilla_cover": false, "is_cosrx_cover": false }, { "url": "https://images.soco.id/72f9f788-ec67-4600-a565-5d4463e38683-.jpg", "is_cover": false, "is_lilla_cover": false, "is_cosrx_cover": false } ], "price": 149000, "stock": 1, "safety_stock": 0, "i18n": { "vi": { "stock": 0, "images": [], "others_ean_no": [], "stores": [], "stock_market_place": 0, "reserved_qty": 0, "reserved_stock_marketplace": 0, "weight": 0, "status_item": "not_selected", "price_after_discount": null } }, "is_active_in_review": true, "is_active_in_review_vn": false, "is_active_in_sociolla": true, "is_active_in_lulla": false, "is_active_in_sociolla_vn": false, "is_active_in_offline_store": true, "is_active_in_offline_store_vn": false, "is_active_in_offline_store_lilla": false, "is_active_in_carasun": false, "is_active_in_cosrx": false, "is_active_in_b2b": false, "is_active_in_event_microsite": false, "is_active_in_event_microsite_vn": false, "is_active_in_speakstome": false, "is_limited": false, "is_exclusive": false, "is_out_of_stock_sociolla": false, "is_out_of_stock_lulla": false, "is_out_of_stock_sociolla_vn": false, "is_out_of_stock_carasun": false, "is_out_of_stock_cosrx": false, "discounts": [ { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-05T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 55, "deduction_amount": 0, "deduction_for_sociolla": 5, "deduction_for_brand": 50, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": "6a1bb9d3334d0c74e2f81911", "is_flashsale": null, "product_price_rule_id": "6a1bb9d3334d0c74e2f81911", "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Repricing_Jacquelle Beaute_TREECELL_Vaseline_TRESemmé_Tresemme_Pond's_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_ESQA_Studio Tropik", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-06-02T04:05:46.041Z", "is_show_as_percentage": false, "is_tactical_sales": true }, { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-05T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 55, "deduction_amount": 0, "deduction_for_sociolla": 5, "deduction_for_brand": 50, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": "6a1942dbcfea1044aa0c7d45", "is_flashsale": null, "product_price_rule_id": "6a1942dbcfea1044aa0c7d45", "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_TIMEPHORIA", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-06-02T04:04:57.527Z", "is_show_as_percentage": false, "is_tactical_sales": true }, { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-30T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 50, "deduction_amount": 0, "deduction_for_sociolla": 0, "deduction_for_brand": 50, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": null, "is_flashsale": false, "product_price_rule_id": "6a1be13659052f77253e7285", "product_price_rule_name": "AON | 1 Jun - 30 Jun 2026 | Mix Brand | Ray | 2", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-05-31T07:20:22.753Z", "is_show_as_percentage": false, "is_tactical_sales": false } ], "preorder": [], "is_deleted": false, "_id": "65a9f8497a7b12c7c8d172aa", "price_after_discount": 67050, "is_wishlist": false, "is_pre_order": false, "stores": [], "deduction_type": "percentage", "deduction_percentage": 55, "deduction_amount": 0, "deduction_for_sociolla": 5, "deduction_for_brand": 50, "total_quota": null, "sold_quota": null, "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Repricing_Jacquelle Beaute_TREECELL_Vaseline_TRESemmé_Tresemme_Pond's_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_ESQA_Studio Tropik", "product_price_rule_id": "6a1bb9d3334d0c74e2f81911", "show_flashsale_pdp": false, "is_show_as_percentage": false }, { "is_default": false, "attributes": { "shade": { "id": "65af6a5b2129ab4c5fa0a51b", "value": "https://images.soco.id/f0db40d6-bd73-401e-b102-b77e5b85e061-.jpg", "my_soco_sql_id": 38790, "name": "Shade Clay" } }, "images": [ { "url": "https://images.soco.id/bd893f90-e697-455b-8216-2365b2648066-.jpg", "is_cover": true, "is_lilla_cover": false, "is_cosrx_cover": false } ], "price": 149000, "stock": 0, "safety_stock": 0, "i18n": { "vi": { "stock": 0, "images": [], "others_ean_no": [], "stores": [], "stock_market_place": 0, "reserved_qty": 0, "reserved_stock_marketplace": 0, "weight": 0, "status_item": "not_selected" } }, "is_active_in_review": true, "is_active_in_review_vn": false, "is_active_in_sociolla": true, "is_active_in_lulla": false, "is_active_in_sociolla_vn": false, "is_active_in_offline_store": true, "is_active_in_offline_store_vn": false, "is_active_in_offline_store_lilla": false, "is_active_in_carasun": false, "is_active_in_cosrx": false, "is_active_in_b2b": false, "is_active_in_event_microsite": false, "is_active_in_event_microsite_vn": false, "is_active_in_speakstome": false, "is_limited": false, "is_exclusive": false, "is_out_of_stock_sociolla": false, "is_out_of_stock_lulla": false, "is_out_of_stock_sociolla_vn": false, "is_out_of_stock_carasun": false, "is_out_of_stock_cosrx": false, "discounts": [ { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-05T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 55, "deduction_amount": 0, "deduction_for_sociolla": 5, "deduction_for_brand": 50, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": "6a1bb9d3334d0c74e2f81911", "is_flashsale": null, "product_price_rule_id": "6a1bb9d3334d0c74e2f81911", "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Repricing_Jacquelle Beaute_TREECELL_Vaseline_TRESemmé_Tresemme_Pond's_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_ESQA_Studio Tropik", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-06-02T04:05:46.041Z", "is_show_as_percentage": false, "is_tactical_sales": true }, { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-05T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 55, "deduction_amount": 0, "deduction_for_sociolla": 5, "deduction_for_brand": 50, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": "6a1942dbcfea1044aa0c7d45", "is_flashsale": null, "product_price_rule_id": "6a1942dbcfea1044aa0c7d45", "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_TIMEPHORIA", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-06-02T04:04:57.527Z", "is_show_as_percentage": false, "is_tactical_sales": true }, { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-30T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 50, "deduction_amount": 0, "deduction_for_sociolla": 0, "deduction_for_brand": 50, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": null, "is_flashsale": false, "product_price_rule_id": "6a1be13659052f77253e7285", "product_price_rule_name": "AON | 1 Jun - 30 Jun 2026 | Mix Brand | Ray | 2", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-05-31T07:20:22.753Z", "is_show_as_percentage": false, "is_tactical_sales": false } ], "preorder": [], "is_deleted": false, "_id": "65a9f84a7a7b12d08dd172ab", "price_after_discount": 67050, "is_wishlist": false, "is_pre_order": false, "deduction_type": "percentage", "deduction_percentage": 55, "deduction_amount": 0, "deduction_for_sociolla": 5, "deduction_for_brand": 50, "total_quota": null, "sold_quota": null, "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Repricing_Jacquelle Beaute_TREECELL_Vaseline_TRESemmé_Tresemme_Pond's_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_ESQA_Studio Tropik", "product_price_rule_id": "6a1bb9d3334d0c74e2f81911", "show_flashsale_pdp": false, "is_show_as_percentage": false }, { "is_default": false, "attributes": { "shade": { "id": "65af6a7abf198f7cd9e4efef", "value": "https://images.soco.id/d9de3334-ac32-4ca2-add8-07bea779ab5e-.jpg", "my_soco_sql_id": 38791, "name": "Shade Oak" } }, "images": [ { "url": "https://images.soco.id/77b77490-9235-47b5-8120-b05c7f1ae9c0-.jpg", "is_cover": true, "is_lilla_cover": false, "is_cosrx_cover": false } ], "price": 149000, "stock": 4, "safety_stock": 0, "i18n": { "vi": { "stock": 0, "images": [], "others_ean_no": [], "stores": [], "stock_market_place": 0, "reserved_qty": 0, "reserved_stock_marketplace": 0, "weight": 0, "status_item": "not_selected" } }, "is_active_in_review": true, "is_active_in_review_vn": false, "is_active_in_sociolla": true, "is_active_in_lulla": false, "is_active_in_sociolla_vn": false, "is_active_in_offline_store": true, "is_active_in_offline_store_vn": false, "is_active_in_offline_store_lilla": false, "is_active_in_carasun": false, "is_active_in_cosrx": false, "is_active_in_b2b": false, "is_active_in_event_microsite": false, "is_active_in_event_microsite_vn": false, "is_active_in_speakstome": false, "is_limited": false, "is_exclusive": false, "is_out_of_stock_sociolla": false, "is_out_of_stock_lulla": false, "is_out_of_stock_sociolla_vn": false, "is_out_of_stock_carasun": false, "is_out_of_stock_cosrx": false, "discounts": [ { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-05T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 12, "deduction_amount": 0, "deduction_for_sociolla": 2, "deduction_for_brand": 10, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": "6a1bb9d3334d0c74e2f81911", "is_flashsale": null, "product_price_rule_id": "6a1bb9d3334d0c74e2f81911", "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Repricing_Jacquelle Beaute_TREECELL_Vaseline_TRESemmé_Tresemme_Pond's_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_ESQA_Studio Tropik", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-06-02T04:05:46.041Z", "is_show_as_percentage": false, "is_tactical_sales": true }, { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-05T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 12, "deduction_amount": 0, "deduction_for_sociolla": 2, "deduction_for_brand": 10, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": "6a1942dbcfea1044aa0c7d45", "is_flashsale": null, "product_price_rule_id": "6a1942dbcfea1044aa0c7d45", "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_TIMEPHORIA", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-06-02T04:04:57.527Z", "is_show_as_percentage": false, "is_tactical_sales": true }, { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-30T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 10, "deduction_amount": 0, "deduction_for_sociolla": 0, "deduction_for_brand": 10, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": null, "is_flashsale": false, "product_price_rule_id": "6a1be13659052f77253e7285", "product_price_rule_name": "AON | 1 Jun - 30 Jun 2026 | Mix Brand | Ray | 2", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-05-31T07:20:22.753Z", "is_show_as_percentage": false, "is_tactical_sales": false } ], "preorder": [], "is_deleted": false, "_id": "65a9f84a7a7b123b80d172ac", "price_after_discount": 131120, "is_wishlist": false, "is_pre_order": false, "deduction_type": "percentage", "deduction_percentage": 12, "deduction_amount": 0, "deduction_for_sociolla": 2, "deduction_for_brand": 10, "total_quota": null, "sold_quota": null, "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Repricing_Jacquelle Beaute_TREECELL_Vaseline_TRESemmé_Tresemme_Pond's_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_ESQA_Studio Tropik", "product_price_rule_id": "6a1bb9d3334d0c74e2f81911", "show_flashsale_pdp": false, "is_show_as_percentage": false }, { "is_default": false, "attributes": { "shade": { "id": "65af6ac5e01f341786685e96", "value": "https://images.soco.id/346dd59c-2f01-41c7-b1b9-3263cd6c265f-.jpg", "my_soco_sql_id": 38792, "name": "Shade River" } }, "images": [ { "url": "https://images.soco.id/060f3b15-20d4-428d-8c7c-7e0b55a5af99-.jpg", "is_cover": true, "is_lilla_cover": false, "is_cosrx_cover": false } ], "price": 149000, "stock": 4, "safety_stock": 0, "i18n": { "vi": { "stock": 0, "images": [], "others_ean_no": [], "stores": [], "stock_market_place": 0, "reserved_qty": 0, "reserved_stock_marketplace": 0, "weight": 0, "status_item": "not_selected" } }, "is_active_in_review": true, "is_active_in_review_vn": false, "is_active_in_sociolla": true, "is_active_in_lulla": false, "is_active_in_sociolla_vn": false, "is_active_in_offline_store": true, "is_active_in_offline_store_vn": false, "is_active_in_offline_store_lilla": false, "is_active_in_carasun": false, "is_active_in_cosrx": false, "is_active_in_b2b": false, "is_active_in_event_microsite": false, "is_active_in_event_microsite_vn": false, "is_active_in_speakstome": false, "is_limited": false, "is_exclusive": false, "is_out_of_stock_sociolla": false, "is_out_of_stock_lulla": false, "is_out_of_stock_sociolla_vn": false, "is_out_of_stock_carasun": false, "is_out_of_stock_cosrx": false, "discounts": [ { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-05T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 12, "deduction_amount": 0, "deduction_for_sociolla": 2, "deduction_for_brand": 10, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": "6a1bb9d3334d0c74e2f81911", "is_flashsale": null, "product_price_rule_id": "6a1bb9d3334d0c74e2f81911", "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Repricing_Jacquelle Beaute_TREECELL_Vaseline_TRESemmé_Tresemme_Pond's_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_ESQA_Studio Tropik", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-06-02T04:05:46.041Z", "is_show_as_percentage": false, "is_tactical_sales": true }, { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-05T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 12, "deduction_amount": 0, "deduction_for_sociolla": 2, "deduction_for_brand": 10, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": "6a1942dbcfea1044aa0c7d45", "is_flashsale": null, "product_price_rule_id": "6a1942dbcfea1044aa0c7d45", "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_TIMEPHORIA", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-06-02T04:04:57.527Z", "is_show_as_percentage": false, "is_tactical_sales": true }, { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-30T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 10, "deduction_amount": 0, "deduction_for_sociolla": 0, "deduction_for_brand": 10, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": null, "is_flashsale": false, "product_price_rule_id": "6a1be13659052f77253e7285", "product_price_rule_name": "AON | 1 Jun - 30 Jun 2026 | Mix Brand | Ray | 2", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-05-31T07:20:22.753Z", "is_show_as_percentage": false, "is_tactical_sales": false } ], "preorder": [], "is_deleted": false, "_id": "65a9f84a7a7b12c944d172ad", "price_after_discount": 131120, "is_wishlist": false, "is_pre_order": false, "deduction_type": "percentage", "deduction_percentage": 12, "deduction_amount": 0, "deduction_for_sociolla": 2, "deduction_for_brand": 10, "total_quota": null, "sold_quota": null, "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Repricing_Jacquelle Beaute_TREECELL_Vaseline_TRESemmé_Tresemme_Pond's_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_ESQA_Studio Tropik", "product_price_rule_id": "6a1bb9d3334d0c74e2f81911", "show_flashsale_pdp": false, "is_show_as_percentage": false } ], "pack_detail": [], "discounts": [], "classification": "sellable_products", "created_at": "2024-01-19T04:19:22.179Z", "id": 110082, "my_sociolla_sql_id": 81740, "slug": "81740-lip-petals", "is_in_stock": true, "url_sociolla": "https://www.sociolla.com/lip-gloss/81740-lip-petals?is_preview=true", "active_for_sociolla_at": "2024-02-27T11:26:40.486Z", "is_out_of_stock_event_store": false, "default_combination": { "is_default": true, "attributes": { "shade": { "id": "65af6a3362b6bd61570da1c5", "value": "https://images.soco.id/c4ee6148-383f-4b60-aaa2-288b3829b98b-.jpg", "my_soco_sql_id": 38789, "name": "Shade Cedar" } }, "images": [ { "url": "https://images.soco.id/2e17c506-f6f7-4b09-902b-2ee58a6ca245-.jpg", "is_cover": false, "is_lilla_cover": false, "is_cosrx_cover": false }, { "url": "https://images.soco.id/509559e5-426e-4008-bf3f-f17ae36f77da-.jpg", "is_cover": true, "is_lilla_cover": false, "is_cosrx_cover": false }, { "url": "https://images.soco.id/72f9f788-ec67-4600-a565-5d4463e38683-.jpg", "is_cover": false, "is_lilla_cover": false, "is_cosrx_cover": false } ], "price": 149000, "stock": 1, "safety_stock": 0, "i18n": { "vi": { "stock": 0, "images": [], "others_ean_no": [], "stores": [], "stock_market_place": 0, "reserved_qty": 0, "reserved_stock_marketplace": 0, "weight": 0, "status_item": "not_selected", "price_after_discount": null } }, "is_active_in_review": true, "is_active_in_review_vn": false, "is_active_in_sociolla": true, "is_active_in_lulla": false, "is_active_in_sociolla_vn": false, "is_active_in_offline_store": true, "is_active_in_offline_store_vn": false, "is_active_in_offline_store_lilla": false, "is_active_in_carasun": false, "is_active_in_cosrx": false, "is_active_in_b2b": false, "is_active_in_event_microsite": false, "is_active_in_event_microsite_vn": false, "is_active_in_speakstome": false, "is_limited": false, "is_exclusive": false, "is_out_of_stock_sociolla": false, "is_out_of_stock_lulla": false, "is_out_of_stock_sociolla_vn": false, "is_out_of_stock_carasun": false, "is_out_of_stock_cosrx": false, "discounts": [ { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-05T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 55, "deduction_amount": 0, "deduction_for_sociolla": 5, "deduction_for_brand": 50, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": "6a1bb9d3334d0c74e2f81911", "is_flashsale": null, "product_price_rule_id": "6a1bb9d3334d0c74e2f81911", "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Repricing_Jacquelle Beaute_TREECELL_Vaseline_TRESemmé_Tresemme_Pond's_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_ESQA_Studio Tropik", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-06-02T04:05:46.041Z", "is_show_as_percentage": false, "is_tactical_sales": true }, { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-05T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 55, "deduction_amount": 0, "deduction_for_sociolla": 5, "deduction_for_brand": 50, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": "6a1942dbcfea1044aa0c7d45", "is_flashsale": null, "product_price_rule_id": "6a1942dbcfea1044aa0c7d45", "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_TIMEPHORIA", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-06-02T04:04:57.527Z", "is_show_as_percentage": false, "is_tactical_sales": true }, { "from_date": "2026-05-31T17:00:00.000Z", "end_date": "2026-06-30T16:59:59.000Z", "deduction_type": "percentage", "deduction_percentage": 50, "deduction_amount": 0, "deduction_for_sociolla": 0, "deduction_for_brand": 50, "apply_discount_for": [ "sociolla", "offline_store", "android", "ios" ], "discount_id": null, "is_flashsale": false, "product_price_rule_id": "6a1be13659052f77253e7285", "product_price_rule_name": "AON | 1 Jun - 30 Jun 2026 | Mix Brand | Ray | 2", "total_quota": 0, "sold_quota": 0, "max_item": 0, "starting_counter": 0, "updated_at": "2026-05-31T07:20:22.753Z", "is_show_as_percentage": false, "is_tactical_sales": false } ], "preorder": [], "is_deleted": false, "_id": "65a9f8497a7b12c7c8d172aa", "price_after_discount": 67050, "is_wishlist": false, "is_pre_order": false, "stores": [], "deduction_type": "percentage", "deduction_percentage": 55, "deduction_amount": 0, "deduction_for_sociolla": 5, "deduction_for_brand": 50, "total_quota": null, "sold_quota": null, "product_price_rule_name": "SCL-12478 ROAD TO 6.6 | 1-5 June 2026_Repricing_Jacquelle Beaute_TREECELL_Vaseline_TRESemmé_Tresemme_Pond's_Beauty Secrets_Kusuma Kosmetika_BLP Beauty_Bob & Frou_Mad For Makeup_Becoming_ESQA_Studio Tropik", "product_price_rule_id": "6a1bb9d3334d0c74e2f81911", "show_flashsale_pdp": false, "is_show_as_percentage": false }, "is_buy_one_get_one_free": false, "show_flashsale_pdp": false, "min_price": 149000, "max_price": 149000, "min_price_after_discount": 67050, "max_price_after_discount": 131120, "price_range": "Rp149.000", "price_after_discount_range": "Rp67.050 - Rp131.120", "discount_range": "UP TO 55%", "discount_percentage": null, "is_new": false, "from_url": "https://www.sociolla.com/search?q=lip&page=2" } ``` Each product returns a comprehensive record with 46+ fields: #### Product Identification | Field | Meaning | |---|---| | `ID` | Primary product identifier in Sociolla's system | | `My Sociolla SQL ID` | Internal database ID | | `Slug` | URL-friendly product name for SEO purposes | | `Name` | Full product title as displayed on Sociolla | | `Brand` | Product brand or manufacturer | | `Default Category` | Primary product category (e.g., Lip Care, Skincare) | | `Classification` | Detailed product classification or subcategory | #### Pricing & Discounts | Field | Meaning | |---|---| | `Min Price` | Lowest price variant (in local currency) | | `Max Price` | Highest price variant | | `Min Price After Discount` | Lowest discounted price | | `Max Price After Discount` | Highest discounted price | | `Price Range` | Text summary of price variation (e.g., "Rp 50k – 150k") | | `Price After Discount Range` | Text summary after promotions | | `Discount Range` | Range of discount amounts across variants | | `Discount Percentage` | Average or maximum discount percentage | | `Is Sale` | Boolean flag: product is on sale | | `Is Flashsale` | Boolean flag: product is part of a flash sale event | | `Is Pre Order` | Boolean flag: product is available for pre-order | | `Show Flashsale PDP` | Display flashsale badge on product detail page | #### Inventory & Availability | Field | Meaning | |---|---| | `Is In Stock` | Overall stock availability | | `Is In Stock Sociolla` | Stock status on Sociolla.com main platform | | `Is In Stock Lulla` | Stock availability on Lulla marketplace (if applicable) | | `Is Out Of Stock Sociolla` | Out-of-stock flag for Sociolla.com | | `Is Out Of Stock Sociolla VN` | Out-of-stock flag for Sociolla Vietnam | | `Is Out Of Stock Event Store` | Out-of-stock for event-specific storefronts | | `Total Orders` | Total number of orders placed (popularity metric) | #### Platform Availability | Field | Meaning | |---|---| | `Is Active In Sociolla` | Product is active on Sociolla.com (Indonesia) | | `Is Active In Sociolla VN` | Product is active on Sociolla Vietnam | | `Is Active In Lulla` | Available on Lulla marketplace | | `Is Active In Review` | Product has active customer reviews (Indonesia) | | `Is Active In Review VN` | Product has active reviews (Vietnam) | | `Is Active In Offline Store` | Available in physical Sociolla stores | | `Is Active In Event Microsite` | Featured in special event campaigns | | `Is Active In Event Microsite VN` | Event microsite availability (Vietnam) | #### Promotions & Special Flags | Field | Meaning | |---|---| | `Is Buy One Get One Free` | BOGO promotion active | | `Is Red Carpet` | Red Carpet VIP product status | | `Is New` | Recently launched product flag | #### Product Details | Field | Meaning | |---|---| | `Images` | Array of product image URLs for all variants/angles | | `Pack Detail` | Packaging information (size, weight, quantity) | | `Combinations` | Available product variants (color, size, volume) | | `Default Combination` | Pre-selected variant shown on listing | | `URL Sociolla` | Direct link to product detail page | | `Created At` | Date product was added to Sociolla | | `Active For Sociolla At` | Date product became active on platform | | `Review Stats` | Summary of customer ratings and review count | *** ### How to Use 1. **Find search URLs** — Go to Sociolla.com, perform a search (e.g., "lip tint"), and copy the result page URL including query parameters. 2. **Handle pagination** — For multi-page results, create separate URLs for each page (e.g., `&page=1`, `&page=2`). 3. **Set item limits** — Configure `max_items_per_url` (e.g., `200` to capture all products per page, or `50` for a sample). 4. **Enable fault tolerance** — Keep `ignore_url_failures: true` to skip any URLs that fail without stopping the entire run. 5. **Execute the scraper** — Start the actor and monitor progress in the run log. 6. **Export data** — Download results as JSON, CSV, or Excel for analysis in spreadsheet tools or databases. **Tips & best practices:** - **Exact searches:** Use specific keywords (e.g., `q=lip%20gloss`) for targeted results. - **Batch runs:** Paste 10–20 URLs at once for efficient, large-scale scraping. - **Variant tracking:** Use `Combinations` and `Price Range` fields to monitor multi-variant products. - **Regional comparison:** Combine Sociolla.com (Indonesia) and Sociolla VN (Vietnam) URLs to compare pricing across markets. *** ### Applications & Business Value - **Price intelligence:** Track competitor pricing, discounts, and promotional patterns in real-time - **Inventory monitoring:** Detect out-of-stock items and stock replenishment trends - **Market research:** Analyze product launches, best sellers, and seasonal trends in beauty - **Marketplace aggregation:** Build unified product feeds combining Sociolla and other beauty retailers - **Promotional analysis:** Identify BOGO, flashsale, and red carpet patterns to optimize your own strategy The Sociolla Products Scraper eliminates days of manual data collection, providing clean, machine-readable datasets that drive faster decision-making and competitive advantage. *** ### Conclusion The **Sociolla Products Scraper** delivers comprehensive beauty product data from one of Southeast Asia's leading e-commerce platforms. With 46+ fields covering pricing, availability, promotions, and platform-specific flags, it enables real-time market intelligence and competitive monitoring. Start scraping today to unlock actionable insights from Sociolla's vast product catalog. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the product search 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.sociolla.com/search?q=lip&page=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.sociolla.com/search?q=lip&page=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/sociolla-product-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.sociolla.com/search?q=lip&page=2"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/sociolla-product-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.sociolla.com/search?q=lip&page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/sociolla-product-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/sociolla-product-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/acts/0Ixcdsv7VOmzuzatl/builds/dUnhjS2M6m7QhIgIb/openapi.json