Huutokaupat Product Search Scraper: Extract Auction Data at Scale

---

What Is Huutokaupat?

Huutokaupat.com is Finland's largest online auction marketplace, hosting thousands of daily listings across categories like vehicles, electronics, collectibles, and real estate. Whether you're tracking market prices, analyzing competitor inventory, or researching buying trends, manually extracting this data is impractical. The Huutokaupat Product Search Scraper automates the extraction, turning auction listings into clean, queryable datasets.

---

Overview

The Huutokaupat Product Search Scraper extracts auction items from search results pages, capturing comprehensive product metadata including auction status, bidding details, seller information, and location data. It is ideal for:

• Price researchers tracking market values across product categories
• Resellers & dealers monitoring competitor listings and inventory
• Market analysts studying auction trends and demand patterns
• Data aggregators building multi-source product databases
• Business intelligence teams feeding data into analytics platforms

Key strengths include high item limits per search page (up to 200), robust error handling with ignore_url_failures, and detailed auction metadata covering pricing, bids, and bidder statistics.

---

Input Format

The Actor supports two scraping modes — use only one at a time:

1. Scrape by URLs — scrape data directly from a list of Huutokaupat search result URLs.

{
  "urls": [
    "https://huutokaupat.com/en/haku?term=car&sivu=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}

2. Scrape by search filters — scrape data using a keyword and additional filters (sorting, condition, end time, etc.) instead of providing URLs.

{
  "keyword": "a",
  "sort_by": "osuvimmat",
  "condition": "kaytetyt",
  "end_within": "72",
  "page": 1,
  "max_items_per_url": 200
}

There is also a General settings group that applies to both modes.

1. Scrape by URLs

Use this mode when you already have specific search result URLs. When this mode is used, all options in the "Scrape by search filters" section will be disabled.

Field	Type	Default	Description
urls	array	(required)	One or more Huutokaupat search result page URLs to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. Include query parameters like term= (search term) and sivu= (page number).
ignore_url_failures	boolean	true	If true, the scraper continues running if a page fails to load instead of halting the entire run.

Tip: Use pagination (sivu=1, sivu=2, etc.) to scrape multiple pages of the same search. Each search term can yield hundreds of active auctions.

2. Scrape by search filters

Use this mode when you want to search using a keyword and additional filter attributes instead of scraping by URLs. If you use this mode, leave the urls field above empty.

Field	Type	Default	Description
keyword	string	—	The keyword to search for.
sort_by	string (paattyvat, osuvimmat, uusimmat, katsotuimmat, halvimmat, kalleimmat)	—	Sort results by Ending soonest, Most relevant first, Newest first, Most interesting first, Lowest price first, or Highest price first.
condition	string ("", kaytetyt, uudet, korjattavaksi)	—	Item condition filter: All (empty), Used, New, Sold for listing.
end_within	string ("", 1, 24, 72)	—	Filter by auction end time: All (empty), 1 day, 1 week, 2 weeks.
page	integer	—	The page number to start scraping from.

3. General settings

Applies to both scraping modes above.

Field	Type	Default	Description
max_items_per_url	integer	20 (max: 200)	The maximum number of items to extract per URL/search page.

---

Output Format

Sample output

{
  "id": 6364876,
  "title": "Toyota Corolla, 2007",
  "subtitle": "1.4 l, Diesel, 66 kW, Automaatti, 352385 km",
  "description": "<p>-Hyvät kesärenkaat etu 9mm ja taka7mm</p><p>-Hyvät nastarenkaat 9mm pintaa!</p><p>-Automaatti ilmastointi (ei puhalla kylmää)</p><p>-Vetokoukku</p><p>-Jälkiasennettu näyttösoitin</p><p>-Jälkiasennettu peruutuskamera</p><p><br /></p><p><br /></p><p><strong>Tekniset tiedot</strong><br />Teho: <strong>66 kW</strong><br /> CO2-päästöt: <strong>127 g/km</strong><br /> Omamassa <strong>1355 kg</strong><br /><br /><strong>Lisätiedot</strong><br />Katsastus voimassa: <strong>8/2026</strong></p>",
  "class_name": null,
  "city": "Vaasa",
  "zip_code": "65300",
  "region": "15",
  "photo_url": "https://kuvat.huutokaupat.com/ZegJAG5-bhdtt4WJEFm5O4J7ivPzTXFbu7uwxVCaM64/gravity:sm/resize:fit:300:300/czM6Ly9odXV0b2th/dXBhdC1wcm9kLWNk/bi9yZXNvdXJjZXMv/MDE5ZWFiYmQtZGQx/My03M2IwLWFjMjQt/ODQzOTc2NzBkZjMz.jpeg",
  "photo_large_url": "https://kuvat.huutokaupat.com/uKiOHwkj41kmO3ZhuDVFt77HW1drAdmRZ_Fv3C7ihfI/gravity:sm/resize:fit:1600:1600/watermark:0.8:soea:15:5/czM6Ly9odXV0b2th/dXBhdC1wcm9kLWNk/bi9yZXNvdXJjZXMv/MDE5ZWFiYmQtZGQx/My03M2IwLWFjMjQt/ODQzOTc2NzBkZjMz.jpeg",
  "photo_path": "resources/019eabbd-dd13-73b0-ac24-84397670df33",
  "photo_rotation": null,
  "slug": "toyota-corolla-2007",
  "company_id": 7094,
  "company_name": "Prestige Car Center",
  "company_slug": "oy-prestige-consulting-ab",
  "class_id": "Nettihuutokauppa",
  "category_id": 14,
  "category_name": "Henkilöautot",
  "parent_category_id": 2,
  "created_at": "2026-06-09T12:30:44+03:00",
  "updated_at": "2026-06-18T15:00:43+03:00",
  "auction_start": "2026-06-18T15:00:00+03:00",
  "auction_end": "2026-06-21T20:00:00+03:00",
  "original_auction_end": "2026-06-21T20:00:00+03:00",
  "is_cancelled": false,
  "continuous_auction": false,
  "start_price": {
    "amount": 0,
    "vat_percent": 0
  },
  "has_been_bidded": true,
  "bidding_ended": false,
  "bid_count": 12,
  "bidder_count": 6,
  "highest_bid": {
    "amount": 265,
    "vat_percent": 0
  },
  "is_sold_to_highest_bidder": true,
  "is_new": false,
  "view_count": 630,
  "order": 1,
  "minimum_bid_with_vat": 10,
  "minimum_bid_without_vat": 10,
  "metadata": {
    "category": "PassengerCar",
    "base_category": null,
    "registration_status": "1",
    "license_number": "NHE-737",
    "not_registered_reason": null,
    "vehicle_insurance": "1",
    "vin": "JTNBC56E102009399",
    "inspection_status": "1",
    "next_inspection": "8/2026",
    "inspection_fail_reason": null,
    "manufacturer": "Toyota",
    "model": "Corolla",
    "year_model": 2007,
    "commissioning_date": "8/2007",
    "sold_for_fixing": 0,
    "odometer": 352385,
    "fuel_type": "2",
    "engine_displacement": "1.4",
    "drive": "1",
    "transmission": "2",
    "maintenance_book": "1",
    "maintenance_book_description": "Huoltokirjasta kuvat ilmoituksessa.",
    "licensed_twice": "0",
    "licensed_twice_reason": null,
    "withdrawn_from_traffic": null,
    "taxes_overdue": "0",
    "taxes_overdue_amount": null,
    "amount_of_keys": 1,
    "faulty_key_remote": "1",
    "faulty_key_remote_description": null,
    "faulty_windshield": "1",
    "faulty_windshield_description": "Tuulilasissa halkeama KATSO KUVAT!",
    "contains_summer_tires": "1",
    "are_summer_tires_legal": "1",
    "contains_winter_tires": "1",
    "are_winter_tires_legal": "1",
    "faulty_exterior": "1",
    "faulty_exterior_description": "KATSO KUVAT!",
    "faulty_interior": "0",
    "faulty_interior_description": null,
    "warning_indicator": "0",
    "warning_indicator_description": null,
    "additional_fees": null,
    "additional_fees_description": null,
    "is_imported": "0",
    "is_import_tax_paid": null,
    "imported_tax_estimate": null,
    "imported_from": null,
    "is_special_vehicle": false,
    "previous_license_number": null,
    "parts_replaced_percent": null,
    "power": 66,
    "power_type": "kW",
    "no_road_permit": null,
    "emission_manipulation": false,
    "emission_manipulation_description": null,
    "presentation_links": [],
    "vehicle_class": "M1"
  },
  "own_payment": false,
  "vat_perc": 0,
  "group_id": null,
  "is_consumer_net_auction": false,
  "is_fast_bid_period_entry": "$undefined",
  "source": null,
  "delivery_expenses": null,
  "fulfillment_delivery_expenses_unavailable": false,
  "fulfillment_selectable_method": 200,
  "fulfillment_delivery_expenses": 0,
  "fulfillment_retrieval_expenses": 99,
  "processing_cost_amount_with_vat": 46,
  "processing_cost_amount_without_vat": 46,
  "processing_cost_vat_amount": 0,
  "processing_cost_vat_percentage": 0,
  "is_special_entry": false,
  "is_verified_entry": false,
  "custom_badge": null,
  "is_reserve_price_visible": false,
  "is_listed_internationally": false,
  "is_provisionally_eligible_for_ltr_financing": false,
  "favorite_amount": 14,
  "cancelled": false,
  "ended": false,
  "is_own_payment": false,
  "main_photo": "https://kuvat.huutokaupat.com/ZegJAG5-bhdtt4WJEFm5O4J7ivPzTXFbu7uwxVCaM64/gravity:sm/resize:fit:300:300/czM6Ly9odXV0b2th/dXBhdC1wcm9kLWNk/bi9yZXNvdXJjZXMv/MDE5ZWFiYmQtZGQx/My03M2IwLWFjMjQt/ODQzOTc2NzBkZjMz.jpeg",
  "main_photo_path": "resources/019eabbd-dd13-73b0-ac24-84397670df33",
  "main_photo_rotation": null,
  "public_id": 6364876,
  "from_url": "https://huutokaupat.com/en/haku?term=car"
}

Each scraped auction returns a detailed record with 61 fields covering product info, auction mechanics, and seller data:

Product Identification & Metadata

Field	Meaning
ID	Unique auction identifier in Huutokaupat system
Title	Primary auction item title
Subtitle	Secondary descriptive text for the item
Description	Full HTML product description with details
Slug	URL-friendly product identifier
Public ID	Public-facing ID used in URLs

Location & Category

Field	Meaning
City	Pickup/delivery location city
Zip Code	Postal code of the item
Region	Administrative region in Finland
Class Name	Item classification within category
Category ID	Unique category identifier
Category Name	Human-readable category name
Parent Category ID	Parent category for taxonomy navigation

Photography & Media

Field	Meaning
Photo URL	URL to the main product photo
Photo Large URL	High-resolution version of the photo
Photo Path	Server path for photo retrieval
Photo Rotation	Image rotation angle (0, 90, 180, 270)
Main Photo	Main photo identifier
Main Photo Path	Path to main photo asset
Main Photo Rotation	Rotation of main photo

Seller & Company Information

Field	Meaning
Company ID	Seller/company unique identifier
Company Name	Business or seller name
Company Slug	URL-friendly company identifier
Source	Origin channel (internal, business account, etc.)

Auction Mechanics & Pricing

Field	Meaning
Start Price	Opening bid amount in EUR
Minimum Bid With VAT	Minimum acceptable bid including VAT
Minimum Bid Without VAT	Minimum bid excluding VAT
Highest Bid	Current highest bid amount
Has Been Bidded	Whether the auction has received bids
Bid Count	Total number of bids placed
Bidder Count	Unique number of bidders
Is Sold To Highest Bidder	Whether item sold at hammer price to top bidder
VAT Percentage	VAT rate applied to the item

Auction Timeline & Status

Field	Meaning
Created At	When the listing was created (ISO timestamp)
Updated At	Last modification timestamp
Auction Start	Auction opening date/time
Auction End	Scheduled auction closing time
Original Auction End	Original end time before any extensions
Bidding Ended	Whether active bidding has ceased
Is Cancelled	Whether the auction was cancelled
Continuous Auction	Whether bidding can extend beyond end time
Cancelled	Cancellation status flag
Ended	Boolean indicating auction conclusion

Engagement & Visibility

Field	Meaning
View Count	Number of times the listing was viewed
Favorite Amount	Number of times added to favorites/watchlist
Order	Display order in search results
Is New	Flag indicating recently listed item

Special Flags & Features

Field	Meaning
Is Verified Entry	Whether seller verification is confirmed
Is Special Entry	Premium/featured listing status
Custom Badge	Custom seller or item badge
Is Reserve Price Visible	Whether reserve price is publicly shown
Is Listed Internationally	Available for international bidders
Is Provisionally Eligible For LTR Financing	Eligible for payment plan financing
Is Consumer Net Auction	B2C auction designation
Is Fast Bid Period Entry	Available in fast-bid auctions
Is Own Payment	Seller payment method flag
Own Payment	Payment handling method

Fees, Costs & Fulfillment

Field	Meaning
Delivery Expenses	Estimated shipping cost
Processing Cost Amount With VAT	Administrative fee including VAT
Processing Cost Amount Without VAT	Administrative fee excluding VAT
Processing Cost VAT Amount	VAT portion of processing cost
Processing Cost VAT Percentage	VAT rate for processing fee
Fulfillment Delivery Expenses	Third-party fulfillment shipping cost
Fulfillment Retrieval Expenses	Cost to retrieve item from warehouse
Fulfillment Delivery Expenses Unavailable	Flag if delivery cost unavailable
Fulfillment Selectable Method	Whether buyer can choose delivery option

Additional Metadata

Field	Meaning
Metadata	JSON object with item-specific custom fields
Group ID	Auction group identifier for bulk sales
Class ID	Item class in category hierarchy

---

How to Use

1. Build your search URLs — Navigate Huutokaupat.com, perform a search (e.g., term=car), and copy the full URL including pagination (sivu=1, sivu=2, etc.)
2. Prepare the input — Paste URLs into the urls array. Increase max_items_per_url to 200 for maximum extraction.
3. Enable fault tolerance — Set ignore_url_failures: true for robust bulk scraping across multiple pages.
4. Run the scraper — Start the actor and monitor progress in the run log.
5. Download results — Export data as JSON, CSV, or Excel for analysis in spreadsheets or databases.

Common tips:

• Use specific search terms (term=car, term=phone) to target relevant auctions.
• Pagination is sequential; loop through sivu=1 to sivu=10 for comprehensive coverage.
• Auctions are dynamic; end times, bid counts, and statuses update in real-time.

---

Use Cases & Business Value

• Price benchmarking: Track market values for vehicles, collectibles, and equipment across months
• Competitive monitoring: Watch rival sellers' listings, pricing strategies, and inventory turnover
• Market research: Analyze auction trends, demand by region, and seasonal patterns
• Reseller automation: Feed live auction data into inventory management or alerting systems
• Financial analysis: Study liquidation auctions and asset valuation data

The Huutokaupat Product Search Scraper transforms hours of manual browsing into minutes of automated data collection, giving you a competitive edge in market intelligence.

---

Conclusion

The Huutokaupat.com Product Search Scraper delivers reliable, large-scale extraction of auction data with 61 detailed fields per item. Whether you're tracking prices, monitoring competitors, or building data pipelines, this scraper provides the structure and scale needed to turn Huutokaupat into a strategic data source. Start scraping today and unlock insights that drive smarter bidding and business decisions.