# Huuto Product Search Scraper (`stealth_mode/huuto-product-search-scraper`) Actor Scrape product listings from Huuto.net, Finland's largest online marketplace. Collect seller details, pricing, delivery methods, bid history, and 40+ data fields per item — perfect for market researchers, price aggregators, and competitive intelligence. - **URL**: https://apify.com/stealth\_mode/huuto-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 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 ## Huuto.net Product Search Scraper: Extract Finnish Marketplace Listings --- ### What Is Huuto.net? Huuto.net is Finland's premier online auction and marketplace platform, hosting hundreds of thousands of product listings across categories like vehicles, electronics, collectibles, and more. With dynamic pricing, seller ratings, and regional delivery options, the platform generates valuable market data. Manually extracting this information is tedious — the **Huuto.net Product Search Scraper** automates the process, delivering clean, structured product records in seconds. --- ### Overview The **Huuto.net Product Search Scraper** extracts product listings from Huuto.net search results pages, converting unstructured marketplace data into a machine-readable format. It is ideal for: - **Price aggregators** building datasets across product categories - **Market researchers** analyzing Finnish e-commerce trends - **Competitive intelligence teams** tracking competitor inventory - **Data analysts** studying auction dynamics and seller behavior - **E-commerce platforms** integrating Huuto listings for comparison The scraper handles pagination automatically, respects rate limits, and includes robust error handling via `ignore_url_failures`. With support for up to 200 items per URL and flexible category targeting, it scales from small research projects to large-scale data collection. --- ### Input Format The scraper accepts a JSON configuration object with the following parameters: ```json { "urls": [ "https://www.huuto.net/osasto/ajoneuvot/1?page=2" ], "ignore_url_failures": true, "max_items_per_url": 200 } ```` | Parameter | Type | Description | |---|---|---| | `urls` | Array | List of Huuto.net search result URLs. Each URL typically targets a specific category and page number (e.g., vehicles/ajoneuvot). Paste full URLs with query parameters intact. | | `ignore_url_failures` | Boolean | If `true`, the scraper skips failed or blocked URLs and continues processing. Recommended for bulk runs to prevent interruptions. | | `max_items_per_url` | Integer | Maximum number of products to extract per URL (1–200). Set lower values for quick previews; use 200 for comprehensive category exports. | *** ### Output Format **Sample output** ```json { "seller": "myyja", "category_name": "Draama ja romantiikka", "sellernro": "62483", "startprice": null, "municipality_name": "Vantaa", "payment_methods": [ 1, 2, 3 ], "sellstyle": "3", "minfbvalue": "-1", "is_adult_content": false, "currprice": "1.00", "id": "640689855", "weekly_view_count": 0, "images": [ { "thumbnail": "https://images.huuto.net/v1/d8c7/7b290f8b7520299bc3322a235bd/537748272-s.jpg", "original": "https://images.huuto.net/v1/d8c7/7b290f8b7520299bc3322a235bd/537748272-orig.jpg", "id": 537748272, "medium": "https://images.huuto.net/v1/d8c7/7b290f8b7520299bc3322a235bd/537748272-m.jpg" }, { "thumbnail": "https://images.huuto.net/v1/f235/742729d569ab93e1b14b4503520/537748289-s.jpg", "original": "https://images.huuto.net/v1/f235/742729d569ab93e1b14b4503520/537748289-orig.jpg", "id": 537748289, "medium": "https://images.huuto.net/v1/f235/742729d569ab93e1b14b4503520/537748289-m.jpg" } ], "gallerylist_ts": null, "offers_allowed": "0", "listtime": "1774441890", "classification": "3", "maingallery_ts": null, "requireauth": "n", "zipcode": "01300", "seller_company_name": "", "republish": "0", "seller_user_type": "0", "main_category_name": "Elokuvat", "favourite_count": 0, "vas_gallerylist": "0", "status": "N", "reserve_price": null, "htur_package_code": null, "closingtime": "1784782800", "region_name": "Uusimaa", "purchase_id": null, "title": "Blue Car", "sitemap_partition": 55, "cat_id": "90", "cat_path": [ 86, 87, 90 ], "delivery_methods": [ 2 ], "quantity": 2, "is_huutoturva": false, "seller_delivery_price": null, "increase": null, "section_category_name": "DVD", "deliveryprice": 3, "addtime": "1774441878", "suggestions": [ { "input": "blue", "weight": 3 }, { "input": "car", "weight": 3 }, { "input": "blue car", "weight": 3 }, { "input": "tekstitys", "weight": 1 }, { "input": "suomeksi", "weight": 1 }, { "input": "on", "weight": 1 }, { "input": "leffat", "weight": 1 }, { "input": "1-2", "weight": 1 }, { "input": "lasten", "weight": 1 }, { "input": "1-3", "weight": 1 }, { "input": "postikulut", "weight": 1 }, { "input": "elokuvaa", "weight": 1 }, { "input": "yhdella", "weight": 1 }, { "input": "postimaksulla", "weight": 1 }, { "input": "3-4", "weight": 1 }, { "input": "kahdessa", "weight": 1 }, { "input": "kuoressa", "weight": 1 }, { "input": "pahvikoteloisia", "weight": 1 }, { "input": "leffoja", "weight": 1 }, { "input": "ei", "weight": 1 }, { "input": "voi", "weight": 1 }, { "input": "lahettaa", "weight": 1 }, { "input": "yhdessa", "weight": 1 }, { "input": "toisen", "weight": 1 }, { "input": "dvd", "weight": 1 }, { "input": "kanssa", "weight": 1 }, { "input": "kuluilla", "weight": 1 }, { "input": "ylittaa", "weight": 1 }, { "input": "painorajan", "weight": 1 }, { "input": "jos", "weight": 1 }, { "input": "ostat", "weight": 1 }, { "input": "enemman", "weight": 1 }, { "input": "kuin", "weight": 1 }, { "input": "nelja", "weight": 1 }, { "input": "lahetykset", "weight": 1 }, { "input": "matkahuollon", "weight": 1 }, { "input": "pakettihinnaston", "weight": 1 }, { "input": "mukaan", "weight": 1 }, { "input": "s-paketti", "weight": 1 }, { "input": "85", "weight": 1 } ], "location": "VANTAA", "numofbids": "0", "view_count": 8, "vacation_hidden": null, "score": 166.21411, "from_url": "https://www.huuto.net/haku?q=car" } ``` Each product returns a rich record with 40+ fields covering seller details, pricing, condition, delivery, and engagement metrics: #### Product Identification | Field | Meaning | |---|---| | `ID` | Unique product identifier on Huuto.net | | `Title` | Product name/title as listed | | `Category ID` | Numeric code for the main product category | | `Main Category Name` | Primary category (e.g., "Vehicles", "Electronics") | | `Category Name` | Subcategory name for finer classification | | `Section Category Name` | Section-level categorization | | `Category Path` | Full hierarchical category path | | `Classification` | Additional product classification or type | #### Seller Information | Field | Meaning | |---|---| | `Seller` | Seller username or display name | | `Seller Number` | Numeric ID assigned to the seller account | | `Seller Company Name` | Company name if seller is a business | | `Seller User Type` | Account type (individual, business, or dealer) | | `Seller Delivery Price` | Base shipping cost set by the seller | #### Pricing & Bidding | Field | Meaning | |---|---| | `Start Price` | Initial/opening bid price in EUR | | `Current Price` | Highest bid or current listing price | | `Reserve Price` | Minimum acceptable price (hidden from bidders if set) | | `Number Of Bids` | Count of bids received | | `Increase` | Minimum bid increment in EUR | #### Dates & Timeline | Field | Meaning | |---|---| | `List Time` | When the auction started | | `Closing Time` | When the auction ends or ended | | `Add Time` | When the listing was created/added | | `Gallery List TS` | Timestamp for gallery image availability | | `Main Gallery TS` | Timestamp of primary listing image | #### Product Details | Field | Meaning | |---|---| | `Quantity` | Number of items available | | `Location` | Geographic location of the item | | `Municipality Name` | Finnish municipality where item is located | | `Region Name` | Regional area of Finland | | `Zip Code` | Postal code of the item's location | | `Images` | List of product image URLs | #### Engagement & Statistics | Field | Meaning | |---|---| | `View Count` | Total lifetime views of the listing | | `Weekly View Count` | Views in the past 7 days | | `Favourite Count` | Number of users who favorited the listing | | `Score` | Seller reputation score (0–5 stars) | #### Delivery & Payment | Field | Meaning | |---|---| | `Delivery Methods` | Available shipping options (pickup, courier, mail, etc.) | | `Delivery Price` | Shipping cost to buyer | | `Payment Methods` | Accepted payment types (bank transfer, card, Huuto escrow, etc.) | #### Seller Protection & Features | Field | Meaning | |---|---| | `Is Huutoturva` | Whether Huuto's buyer protection (Huutoturva) is active | | `Is Adult Content` | Age-restricted content flag | | `Require Auth` | Whether authentication is required to view/bid | | `Offers Allowed` | Whether make-an-offer functionality is enabled | | `Min FB Value` | Minimum feedback score required to bid | | `VAS Gallery List` | Premium gallery/listing upgrade status | | `HTur Package Code` | Huuto package/promotion code applied | #### Listing Status | Field | Meaning | |---|---| | `Status` | Current state (active, sold, unsold, closed, relisted, etc.) | | `Republish` | Count of times the listing was reposted | | `Vacation Hidden` | Whether listing is hidden due to seller vacation mode | | `Sitemap Partition` | Internal indexing partition ID | | `Purchase ID` | Transaction/purchase identifier if sold | | `Suggestions` | Recommended related products | *** ### How to Use 1. **Find your target URLs** — Navigate to Huuto.net, select a category, and copy the search results page URL (including `?page=X` if needed). 2. **Build your input configuration** — Populate the `urls` array with one or more Huuto URLs. For example: ```json { "urls": [ "https://www.huuto.net/osasto/ajoneuvot/1", "https://www.huuto.net/osasto/ajoneuvot/1?page=2" ], "max_items_per_url": 200, "ignore_url_failures": true } ``` 3. **Set collection parameters** — Adjust `max_items_per_url` based on your needs (use `200` for complete category exports, lower values for testing). 4. **Run the scraper** — Start the actor and monitor progress in the console. 5. **Export data** — Download results as JSON, CSV, or Excel for analysis in spreadsheets or databases. **Best practices:** - Use `ignore_url_failures: true` for bulk runs to prevent stalling on temporary blocks. - Spread scraping across multiple time slots to avoid rate limiting. - Export data immediately after runs to preserve any time-sensitive fields (e.g., `Closing Time`). *** ### Use Cases & Business Value - **Price intelligence:** Build historical pricing datasets across product categories to spot trends - **Seller analytics:** Monitor competitor inventory, listing frequency, and pricing strategies - **Market research:** Analyze which products sell fastest, geographic demand, and shipping preferences - **Aggregator platforms:** Feed Huuto listings into multi-marketplace price comparison tools - **Fraud detection:** Track suspicious seller patterns or unusual bid activity The Huuto.net Product Search Scraper transforms time-consuming manual research into seconds of automated data collection, enabling data-driven decision-making in e-commerce. *** ### Conclusion The **Huuto.net Product Search Scraper** is a powerful tool for anyone needing structured marketplace data from Finland's largest auction platform. With 40+ data fields per product and flexible configuration, it unlocks insights into pricing, demand, seller behavior, and market trends. Start scraping today and gain the competitive advantage of real-time market intelligence. # 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.huuto.net/osasto/ajoneuvot/1?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.huuto.net/osasto/ajoneuvot/1?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/huuto-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.huuto.net/osasto/ajoneuvot/1?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/huuto-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.huuto.net/osasto/ajoneuvot/1?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/huuto-product-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/huuto-product-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Huuto Product Search Scraper", "description": "Scrape product listings from Huuto.net, Finland's largest online marketplace. Collect seller details, pricing, delivery methods, bid history, and 40+ data fields per item — perfect for market researchers, price aggregators, and competitive intelligence.", "version": "0.0", "x-build-id": "f9uUKGiJbVcIZ5cxR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~huuto-product-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-huuto-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~huuto-product-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-huuto-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~huuto-product-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-huuto-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 } } } } } } } } } } ```