# Falabella Product Search Scraper (`stealth_mode/falabella-product-search-scraper`) Actor Scrape product listings from Falabella.com with precision. Collect prices, specifications, ratings, seller info, and 30+ fields per product—perfect for price monitoring, competitor analysis, and market research across Falabella's extensive catalog. - **URL**: https://apify.com/stealth\_mode/falabella-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, 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 ## Falabella.com Product Scraper: Extract E-commerce Data at Scale --- ### About Falabella.com Falabella.com is one of Latin America's largest e-commerce platforms, offering millions of products across fashion, electronics, home goods, and more. The marketplace connects thousands of sellers and attracts millions of shoppers across Chile and the region. Extracting product data manually from category pages and search results is tedious and inefficient — the **Falabella Products Search Scraper** automates this, transforming product listings into clean, structured datasets ready for analysis or integration. --- ### Overview The **Falabella Products Search Scraper** extracts comprehensive product information from Falabella search and category pages, capturing both basic and advanced attributes. It is ideal for: - **E-commerce analysts** tracking pricing trends and product availability - **Price comparison platforms** aggregating data from multiple sellers - **Market researchers** studying product offerings and competitive landscapes - **Retailers** monitoring competitor inventory and positioning - **Data engineers** feeding product catalogs into data warehouses Key advantages include flexible pagination support, batch item collection per page, and robust error handling for large-scale runs. --- ### Input Format The scraper accepts a JSON configuration object: ```json { "urls": [ "https://www.falabella.com/falabella-cl/category/cat5880085/Mochilas-mujer?page=2" ], "max_items_per_url": 200, "ignore_url_failures": true } ```` #### Input Parameters Explained | Parameter | Type | Description | |---|---|---| | `urls` | Array | List of Falabella product search or category page URLs to scrape. Examples: category pages, search result pages with filters, or specific product list URLs. One URL typically contains 20–50 products. | | `max_items_per_url` | Integer | Maximum number of product items to extract per URL. Default: `20`; recommended: `200` for comprehensive collection. This prevents excessive data collection and API overload. | | `ignore_url_failures` | Boolean | If `true`, the scraper continues if individual URLs fail; if `false`, the entire run stops on first failure. Set to `true` for bulk operations to ensure resilience. | **Example URL types:** - Category page: `https://www.falabella.com/falabella-cl/category/cat5880085/Mochilas-mujer` - Paginated category: `https://www.falabella.com/falabella-cl/category/cat5880085/Mochilas-mujer?page=2` - Search results: `https://www.falabella.com/falabella-cl/search?query=laptop` > **Tip:** Extract URLs directly from Falabella's website by browsing to the desired category or search, then copy the page URL into the `urls` array. *** ### Output Format **Sample output** ```json { "product_id": "138885306", "sku_id": "138885307", "top_specifications": [], "display_name": "Mochila Travel Cabin Noir Essentials", "product_type": "REGULAR", "view_template": "NORMAL", "url": "https://www.falabella.com/falabella-cl/product/138885306/backpack-travel-cabin-noir-bubba-essentials", "brand": "BUBBA", "media": { "id": "138885307", "type": "PRODUCT", "on_image_hover": "FETCH_SECOND_IMAGE" }, "media_urls": [ "https://media.falabella.com/falabellaCL/138885307_01/public", "https://media.falabella.com/falabellaCL/138885307_02/public", "https://media.falabella.com/falabellaCL/138885307_03/public", "https://media.falabella.com/falabellaCL/138885307_04/public", "https://media.falabella.com/falabellaCL/138885307_05/public" ], "measurements": {}, "discount_badge": { "label": "-38%", "styles": { "background_color": "#EB0029", "text_color": "#ffffff" } }, "badges": [ { "position": 1, "label": "Cyber Day", "styles": { "background_color": "#333333", "text_color": "#ffffff" } } ], "multipurpose_badges": [], "meat_stickers": [ { "label": "Cyber Day", "type": "event", "styles": { "background_color": "#333333", "text_color": "#ffffff" } } ], "prices": [ { "label": "", "icons": "", "symbol": "$ ", "type": "eventPrice", "crossed": false, "price": [ "49.990" ] }, { "label": "", "icons": "", "symbol": "$ ", "type": "normalPrice", "crossed": true, "price": [ "79.990" ] } ], "total_reviews": "16", "rating": "4.5", "availability": { "home_delivery_shipping": "", "pick_up_from_store_shipping": "", "international_shipping": "", "prime_shipping": "", "express_shipping": "" }, "variants": [ { "type": "COLOR", "options": [ { "label": "Negro", "url": "https://www.falabella.com/falabella-cl/product/138885306/backpack-travel-cabin-noir-bubba-essentials/138885307", "value": "000000", "extra_info": "138885307", "media_id": "138885307", "selected": true, "sizes": [ { "value": "TALLA ÚNICA", "size_order": 0, "available": true, "variant": "138885307", "prices": [ { "label": "", "icons": "", "symbol": "$ ", "crossed": false, "price": [ "49.990" ] }, { "label": "", "icons": "", "symbol": "$ ", "crossed": true, "price": [ "79.990" ] } ], "offering_id": "138885307", "media_urls": [ "https://media.falabella.com/falabellaCL/138885307_01/public", "https://media.falabella.com/falabellaCL/138885307_02/public", "https://media.falabella.com/falabellaCL/138885307_03/public", "https://media.falabella.com/falabellaCL/138885307_04/public", "https://media.falabella.com/falabellaCL/138885307_05/public" ] } ], "is_purchaseable": true, "variant": "138885307", "offering_id": "138885307", "media_urls": [ "https://media.falabella.com/falabellaCL/138885307_01/public", "https://media.falabella.com/falabellaCL/138885307_02/public", "https://media.falabella.com/falabellaCL/138885307_03/public", "https://media.falabella.com/falabellaCL/138885307_04/public", "https://media.falabella.com/falabellaCL/138885307_05/public" ] } ] }, { "type": "SIZES", "options": [] } ], "seller_id": "SC58F9D", "seller_name": "BUBBA BAGS", "offering_id": "138885307", "is_best_seller": false, "is_sponsored": true, "mabaya_ad_info": "TWZALgoQBqHwoLwQfx-vBAtAaK4IERIQAZ5ggcN5diKNwFhtTSdnPBoQAZosAAm4csGuWggGR9i64yINCgkxMzg4ODUzMDYQATCfwndIAVCh_PzJ6DNgowRyEAAAAAAAAAAAAAAAAAAAAAB4AoUBAADgQA", "ad_identifier": "TWZALgoQBqHwoLwQfx-vBAtAaK4IERIQAZ5ggcN5diKNwFhtTSdnPBoQAZosAAm4csGuWggGR9i64yINCgkxMzg4ODUzMDYQATCfwndIAVCh_PzJ6DNgowRyEAAAAAAAAAAAAAAAAAAAAAB4AoUBAADgQA", "gsc_category_id": null, "promotions": [], "installments_without_interest": [], "from_url": "https://www.falabella.com/falabella-cl/category/cat5880085/Mochilas-mujer?ajax=true" } ``` Each scraped product returns a rich record with 30+ fields capturing pricing, inventory, reviews, seller data, and metadata: #### Product Identification | Field | Meaning | |---|---| | `Product ID` | Unique identifier assigned by Falabella to the product | | `SKU ID` | Stock Keeping Unit; internal SKU code for inventory management | | `Display Name` | Official product name shown to customers | | `Product Type` | Category classification (e.g., backpack, shoe, accessory) | | `URL` | Direct link to the product detail page | #### Specifications & Details | Field | Meaning | |---|---| | `Top Specifications` | Key features highlighted (e.g., material, capacity, color) | | `View Template` | Product presentation format (e.g., list view, grid view) | | `Brand` | Manufacturer or brand name | | `Measurements` | Physical dimensions and weight (if available) | #### Media & Visual Content | Field | Meaning | |---|---| | `Media` | Embedded product images and videos | | `Media URLs` | Direct URLs to product photos for integration into your platform | #### Pricing & Promotions | Field | Meaning | |---|---| | `Prices` | Current retail and discounted prices in local currency | | `Discount Badge` | Percentage or amount of discount displayed (e.g., "-30%") | | `Badges` | Additional promotion labels (e.g., "Flash Sale", "Hot Deal") | | `Multipurpose Badges` | Special tags (e.g., "Free Shipping", "Clearance") | | `Meat Stickers` | Promotional stickers or urgency markers (e.g., "Limited Stock") | | `Promotions` | Active promotional campaigns and offers | | `Installments Without Interest` | Financing options available for the product | #### Customer Feedback | Field | Meaning | |---|---| | `Total Reviews` | Number of customer reviews received | | `Rating` | Average customer rating (typically 1–5 stars) | #### Inventory & Availability | Field | Meaning | |---|---| | `Availability` | Stock status (In Stock, Out of Stock, Pre-order, etc.) | | `Variants` | Product variations (size, color, model options) with availability per variant | #### Seller Information | Field | Meaning | |---|---| | `Seller ID` | Unique identifier for the seller/merchant | | `Seller Name` | Business name of the seller | | `Offering ID` | Unique ID for this seller's specific product offering | | `Is Best Seller` | Boolean flag indicating if seller has "Best Seller" status | | `Is Sponsored` | Whether this listing has paid promotion/sponsorship | #### Advertising & Categorization | Field | Meaning | |---|---| | `Mabaya Ad Info` | Advertising metadata for paid promotions | | `Ad Identifier` | Unique ID for the ad campaign (if applicable) | | `GSC Category ID` | Google Search Console category classification | *** ### How to Use 1. **Identify target URLs** — Navigate to Falabella.com and locate product category or search pages you want to scrape. For example: women's backpacks, electronics, or filtered search results. 2. **Copy URLs** — Open each target page and copy the full URL (including pagination, filters, and query parameters). Paste them into the `urls` array, one per entry. 3. **Configure parameters** — Set `max_items_per_url` to the desired limit (e.g., `200` for bulk collection, `20` for quick previews). Keep `ignore_url_failures: true` for resilience. 4. **Run the scraper** — Start the actor and monitor progress in the run log. The scraper will process each URL and collect products. 5. **Export results** — Download output in JSON, CSV, or Excel format. Use the data for analysis, pricing tracking, or platform integration. **Best practices:** - Use 1–5 URLs per run for initial testing before scaling to bulk operations. - For category pages with 100+ products, increase `max_items_per_url` to capture more. - Test URLs individually first to verify they contain expected products before batch processing. **Handling common issues:** - If a URL returns fewer items than specified, the page may have fewer products or pagination limits. - Ensure URLs point to valid product search/category pages, not individual product detail pages. - Use `ignore_url_failures: true` when running multiple URLs to avoid interruptions. *** ### Use Cases & Business Value - **Price monitoring:** Track competitor pricing and discount trends over time by re-running the scraper weekly or monthly. - **Inventory analysis:** Monitor stock availability across sellers to identify supply gaps or opportunities. - **Product research:** Analyze specifications, features, and ratings to inform product sourcing decisions. - **Competitor benchmarking:** Compare your product listings with Falabella offerings in terms of pricing, features, and reviews. - **Market intelligence:** Study product demand signals through review counts, ratings, and promotional activity. - **Data aggregation:** Feed Falabella products into your own e-commerce platform or comparison engine. The scraper delivers ready-to-use data in standardized formats, eliminating the need for manual extraction and significantly reducing research time. *** ### Conclusion The **Falabella Products Search Scraper** is a powerful tool for anyone needing structured e-commerce product data. With 30+ fields capturing pricing, reviews, seller details, and inventory status, it provides the insights necessary for competitive analysis, market research, and business intelligence. Deploy it today to unlock actionable data from one of Latin America's largest marketplaces. # 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.falabella.com/falabella-cl/category/cat5880085/Mochilas-mujer?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.falabella.com/falabella-cl/category/cat5880085/Mochilas-mujer?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/falabella-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.falabella.com/falabella-cl/category/cat5880085/Mochilas-mujer?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/falabella-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.falabella.com/falabella-cl/category/cat5880085/Mochilas-mujer?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/falabella-product-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/falabella-product-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Falabella Product Search Scraper", "description": "Scrape product listings from Falabella.com with precision. Collect prices, specifications, ratings, seller info, and 30+ fields per product—perfect for price monitoring, competitor analysis, and market research across Falabella's extensive catalog.", "version": "0.0", "x-build-id": "9UduBZAvOXsZUiIIA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~falabella-product-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-falabella-product-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~falabella-product-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-falabella-product-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~falabella-product-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-falabella-product-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 product search list urls to scrape", "type": "array", "description": "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.", "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 } } } } } } } } } } ```