# Verkkokauppa Product Search Scraper (`stealth_mode/verkkokauppa-product-search-scraper`) Actor Scrape product listings from Verkkokauppa.com, Finland's largest electronics retailer. Extract prices, ratings, specifications, images, and inventory data from search results. Ideal for price monitoring, market research, and competitive intelligence in Nordic e-commerce. - **URL**: https://apify.com/stealth\_mode/verkkokauppa-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 ## Verkkokauppa.com Product Search Scraper: Extract Finnish Electronics & Retail Data ### Understanding Verkkokauppa.com and Its Market Position Verkkokauppa.com is Finland's leading online electronics and appliance retailer, offering over 60,000 products from computers to home electronics. The platform dominates the Finnish e-commerce market, making it essential for price comparison, inventory tracking, and competitive analysis in Nordic retail. This scraper processes search result pages, extracting product listings efficiently without needing individual product URLs. Perfect for monitoring pricing trends, tracking product availability, and analyzing competitor assortments across categories. ### What This Scraper Extracts The scraper captures comprehensive product data from search pages: **Product Identification:** ID (unique product identifier), Name (product title), Href (product page URL), and PIM Primary Category (product classification). **Pricing & Availability:** Price (current selling price), Max Amount Per Order (purchase limits), Active (availability status), Visible (display status). **Product Details:** Description Short (brief product summary), Bullet Points (key features), Articles (SKU/model numbers), Bundle Products (package contents if applicable). **Visual Assets:** Images (product photo URLs for display or analysis). **Quality Indicators:** Rating (customer review scores), Ribbons (promotional badges like "Sale" or "New"). **Compliance Data:** Age Limit (age restrictions), EPREL Data (EU energy label information for appliances). **Relationships:** Relations (linked products, accessories, or variants). **Target Users:** E-commerce businesses monitor competitor pricing and inventory. Price comparison platforms build product databases. Market researchers analyze Finnish retail trends. Retailers benchmark their offerings against Verkkokauppa's dominant position. ### Input Configuration The scraper processes Verkkokauppa.com search result URLs—pages showing multiple products after entering search terms or applying filters. **Example Configuration:** ```json { "urls": ["https://www.verkkokauppa.com/fi/search?query=laptop&pageNo=2"], "ignore_url_failures": true, "max_items_per_url": 50 } ```` **Parameter Guide:** **urls:** Array of search result page URLs. Include pagination (pageNo=2, pageNo=3) for multi-page extraction, or use different search queries (laptops, phones, TVs) to build comprehensive datasets. **ignore\_url\_failures:** Set `true` when scraping multiple URLs—failed pages won't stop the entire run. Essential for large-scale extraction where some pages may be temporarily unavailable. **max\_items\_per\_url:** Number of products to extract per page (default: 20, can go higher). Verkkokauppa typically shows 24 products per page; set to 50+ to capture full pages or enable automatic pagination. **Pro Tip:** Test search URLs manually first to verify filters return relevant products. Copy URLs directly from browser after applying desired filters (category, price range, brand). ### Output Structure and Field Definitions **Sample Output** ```json { "id": "976589", "active": true, "age_limit": 0, "articles": [ { "article_id": 260116, "eans": [ "0198155962851" ], "external_id": "976589", "href": "/fi/product/976589/Lenovo-IdeaCentre-Tower-poytakone-Windows-11-90XW002KMW", "images": [ { "orig": "https://cdn.verk.net/images/95/2_976589-1007x1705.jpeg" }, { "orig": "https://cdn.verk.net/images/89/2_976589-474x1703.jpeg" }, { "orig": "https://cdn.verk.net/images/92/2_976589-907x1704.jpeg" }, { "orig": "https://cdn.verk.net/images/98/2_976589-479x1704.jpeg" }, { "orig": "https://cdn.verk.net/images/1/2_976589-898x1691.jpeg" }, { "orig": "https://cdn.verk.net/images/4/2_976589-897x1690.jpeg" }, { "orig": "https://cdn.verk.net/images/7/2_976589-1020x1709.jpeg" }, { "orig": "https://cdn.verk.net/images/10/2_976589-937x1686.jpeg" }, { "orig": "https://cdn.verk.net/images/13/2_976589-1719x524.jpeg" }, { "orig": "https://cdn.verk.net/images/16/2_976589-1718x524.jpeg" }, { "orig": "https://cdn.verk.net/images/19/2_976589-1199x1714.jpeg" }, { "orig": "https://cdn.verk.net/images/25/2_976589-1239x1678.jpeg" }, { "orig": "https://cdn.verk.net/images/28/2_976589-1448x1671.jpeg" }, { "orig": "https://cdn.verk.net/images/31/2_976589-1426x1671.jpeg" }, { "orig": "https://cdn.verk.net/images/34/2_976589-887x1678.jpeg" }, { "orig": "https://cdn.verk.net/images/37/2_976589-1356x1739.jpeg" } ], "is_default_size": true, "name": "Lenovo IdeaCentre Tower pöytäkone, Windows 11 (90XW002KMW)", "package": { "width": 395, "height": 530, "depth": 195, "volume": 40823250, "weight": 4620 }, "price": { "current": 599, "current_formatted": "599,00", "current_taxless": 477.29, "original": 699.99, "original_formatted": "699,99", "original_taxless": 557.76, "discount_amount": 100.99, "discount_percentage": 14, "tax_rate": 25.5, "discount": { "id": 456740, "begin_at": "2026-03-02T06:00:00+02:00", "end_at": "2026-03-29T23:59:00+03:00", "name": "Erityishintainen kampanjatuote", "discount_type": 2 }, "unit": { "taxless": 0, "value": 0, "symbol": "" }, "previous30d_lowest_price": 699.99, "price_discount_visible": true }, "quantity": 1, "visible": 1 } ], "bullet_points": [ "Intel Core i5-13420H, 16 Gt, 1 Tt SSD", "Erittäin pienikokoinen pöytätietokone", "Wi-Fi 6, Bluetooth 5.2", "Monipuoliset liitännät" ], "bundle_products": [], "description_short": "Pieni ja tyylikäs tietokone, jolla hoidat kaikki päivän tehtäväsi sulavasti. Intel i5-12420H -suoritin, 16 Gt keskusmuisti ja 1 Tt tallennustila", "eprel_data": {}, "href": "/fi/product/976589/Lenovo-IdeaCentre-Tower-poytakone-Windows-11-90XW002KMW", "images": [ { "orig": "https://cdn.verk.net/images/15/2_976589-870x1200.jpg" }, { "orig": "https://cdn.verk.net/images/18/2_976589-242x553.jpg" }, { "orig": "https://cdn.verk.net/images/21/2_976589-859x1200.jpg" }, { "orig": "https://cdn.verk.net/images/24/2_976589-824x1200.jpg" }, { "orig": "https://cdn.verk.net/images/27/2_976589-825x1200.jpg" }, { "orig": "https://cdn.verk.net/images/98/2_976589-479x1704.jpeg" }, { "orig": "https://cdn.verk.net/images/13/2_976589-1719x524.jpeg" }, { "orig": "https://cdn.verk.net/images/16/2_976589-1718x524.jpeg" }, { "orig": "https://cdn.verk.net/images/28/2_976589-1448x1671.jpeg" }, { "orig": "https://cdn.verk.net/images/31/2_976589-1426x1671.jpeg" } ], "max_amount_per_order": 0, "name": "Lenovo IdeaCentre Tower pöytäkone, Windows 11 (90XW002KMW)", "pim_primary_category": "windows_desktops", "price": { "current": 599.99, "current_formatted": "599,99", "current_taxless": 478.08, "original": 699.99, "original_formatted": "699,99", "original_taxless": 557.76, "discount_amount": 100, "discount_percentage": 14, "tax_rate": 25.5, "discount": { "id": 468139, "begin_at": "2026-04-29T06:00:00+03:00", "end_at": "2026-05-31T23:59:00+03:00", "name": "Erityishintainen kampanjatuote", "discount_type": 2 }, "unit": { "taxless": 0, "value": 0, "symbol": "" }, "previous30d_lowest_price": 699.99, "price_discount_visible": true }, "rating": { "review_count": 10, "average_overall_rating": 4.7, "recommended_count": 0, "other": { "1": 5, "2": 5, "8": 4.8 } }, "relations": { "recommended": [], "newer": [], "older": [], "services": [], "installation_accessories": [], "bundles": [] }, "ribbons": [], "visible": 1, "from_url": "https://www.verkkokauppa.com/fi/catalog/desktops/poytatietokoneet" } ``` **ID:** Verkkokauppa's internal product identifier. **Use for:** Database primary keys, tracking products over time, linking to detailed product data. **Name:** Full product title as displayed. **Use for:** Search functionality, product categorization, keyword analysis. **Href:** Relative URL to product detail page. **Use for:** Constructing full URLs (`https://www.verkkokauppa.com` + href), accessing complete product information. **Price:** Current selling price (likely in EUR). **Use for:** Price monitoring, competitive analysis, historical pricing trends. **Active / Visible:** Boolean flags for availability and display status. **Use for:** Filtering in-stock products, identifying delisted items. **Rating:** Customer review score. **Use for:** Quality assessment, popularity indicators, competitive benchmarking. **Description Short:** Brief product summary. **Use for:** Quick product understanding, keyword extraction, listing previews. **Bullet Points:** Array of key features. **Use for:** Specification comparison, feature analysis, product differentiation. **Images:** Product photo URLs. **Use for:** Visual assets for price comparison sites, image-based product matching. **PIM Primary Category:** Product classification. **Use for:** Organizing products by department, category-level analysis. **Articles:** Model numbers or SKUs. **Use for:** Cross-platform product matching, manufacturer reference tracking. **Ribbons:** Promotional badges (e.g., "Sale", "New Arrival"). **Use for:** Identifying promotional activity, tracking marketing strategies. **Age Limit:** Age restrictions (for games, media). **Use for:** Compliance filtering, appropriate product recommendations. **EPREL Data:** EU energy efficiency information (for appliances). **Use for:** Environmental impact analysis, energy cost comparisons. **Bundle Products:** Package contents if sold as set. **Use for:** Understanding bundle offers, calculating value propositions. **Relations:** Related products or variants. **Use for:** Building product recommendation systems, identifying product families. **Max Amount Per Order:** Purchase quantity limits. **Use for:** Identifying high-demand or restricted items, inventory management insights. ### Implementation Guide **1. Build Search URLs:** Perform test searches on Verkkokauppa.com with your target categories/keywords. Copy URLs from browser, including pagination parameters for multi-page extraction. **2. Configure Input:** Create JSON with your URL list. Set `max_items_per_url` based on needs (20 for standard, 50+ for comprehensive). Enable `ignore_url_failures` for robustness. **3. Run Scraper:** Launch via Apify console. Monitor progress. Processing 5-10 search pages completes in 2-4 minutes typically. **4. Export Data:** Download in preferred format—JSON for databases, CSV for spreadsheets. Filter by Active/Visible flags to isolate available products. **5. Handle Pagination:** For extensive datasets, either include multiple pageNo URLs or set high `max_items_per_url` values to auto-paginate. ### Strategic Applications **Price Monitoring:** Track competitor pricing daily. Identify price changes, promotional periods, and pricing strategies across product categories. **Inventory Intelligence:** Monitor Active/Visible status to track stock availability. Identify frequently out-of-stock items signaling high demand. **Assortment Analysis:** Compare your product range against Verkkokauppa's dominant selection. Identify gaps or opportunities in category coverage. **Promotional Tracking:** Monitor Ribbons data to understand seasonal campaigns, discount patterns, and marketing strategies. **Energy Compliance:** Use EPREL data for environmental product comparisons, helping customers make informed sustainability choices. **Rating Analysis:** Track customer satisfaction trends. Correlate ratings with pricing to identify value-for-money leaders. ### Best Practices **Schedule Regular Scraping:** E-commerce pricing changes frequently. Daily scraping captures dynamic pricing, weekly for trend analysis. **Segment by Category:** Create separate scrapes per product category (laptops, phones, appliances) for cleaner, more analyzable datasets. **Enrich with Details:** Combine search data with detail page scraping for specifications, full descriptions, and complete images. **Quality Checks:** Validate that Price and Name fields are populated. Flag anomalies (zero prices, missing IDs) for review. **Respect Rate Limits:** Space out large scraping runs. Sustainable practices ensure continued data access. ### Conclusion The Verkkokauppa.com Product Search Scraper delivers actionable intelligence from Finland's e-commerce leader. Whether monitoring prices, analyzing market trends, or building comparison platforms, this tool provides the competitive edge needed in Nordic retail. Start extracting Finnish e-commerce insights today. # 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.verkkokauppa.com/fi/search?query=laptop&pageNo=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.verkkokauppa.com/fi/search?query=laptop&pageNo=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/verkkokauppa-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.verkkokauppa.com/fi/search?query=laptop&pageNo=2"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/verkkokauppa-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.verkkokauppa.com/fi/search?query=laptop&pageNo=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/verkkokauppa-product-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/verkkokauppa-product-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Verkkokauppa Product Search Scraper", "description": "Scrape product listings from Verkkokauppa.com, Finland's largest electronics retailer. Extract prices, ratings, specifications, images, and inventory data from search results. Ideal for price monitoring, market research, and competitive intelligence in Nordic e-commerce.", "version": "0.0", "x-build-id": "COXo9ZagokSB3pb7D" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~verkkokauppa-product-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-verkkokauppa-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~verkkokauppa-product-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-verkkokauppa-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~verkkokauppa-product-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-verkkokauppa-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 } } } } } } } } } } ```