# Mohito Scraper (`trev0n/mohito-scraper`) Actor Fast and reliable scraper for extracting product data from Mohito.com (LPP Group fashion retailer). Uses Algolia API for lightning-fast data extraction - scrape 100+ products in under 1 second. - **URL**: https://apify.com/trev0n/mohito-scraper.md - **Developed by:** [Paweł](https://apify.com/trev0n) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $15.00/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## 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 ## Mohito Product Scraper An Apify Actor for scraping product data from Mohito.com (LPP Group). Extract comprehensive product information including prices, sizes, colors, images, ratings, and material composition. ### Features - **Rich Product Data** - Complete product information including sizes, colors, materials, and images - **Multi-Country Support** - Works with any Mohito country and language combination - **Advanced Filtering** - Filter by categories, subcategories, and product keywords - **Smart Deduplication** - Prevents duplicate products across multiple categories - **Detailed Mode** - Optional deep scraping for full product specifications - **Real-Time Data** - Get current prices and product availability - **REST API Mode** - On-demand product scraping via HTTP endpoints ### Input Configuration The actor accepts the following input parameters: | Parameter | Type | Description | Required | Default | |-----------|------|-------------|----------|---------| | `start_urls` | Array | Direct URLs to Mohito category/subcategory pages | Yes | - | | `category_filter` | Array | Filter by main categories (e.g., ["ubrania", "akcesoria"]) | No | [] | | `subcategory_filter` | Array | Filter by subcategories (e.g., ["kurtki-plaszcze", "sukienki"]) | No | [] | | `product_seo_keyword_filter` | Array | Filter by keywords in product URL | No | [] | | `deduplicate_across_all_start_urls` | Boolean | Remove duplicate products across all URLs | No | true | | `max_results` | Integer | Maximum products to scrape (0 = unlimited) | No | 100 | | `scrape_product_details` | Boolean | Visit each product page for full details | No | false | | `maxConcurrency` | Integer | Number of parallel requests (1-20) | No | 5 | | `maxRequestRetries` | Integer | Retry attempts for failed requests | No | 3 | | `proxyConfiguration` | Object | Proxy settings for the scraper | No | - | #### Important Notes About URLs - **Only category/subcategory URLs are supported** (e.g., `https://www.mohito.com/pl/pl/ubrania/kurtki-plaszcze`) - **Homepage URLs will NOT work** - always use direct category links #### Example Input - Basic Scraping ```json { "start_urls": [ { "url": "https://www.mohito.com/pl/pl/ubrania/kurtki-plaszcze" } ], "max_results": 50, "maxConcurrency": 5 } ```` #### Example Input - Multiple Categories ```json { "start_urls": [ { "url": "https://www.mohito.com/pl/pl/ubrania/kurtki-plaszcze" }, { "url": "https://www.mohito.com/pl/pl/ubrania/sukienki" } ], "deduplicate_across_all_start_urls": true, "max_results": 200 } ``` #### Example Input - With Product Details ```json { "start_urls": [ { "url": "https://www.mohito.com/pl/pl/ubrania/kurtki-plaszcze" } ], "scrape_product_details": true, "max_results": 50 } ``` #### Example Input - Multi-Country Scraping ```json { "start_urls": [ { "url": "https://www.mohito.com/pl/pl/ubrania/kurtki-plaszcze" }, { "url": "https://www.mohito.com/de/de/bekleidung/jacken-mantel" }, { "url": "https://www.mohito.com/cz/cz/obleceni/bundy-kabaty" } ], "max_results": 100 } ``` ### Output Format Each product contains comprehensive data: ```json { "sku": "709FH-99X", "brand": "Mohito", "name": "Puchowa kurtka", "price": 449.99, "currency": "PLN", "hasDiscount": false, "mainImage": "https://static.mohito.com/media/catalog/product/.../709FH-99X-001.jpg", "images": [ "https://static.mohito.com/media/catalog/product/.../709FH-99X-001.jpg", "https://static.mohito.com/media/catalog/product/.../709FH-99X-002.jpg" ], "color": "czarny", "colorVariants": ["czarny", "beżowy"], "sizes": ["32", "34", "36", "38", "40", "42", "44"], "rating": 4.5, "ratingCount": 10, "reviewCount": 9, "stickers": ["Naturalny puch", "Jakość premium"], "materials": [ "MATERIAŁ PIERWSZY: 100% POLIAMID", "WYPEŁNIENIE: 80% PUCH, 20% PIERZE", "PODSZEWKA: 100% POLIAMID" ], "productDescription": "Elegancka kurtka puchowa z kapturem...", "features": ["wysoki kołnierz", "zapięcie na zamek", "dwie kieszenie boczne"], "category": "ubrania", "subcategory": "kurtki-plaszcze", "website": "https://www.mohito.com", "categoryPage": "https://www.mohito.com/pl/pl/ubrania/kurtki-plaszcze", "productPage": "https://www.mohito.com/pl/pl/puchowa-kurtka-709fh-99x", "scrapedAt": "2025-01-15T10:30:00.000Z" } ``` ### Output Fields Reference #### Basic Product Information - `sku` - Product SKU/ID (e.g., "709FH-99X") - `brand` - Always "Mohito" - `name` - Product name #### Pricing - `price` - Current/final price - `currency` - Currency code (PLN, EUR, CZK, etc.) - `hasDiscount` - Boolean indicating if product is on sale - `originalPrice` - Original price before discount (if applicable) #### Images & Media - `mainImage` - Primary product image URL - `images` - Array of all product image URLs (available with `scrape_product_details: true`) #### Colors & Sizes - `color` - Main product color - `colorVariants` - Array of available colors (available with `scrape_product_details: true`) - `sizes` - Array of available sizes (available with `scrape_product_details: true`) #### Ratings & Reviews - `rating` - Average rating (0.0-5.0) or null - `ratingCount` - Number of ratings - `reviewCount` - Number of reviews #### Promotional Information - `stickers` - Array of promotional tags (e.g., "Bestseller", "NOWOŚĆ", "Naturalny puch") #### Product Details (with `scrape_product_details: true`) - `productDescription` - Full product description - `features` - Array of product features - `materials` - Array of material composition - `careInstructions` - Array of care instructions #### Metadata - `category` - Main category from URL (e.g., "ubrania") - `subcategory` - Subcategory from URL (e.g., "kurtki-plaszcze") - `website` - Always "https://www.mohito.com" - `categoryPage` - Source category page URL - `productPage` - Direct product page URL - `scrapedAt` - ISO 8601 timestamp #### Notes on Data Availability - All fields are always present in the output - Fields may be `null`, empty strings `""`, or empty arrays `[]` if data is not available - Full product details (sizes, materials, all images) require `scrape_product_details: true` ### Use Cases - **E-commerce Monitoring** - Track competitor pricing and product availability - **Price Intelligence** - Monitor price changes and discount patterns - **Market Research** - Analyze product trends across different countries - **Product Catalog** - Build comprehensive product databases - **Fashion Analytics** - Analyze clothing trends, colors, and sizes - **Multi-Market Strategy** - Compare offerings across different Mohito markets ### Supported Countries - Poland: `https://www.mohito.com/pl/pl/...` - Czech Republic: `https://www.mohito.com/cz/cz/...` - Slovakia: `https://www.mohito.com/sk/sk/...` - Hungary: `https://www.mohito.com/hu/hu/...` - Romania: `https://www.mohito.com/ro/ro/...` - Germany: `https://www.mohito.com/de/de/...` ### Best Practices - **Start with `scrape_product_details: false`** for quick data extraction - **Enable `scrape_product_details: true`** when you need sizes, materials, and all images - **Set reasonable `max_results`** to control run time - **Use proxies** for large-scale scraping to avoid rate limiting - **Only category URLs work** - Homepage URLs are not supported ### REST API Mode (Standby) The scraper supports an API mode for on-demand product scraping. When you run the Actor with empty `start_urls`, it starts an HTTP server that allows you to scrape individual products via API calls. #### Enabling API Mode Run the Actor with empty start URLs: ```json { "start_urls": [] } ``` #### API Endpoints | Endpoint | Method | Description | |----------|--------|-------------| | `/` | GET | API info and available endpoints | | `/health` | GET | Health check | | `/product?url=...` | GET | Scrape a single product | #### Example Usage **Health Check:** ```bash curl https://your-actor-standby-url/health ``` **Scrape Single Product:** ```bash curl "https://your-actor-standby-url/product?url=https://www.mohito.com/pl/pl/olowkowa-czarna-spodnica-mini-356gg-99x" ``` #### API Response Format ```json { "name": "Ołówkowa czarna spódnica mini", "price": 89.99, "currency": "PLN", "sku": "356GG-99X", "color": "czarna", "sizes": ["XS", "S", "M", "L", "XL"], "images": ["https://static.mohito.com/..."], "rating": 4.5, "ratingCount": 116, "stickers": ["Bestseller"], "brand": "Mohito", "productPage": "https://www.mohito.com/pl/pl/olowkowa-czarna-spodnica-mini-356gg-99x", "scrapedAt": "2025-01-15T10:30:00.000Z" } ``` #### Use Cases for API Mode - **Real-time Price Checking** - Get current product data on demand - **Integration with Other Systems** - Connect via HTTP for automated workflows - **Single Product Lookups** - When you don't need bulk scraping *** ### Related Actors Check out other scrapers from the same developer: - **[Sinsay Scraper](https://apify.com/trev0n/sinsay-scraper)** - Fast scraper for Sinsay.com product data (same LPP Group as Mohito) - **[Ceneo Product Scraper](https://apify.com/trev0n/ceneo-scraper)** - Extract product data and prices from Poland's largest price comparison website - **[Empik Product Search Scraper](https://apify.com/trev0n/empik-product-search-scraper)** - Scrape product listings from Empik.com search results and category pages - **[Empik Product Page Details Scraper](https://apify.com/trev0n/empik-product-page-details-scraper)** - Extract detailed product data from Empik.com product pages - **[Pracuj.pl Scraper](https://apify.com/trev0n/pracuj-pl-scraper)** - Scrape job listings from Poland's leading job portal *** ### Your Feedback We are always working to improve our scrapers. If you have any technical feedback or found a bug, please create an issue in the repository or contact us through Apify Console. # Actor input Schema ## `start_urls` (type: `array`): List of Mohito category/listing URLs to scrape. Leave empty to run in API-only mode (use /product endpoint). Must be category or subcategory pages (e.g., https://www.mohito.com/pl/pl/ubrania/kurtki-plaszcze). ## `category_filter` (type: `array`): Filter by main categories (e.g., \['ubrania', 'akcesoria', 'buty']). Leave empty to scrape all categories. ## `subcategory_filter` (type: `array`): Filter by subcategories (e.g., \['kurtki-plaszcze', 'sukienki', 'spodnice']). Leave empty to scrape all subcategories. ## `product_seo_keyword_filter` (type: `array`): Filter by product SEO keywords in URL (e.g., \['kurtka', 'sukienka']). Leave empty to scrape all products. ## `deduplicate_across_all_start_urls` (type: `boolean`): If true, prevents the same product from appearing multiple times when scraping multiple categories or URLs. ## `max_results` (type: `integer`): Maximum number of products to scrape. Set to 0 for unlimited. ## `scrape_product_details` (type: `boolean`): If true, visits each product page to extract detailed information (sizes, materials, description, all images). This is slower but provides more complete data. ## `maxConcurrency` (type: `integer`): Maximum number of pages to process in parallel. Higher values = faster scraping but more memory usage. Recommended: 3-5 for DOM scraping. ## `maxRequestRetries` (type: `integer`): How many times to retry failed requests. ## `proxyConfiguration` (type: `object`): Proxy settings to avoid blocking. Residential proxies recommended for best results. ## Actor input object example ```json { "start_urls": [ { "url": "https://www.mohito.com/pl/pl/ubrania/kurtki-plaszcze" } ], "category_filter": [], "subcategory_filter": [], "product_seo_keyword_filter": [], "deduplicate_across_all_start_urls": true, "max_results": 100, "scrape_product_details": false, "maxConcurrency": 5, "maxRequestRetries": 3, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `detailed` (type: `string`): No description ## `pricing` (type: `string`): No description # 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 = { "start_urls": [ { "url": "https://www.mohito.com/pl/pl/ubrania/kurtki-plaszcze" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("trev0n/mohito-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 = { "start_urls": [{ "url": "https://www.mohito.com/pl/pl/ubrania/kurtki-plaszcze" }] } # Run the Actor and wait for it to finish run = client.actor("trev0n/mohito-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 '{ "start_urls": [ { "url": "https://www.mohito.com/pl/pl/ubrania/kurtki-plaszcze" } ] }' | apify call trev0n/mohito-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=trev0n/mohito-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Mohito Scraper", "description": "Fast and reliable scraper for extracting product data from Mohito.com (LPP Group fashion retailer). Uses Algolia API for lightning-fast data extraction - scrape 100+ products in under 1 second.", "version": "1.0", "x-build-id": "kYSv1nSK7kCAe3KCj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trev0n~mohito-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trev0n-mohito-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/trev0n~mohito-scraper/runs": { "post": { "operationId": "runs-sync-trev0n-mohito-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/trev0n~mohito-scraper/run-sync": { "post": { "operationId": "run-sync-trev0n-mohito-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": { "start_urls": { "title": "Start URLs", "type": "array", "description": "List of Mohito category/listing URLs to scrape. Leave empty to run in API-only mode (use /product endpoint). Must be category or subcategory pages (e.g., https://www.mohito.com/pl/pl/ubrania/kurtki-plaszcze).", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "category_filter": { "title": "Category Filter", "type": "array", "description": "Filter by main categories (e.g., ['ubrania', 'akcesoria', 'buty']). Leave empty to scrape all categories.", "default": [], "items": { "type": "string" } }, "subcategory_filter": { "title": "Subcategory Filter", "type": "array", "description": "Filter by subcategories (e.g., ['kurtki-plaszcze', 'sukienki', 'spodnice']). Leave empty to scrape all subcategories.", "default": [], "items": { "type": "string" } }, "product_seo_keyword_filter": { "title": "Product Keyword Filter", "type": "array", "description": "Filter by product SEO keywords in URL (e.g., ['kurtka', 'sukienka']). Leave empty to scrape all products.", "default": [], "items": { "type": "string" } }, "deduplicate_across_all_start_urls": { "title": "Deduplicate Products", "type": "boolean", "description": "If true, prevents the same product from appearing multiple times when scraping multiple categories or URLs.", "default": true }, "max_results": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of products to scrape. Set to 0 for unlimited.", "default": 100 }, "scrape_product_details": { "title": "Scrape Product Details", "type": "boolean", "description": "If true, visits each product page to extract detailed information (sizes, materials, description, all images). This is slower but provides more complete data.", "default": false }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of pages to process in parallel. Higher values = faster scraping but more memory usage. Recommended: 3-5 for DOM scraping.", "default": 5 }, "maxRequestRetries": { "title": "Max Request Retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times to retry failed requests.", "default": 3 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings to avoid blocking. Residential proxies recommended for best results.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```