Oikotie.fi Property Search Scraper: Extract Finnish Real Estate Listings

---

What Is Oikotie.fi?

Oikotie.fi is one of Finland's most popular real estate marketplaces, hosting thousands of property listings for sale and rent across the country. It aggregates listings from real estate agencies, private sellers, and developers. Manually collecting property data from search results is impractical at scale — the Oikotie.fi Property Search Scraper automates this, turning paginated search results into clean, structured records ready for analysis or integration.

---

Overview

The Oikotie Property Scraper navigates property search result pages and extracts structured listing data per card. It is suited for:

• Real estate analysts monitoring Finnish housing market trends
• Property investors comparing listings by location, price, and type
• Developers feeding listing data into custom portals or dashboards
• Researchers studying Finnish residential real estate patterns

The scraper handles pagination via URL parameters and supports bulk URL input for multi-search runs.

---

Input Format

{
  "urls": [
    "https://asunnot.oikotie.fi/myytavat-asunnot?pagination=2&cardType=100&secondarySearchType=1"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 50
}

Field	Type	Description
urls	array	One or more Oikotie property search/list page URLs. Add them one by one or use bulk edit. Example: https://asunnot.oikotie.fi/myytavat-asunnot?...
ignore_url_failures	boolean	If true, the scraper continues running even if some URLs fail. Recommended for bulk runs. Default: true
max_items_per_url	integer	Maximum number of listings to collect per URL. Default: 20. Set higher (e.g., 50) to capture more results per search page

Tip: Use Oikotie's built-in filters (location, price range, property type, room count) before copying the URL — the scraper will respect all query parameters embedded in the link.

---

Output Format

Sample Output

{
  "card_id": 24482766,
  "card_type": 100,
  "card_sub_type": 4,
  "url": "https://asunnot.oikotie.fi/myytavat-asunnot/alavus/24482766",
  "status": 1,
  "data": {
    "description": "Kompaktin kokoinen omakotitalo keskustan tuntumassa – oma rauhallinen piha ja toimiva kokonaisuus!\n\nTervetuloa tutustumaan tähän viihtyisään ja h",
    "rooms": 3,
    "room_configuration": "3h+k+khh+kph+s",
    "price": "135 000 €",
    "size": "89 m²",
    "build_year": 2011,
    "size_lot": 1459,
    "size_min": 89,
    "size_max": 89,
    "next_viewing": null,
    "new_development": false,
    "is_online_offer": false,
    "extra_visibility": false,
    "visits": 0,
    "visits_weekly": 0,
    "security_deposit": null,
    "maintenance_fee": null,
    "floor": 1,
    "building_floor_count": 1,
    "price_per_sqm": 1516.85,
    "condition": null,
    "source_type": 9
  },
  "location": {
    "address": "Kumolankuja 17",
    "district": "Keskusta",
    "city": "Alavus",
    "zip_code": "63300",
    "country": "Suomi",
    "latitude": 62.5874,
    "longitude": 23.5947
  },
  "meta": {
    "published": "2026-05-08 15:38:13",
    "contract_type": 1,
    "listing_type": 1,
    "card_view_type": 2,
    "listing_types": [
      7
    ],
    "sell_status": 3,
    "price_changed": null,
    "vendor_ad_id": "20628038",
    "vendor_company_id": "KIVI-35506",
    "sender_node": "kivi-api",
    "published_sort": "2026-05-08 15:38:13"
  },
  "medias": [
    {
      "image_small_j_p_e_g": "https://cdn.asunnot.oikotie.fi/Q5MyYiKaWqO_cfj_OgqdwK7XgV4=/full-fit-in/330x206/filters:background_color(white):format(jpeg)/ot-real-estate-mediabank-prod/324/313/source/229313423",
      "image_large_j_p_e_g": "https://cdn.asunnot.oikotie.fi/Llxy0gF7t71oS1ZVZ5ZKreObYGM=/full-fit-in/708x444/filters:background_color(white):format(jpeg):quality(60)/ot-real-estate-mediabank-prod/324/313/source/229313423",
      "image_desktop_web_p": "https://cdn.asunnot.oikotie.fi/4KwcjvieFD-gTuJfFS4t5AmYgGM=/full-fit-in/400x204/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/324/313/source/229313423",
      "image_desktop_web_px2": "https://cdn.asunnot.oikotie.fi/yLhyBvW0jR__ooG7nWK87ahNQ78=/full-fit-in/800x408/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/324/313/source/229313423",
      "image_tablet_web_p": "https://cdn.asunnot.oikotie.fi/ioxVRiv-jnG1bQrxNo9hZOaxeUI=/full-fit-in/345x176/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/324/313/source/229313423",
      "image_tablet_web_px2": "https://cdn.asunnot.oikotie.fi/yP_ltyQsRX0-TMMxzmZZHRMigzQ=/full-fit-in/690x352/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/324/313/source/229313423",
      "image_mobile_web_p": "https://cdn.asunnot.oikotie.fi/RfKiW72ALyNtPdJHtGfNI_IlxFM=/full-fit-in/732x488/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/324/313/source/229313423",
      "image_mobile_web_px2": "https://cdn.asunnot.oikotie.fi/4ayAC6UXcQZRhnuKcxRoWZPGxAA=/full-fit-in/1464x976/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/324/313/source/229313423",
      "image_mobile_small_web_p": "https://cdn.asunnot.oikotie.fi/FgE8xbRxZR3ofXb_7xJRUAI5NQE=/full-fit-in/330x220/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/324/313/source/229313423",
      "image_mobile_small_web_px2": "https://cdn.asunnot.oikotie.fi/jNwOeMK2xzVS8d-IHkjS1xirX04=/full-fit-in/660x440/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/324/313/source/229313423"
    },
    {
      "image_small_j_p_e_g": "https://cdn.asunnot.oikotie.fi/wmkggjRV7uepKkZjcCSUmVGl2SA=/full-fit-in/330x206/filters:background_color(white):format(jpeg)/ot-real-estate-mediabank-prod/034/313/source/229313430",
      "image_large_j_p_e_g": "https://cdn.asunnot.oikotie.fi/VIjM0RxPJ_RgkQXticvS8OnNZ7o=/full-fit-in/708x444/filters:background_color(white):format(jpeg):quality(60)/ot-real-estate-mediabank-prod/034/313/source/229313430",
      "image_desktop_web_p": "https://cdn.asunnot.oikotie.fi/4kW2ODHePKNj2HOHlQkIav0EmuU=/full-fit-in/400x204/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/034/313/source/229313430",
      "image_desktop_web_px2": "https://cdn.asunnot.oikotie.fi/ABmhZ6v29RVL197kcWhjpAscGBM=/full-fit-in/800x408/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/034/313/source/229313430",
      "image_tablet_web_p": "https://cdn.asunnot.oikotie.fi/m97NxVEDvdEmVszKbeOFSjKmaf4=/full-fit-in/345x176/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/034/313/source/229313430",
      "image_tablet_web_px2": "https://cdn.asunnot.oikotie.fi/YWGXUcre5FaavMSObHVuBBXrEyY=/full-fit-in/690x352/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/034/313/source/229313430",
      "image_mobile_web_p": "https://cdn.asunnot.oikotie.fi/O6JYhsLYKMC3_25Ry3__yuMLHrQ=/full-fit-in/732x488/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/034/313/source/229313430",
      "image_mobile_web_px2": "https://cdn.asunnot.oikotie.fi/Qo9v-7GMoG80al6-lfXr60-6W5M=/full-fit-in/1464x976/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/034/313/source/229313430",
      "image_mobile_small_web_p": "https://cdn.asunnot.oikotie.fi/H_oiNxeKhqHwH69JEuoy1ca9VSg=/full-fit-in/330x220/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/034/313/source/229313430",
      "image_mobile_small_web_px2": "https://cdn.asunnot.oikotie.fi/g23PazZ088jytEjQorM_HV3R7r4=/full-fit-in/660x440/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/034/313/source/229313430"
    },
    {
      "image_small_j_p_e_g": "https://cdn.asunnot.oikotie.fi/fH-kGs6cGecrn4ALepC6uMkuWME=/full-fit-in/330x206/filters:background_color(white):format(jpeg)/ot-real-estate-mediabank-prod/564/313/source/229313465",
      "image_large_j_p_e_g": "https://cdn.asunnot.oikotie.fi/pfrpWJA04uWY6YJtfCmzg7mYyEY=/full-fit-in/708x444/filters:background_color(white):format(jpeg):quality(60)/ot-real-estate-mediabank-prod/564/313/source/229313465",
      "image_desktop_web_p": "https://cdn.asunnot.oikotie.fi/FO_--SbKbkB8VhIOVpO4mBQRjfw=/full-fit-in/400x204/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/564/313/source/229313465",
      "image_desktop_web_px2": "https://cdn.asunnot.oikotie.fi/zIpcDQy65Y94fNwYbEDA0CPj7X0=/full-fit-in/800x408/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/564/313/source/229313465",
      "image_tablet_web_p": "https://cdn.asunnot.oikotie.fi/2qOUvgNxEnKwjuZX3bghIMf749I=/full-fit-in/345x176/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/564/313/source/229313465",
      "image_tablet_web_px2": "https://cdn.asunnot.oikotie.fi/Z9Lt6lLCVV8YVzz7Fpoglv4RKv4=/full-fit-in/690x352/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/564/313/source/229313465",
      "image_mobile_web_p": "https://cdn.asunnot.oikotie.fi/ehm8fyFIhySmFccQvNeT-spoOhI=/full-fit-in/732x488/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/564/313/source/229313465",
      "image_mobile_web_px2": "https://cdn.asunnot.oikotie.fi/qykJT_OJXj32sJQs4-9aJ4Ev1nM=/full-fit-in/1464x976/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/564/313/source/229313465",
      "image_mobile_small_web_p": "https://cdn.asunnot.oikotie.fi/iXRYv1gX_7EY6ecNcXF_zDegQS0=/full-fit-in/330x220/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/564/313/source/229313465",
      "image_mobile_small_web_px2": "https://cdn.asunnot.oikotie.fi/06uvbysATAE5x-ShNsc7fo2msFI=/full-fit-in/660x440/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/564/313/source/229313465"
    },
    {
      "image_small_j_p_e_g": "https://cdn.asunnot.oikotie.fi/kZKzpf6ghNcicLvO23_VNrvaCaM=/full-fit-in/330x206/filters:background_color(white):format(jpeg)/ot-real-estate-mediabank-prod/934/313/source/229313439",
      "image_large_j_p_e_g": "https://cdn.asunnot.oikotie.fi/atdi3VGfPpT7deflD4ylx4Huo-4=/full-fit-in/708x444/filters:background_color(white):format(jpeg):quality(60)/ot-real-estate-mediabank-prod/934/313/source/229313439",
      "image_desktop_web_p": "https://cdn.asunnot.oikotie.fi/oLoDKSFsiiIOPi_RnddhhFpdEOA=/full-fit-in/400x204/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/934/313/source/229313439",
      "image_desktop_web_px2": "https://cdn.asunnot.oikotie.fi/QMIfeMakjT9dQhp5bZabCM0chUY=/full-fit-in/800x408/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/934/313/source/229313439",
      "image_tablet_web_p": "https://cdn.asunnot.oikotie.fi/oQYGA93VGfoip5KIKRj1YJ-aOBw=/full-fit-in/345x176/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/934/313/source/229313439",
      "image_tablet_web_px2": "https://cdn.asunnot.oikotie.fi/5nDgXOSdlYFJ0Ebw6VD9j2-6EoM=/full-fit-in/690x352/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/934/313/source/229313439",
      "image_mobile_web_p": "https://cdn.asunnot.oikotie.fi/D7umQTK_1pv-h8IRGZJ0V2hbdUo=/full-fit-in/732x488/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/934/313/source/229313439",
      "image_mobile_web_px2": "https://cdn.asunnot.oikotie.fi/U-Tf2X2u9CJ_Ih7yNVHAOo4x9So=/full-fit-in/1464x976/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/934/313/source/229313439",
      "image_mobile_small_web_p": "https://cdn.asunnot.oikotie.fi/lX1YX8zptTyruZqwoxx286Rnxdw=/full-fit-in/330x220/filters:background_color(white):format(webp)/ot-real-estate-mediabank-prod/934/313/source/229313439",
      "image_mobile_small_web_px2": "https://cdn.asunnot.oikotie.fi/m2KA7gBIOTkI02UBsxor0ncBCZI=/full-fit-in/660x440/filters:background_color(white):format(webp):quality(60)/ot-real-estate-mediabank-prod/934/313/source/229313439"
    }
  ],
  "company": {
    "company_id": 11875992,
    "company_name": "Omakodit Alavus",
    "company_brand_highlight_background_color": null,
    "company_brand_highlight_font_color": null,
    "search_logo": "https://cdn.asunnot.oikotie.fi/KC_YkXEDH9R-g-pDW87yBHAXJ_c=/fit-in/350x70/ot-real-estate-mediabank-prod/940/219/source/188912049",
    "logo": "https://cdn.asunnot.oikotie.fi/KC_YkXEDH9R-g-pDW87yBHAXJ_c=/fit-in/350x70/ot-real-estate-mediabank-prod/940/219/source/188912049",
    "realtor_image": "https://cdn.asunnot.oikotie.fi/APqAkjwPRzbzznKL9LPwlVvAbvg=/360x360/smart/filters:background_color(white):format(jpeg)/ot-real-estate-mediabank-prod/739/976/source/204679937",
    "realtor_name": "Tuomas Sivula"
  },
  "recommendation_id": null,
  "from_url": "https://asunnot.oikotie.fi/myytavat-asunnot?pagination=2&cardType=100&secondarySearchType=1"
}

Each listing is returned as a card object with the following top-level fields:

Core Identification

Field	Meaning
Card ID	Unique identifier for the listing card on Oikotie
Card Type	Primary listing category (e.g., apartment for sale = 100)
Card Sub Type	Sub-classification of the property type (e.g., terraced house, studio)
URL	Direct link to the full listing detail page
Status	Current listing status (e.g., active, sold, reserved)
Recommendation ID	Internal recommendation engine identifier, may be used for tracking promoted or suggested listings

Property Data

Field	Meaning
Data	Core listing attributes — typically includes price, size (m²), number of rooms, floor, year built, condition, and other property-specific fields returned by the Oikotie API

Location

Field	Meaning
Location	Structured location object containing city, district, street address, and geographic coordinates where available

Media

Field	Meaning
Medias	Array of media assets associated with the listing — property photos, floor plans, or virtual tour links

Metadata

Field	Meaning
Meta	Supplementary metadata such as listing creation date, last update, visibility settings, or platform-specific flags

Company / Agent

Field	Meaning
Company	Details of the real estate agency or agent managing the listing — typically includes company name, logo, and contact info

---

How to Use

1. Build your search URL — Go to asunnot.oikotie.fi, apply filters (city, type, price), then copy the result page URL.
2. Adjust pagination — Modify the pagination=N parameter in the URL to target specific result pages.
3. Configure input — Paste URLs into the urls array, set max_items_per_url as needed.
4. Run the scraper — Start the actor and monitor progress in the run log.
5. Export — Download results as JSON or CSV.

Common issues:

• Ensure URLs point to list/search pages, not individual listing detail pages.
• If results are empty, verify the search URL returns visible listings when opened in a browser.

---

Use Cases & Business Value

• Market analysis: Track average prices per district or property type over time
• Investment research: Identify underpriced listings by comparing size, location, and price
• Portal development: Populate a custom real estate aggregator with Finnish listings
• Academic research: Study urban housing supply and demand in Finnish cities

---

Conclusion

The Oikotie.fi Property Search Scraper makes it straightforward to collect structured Finnish real estate data at scale. With flexible URL-based input and rich output covering pricing, location, media, and agency details, it eliminates manual data gathering and enables deeper market intelligence.