Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Oikotie

1 credit per call4 endpoints21 datapoints

Oikotie API

Oikotie API for Finnish homes for sale or rent, with price per m², fees, room layouts, listings, agencies and brokers as JSON. 1 credit per successful call.

Get a free API keyRun it below
Oikotie
GET/v1/oikotie/search?listing_type=sale&location_id=64&location_type=city&location_name=Helsinki&rooms[]=2&sort=price_asc
{
  "success": true,
  "data": {
    "items": [
      {
        "id": 24642369,
        "url": "https://asunnot.oikotie.fi/myytavat-asunnot/helsinki/24642369",
        "listing_type": "sale",
        "building_type": "apartment_building",
        "description": "Vapautumassa ihana peruskorjattu kaksio Vuosaaren Ramsinniemestä. Asunnossa on valoisa olohuone ja tilava keittiö. Erillinen makuuhuone tarjoaa hy",
        "price": {
          "amount": 8782,
          "currency": "EUR",
          "text": "8 782 €"
        },
        "price_per_sqm": 177.41,
        "size": {
          "min": 49.5,
          "max": 49.5,
          "text": "49,5 m²"
        },
        "rooms": 2,
        "room_configuration": "2H+KK",
        "build_year": 1993,
        "floor": 2,
        "floor_count": 2,
        "fees": {
          "currency": "EUR"
        },
        "new_development": false,
        "address": {
          "street": "Ramsinniementie 7",
          "district": "Vuosaari",
          "city": "Helsinki",
          "postcode": "00980",
          "country": "Suomi"
        },
        "coordinates": {
          "latitude": 60.1986,
          "longitude": 25.1155
        },
        "published": "2026-08-14T11:22:14Z",
        "visits": 1114,
        "images": [
          {
            "thumbnail": "https://cdn.asunnot.oikotie.fi/t-EoJafCFCHnx12JnLA83KhVNdw=/full-fit-in/330x206/filters:background_color(white):format(jpeg)/ot-real-estate-mediabank-prod/309/543/source/232345903",
            "large": "https://cdn.asunnot.oikotie.fi/r05abouPJpDV6yqPLy7xrohAIo0=/full-fit-in/708x444/filters:background_color(white):format(jpeg):quality(60)/ot-real-estate-mediabank-prod/309/543/source/232345903"
          },
          {
            "thumbnail": "https://cdn.asunnot.oikotie.fi/IZgy-vpyfJj_mDHU1eZ9fe7Zp5U=/full-fit-in/330x206/filters:background_color(white):format(jpeg)/ot-real-estate-mediabank-prod/846/422/source/232224648",
            "large": "https://cdn.asunnot.oikotie.fi/Uo6Vo9JaSSWFxEOE6XJOkBF19js=/full-fit-in/708x444/filters:background_color(white):format(jpeg):quality(60)/ot-real-estate-mediabank-prod/846/422/source/232224648"
          },
          {
            "thumbnail": "https://cdn.asunnot.oikotie.fi/ayMjsdWpvfHMLJeJY7172C-w05k=/full-fit-in/330x206/filters:background_color(white):format(jpeg)/ot-real-estate-mediabank-prod/901/779/source/213977109",
            "large": "https://cdn.asunnot.oikotie.fi/r2DdLdx0DZNNG84ww5723IhnhTM=/full-fit-in/708x444/filters:background_color(white):format(jpeg):quality(60)/ot-real-estate-mediabank-prod/901/779/source/213977109"
          }
        ],
        "agency": {
          "id": 5013771,
          "name": "Asuntosäätiö",
          "logo": "https://cdn.asunnot.oikotie.fi/40Nkah68W9QRifiEK_q-4EEsR48=/fit-in/350x70/ot-real-estate-mediabank-prod/577/272/source/193272775"
        }
      },
      {
        "id": 24743611,
        "url": "https://asunnot.oikotie.fi/myytavat-asunnot/helsinki/24743611",
        "listing_type": "sale",
        "building_type": "apartment_building",
        "description": "Ihana valoisa toisen kerroksen kaksio vapautumassa Vuosaaren Ramsinniemestä. Avara olohuone tarjoaa hyvin tilaa niin oleskeluun kuin ruokailuryhmä",
        "price": {
          "amount": 8836,
          "currency": "EUR",
          "text": "8 836 €"
        },
        "price_per_sqm": 178.5,
        "size": {
          "min": 49.5,
          "max": 49.5,
          "text": "49,5 m²"
        },
        "rooms": 2,
        "room_configuration": "2H+KK",
        "build_year": 1993,
        "floor": 2,
        "floor_count": 2,
        "fees": {
          "currency": "EUR"
        },
        "new_development": false,
        "address": {
          "street": "Ramsinniementie 7",
          "district": "Vuosaari",
          "city": "Helsinki",
          "postcode": "00980",
          "country": "Suomi"
        },
        "coordinates": {
          "latitude": 60.1986,
          "longitude": 25.1155
        },
        "published": "2026-10-14T13:23:07Z",
        "visits": 259,
        "images": [
          {
            "thumbnail": "https://cdn.asunnot.oikotie.fi/H-VNhh0EAn2HJdkvfraTUjPPTHk=/full-fit-in/330x206/filters:background_color(white):format(jpeg)/ot-real-estate-mediabank-prod/244/882/source/234288442",
            "large": "https://cdn.asunnot.oikotie.fi/--9hb97dfjcRqcOmetcB5LQHxAE=/full-fit-in/708x444/filters:background_color(white):format(jpeg):quality(60)/ot-real-estate-mediabank-prod/244/882/source/234288442"
          },
          {
            "thumbnail": "https://cdn.asunnot.oikotie.fi/kR2yzxjg_kHhfV21cjyZ_bUGXoY=/full-fit-in/330x206/filters:background_color(white):format(jpeg)/ot-real-estate-mediabank-prod/344/882/source/234288443",
            "large": "https://cdn.asunnot.oikotie.fi/h-fIE41P619oraZiS0jLYdTMfKw=/full-fit-in/708x444/filters:background_color(white):format(jpeg):quality(60)/ot-real-estate-mediabank-prod/344/882/source/234288443"
          },
          {
            "thumbnail": "https://cdn.asunnot.oikotie.fi/ayMjsdWpvfHMLJeJY7172C-w05k=/full-fit-in/330x206/filters:background_color(white):format(jpeg)/ot-real-estate-mediabank-prod/901/779/source/213977109",
            "large": "https://cdn.asunnot.oikotie.fi/r2DdLdx0DZNNG84ww5723IhnhTM=/full-fit-in/708x444/filters:background_color(white):format(jpeg):quality(60)/ot-real-estate-mediabank-prod/901/779/source/213977109"
          }
        ],
        "agency": {
          "id": 5013771,
          "name": "Asuntosäätiö",
          "logo": "https://cdn.asunnot.oikotie.fi/40Nkah68W9QRifiEK_q-4EEsR48=/fit-in/350x70/ot-real-estate-mediabank-prod/577/272/source/193272775"
        }
      },
      {
        "id": 24775877,
        "url": "https://asunnot.oikotie.fi/myytavat-asunnot/helsinki/24775877",
        "listing_type": "sale",
        "building_type": "apartment_building",
        "description": "Tilava olohuone tarjoaa avaran ja viihtyisän oleskelutilan, ja useat ikkunat tuovat huoneeseen runsaasti luonnonvaloa. Keittokomerossa on hyvin ty",
        "price": {
          "amount": 8854,
          "currency": "EUR",
          "text": "8 854 €"
        },
        "price_per_sqm": 178.87,
        "size": {
          "min": 49.5,
          "max": 49.5,
          "text": "49,5 m²"
        },
        "rooms": 2,
        "room_configuration": "2H+KK",
        "build_year": 1993,
        "floor": 1,
        "floor_count": 2,
        "fees": {
          "currency": "EUR"
        },
        "new_development": false,
        "address": {
          "street": "Ramsinniementie 7",
          "district": "Vuosaari",
          "city": "Helsinki",
          "postcode": "00980",
          "country": "Suomi"
        },
        "coordinates": {
          "latitude": 60.1986,
          "longitude": 25.1155
        },
        "published": "2026-11-06T10:26:11Z",
        "visits": 104,
        "images": [
          {
            "thumbnail": "https://cdn.asunnot.oikotie.fi/UGtmI3hOp-BsBa-cziM_1PYBOck=/full-fit-in/330x206/filters:background_color(white):format(jpeg)/ot-real-estate-mediabank-prod/993/239/source/234932399",
            "large": "https://cdn.asunnot.oikotie.fi/wQ270Pl8mMAGfeyWkRvVmFQnE50=/full-fit-in/708x444/filters:background_color(white):format(jpeg):quality(60)/ot-real-estate-mediabank-prod/993/239/source/234932399"
          },
          {
            "thumbnail": "https://cdn.asunnot.oikotie.fi/s8nWmz90xqBY5gfWd6ujlcwBKrE=/full-fit-in/330x206/filters:background_color(white):format(jpeg)/ot-real-estate-mediabank-prod/304/239/source/234932403",
            "large": "https://cdn.asunnot.oikotie.fi/jelwN2n6lanfdLT0TbX636n24TM=/full-fit-in/708x444/filters:background_color(white):format(jpeg):quality(60)/ot-real-estate-mediabank-prod/304/239/source/234932403"
          },
          {
            "thumbnail": "https://cdn.asunnot.oikotie.fi/ayMjsdWpvfHMLJeJY7172C-w05k=/full-fit-in/330x206/filters:background_color(white):format(jpeg)/ot-real-estate-mediabank-prod/901/779/source/213977109",
            "large": "https://cdn.asunnot.oikotie.fi/r2DdLdx0DZNNG84ww5723IhnhTM=/full-fit-in/708x444/filters:background_color(white):format(jpeg):quality(60)/ot-real-estate-mediabank-prod/901/779/source/213977109"
          }
        ],
        "agency": {
          "id": 5013771,
          "name": "Asuntosäätiö",
          "logo": "https://cdn.asunnot.oikotie.fi/40Nkah68W9QRifiEK_q-4EEsR48=/fit-in/350x70/ot-real-estate-mediabank-prod/577/272/source/193272775"
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 24,
      "total_pages": 107,
      "has_next": true,
      "total": 2553,
      "total_is_estimate": false
    }
  },
  "meta": {
    "endpoint_family": "search",
    "dropped_by_filter": 0,
    "request_id": "req_064a4a9ff40746cc9612ad652f16c935",
    "credits_charged": 1,
    "credits_remaining": 1795
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idintegerurlurllisting_typestringbuilding_typestringdescriptionstringpriceobjectprice_per_sqmnumbersizeobjectroomsintegerroom_configurationstringbuild_yearintegerfloorintegerfloor_countintegerfeesobjectnew_developmentbooleanaddressobjectcoordinatesobjectpublishedstringvisitsintegerimagesobject[]agencyobject
124642369https://asunnot.oikotie.fi/myytavat-asunnot/helsinki/24642369saleapartment_buildingVapautumassa ihana peruskorjattu kaksio Vuosaaren Ramsinniemestä. Asunnossa on valoisa olohuone ja tilava keittiö. Erillinen makuuhuone tarjoaa hy{3 fields}177.41{3 fields}22H+KK199322{1 fields}false{5 fields}{2 fields}2026-08-14T11:22:14Z1114[3 items]{3 fields}
224743611https://asunnot.oikotie.fi/myytavat-asunnot/helsinki/24743611saleapartment_buildingIhana valoisa toisen kerroksen kaksio vapautumassa Vuosaaren Ramsinniemestä. Avara olohuone tarjoaa hyvin tilaa niin oleskeluun kuin ruokailuryhmä{3 fields}178.5{3 fields}22H+KK199322{1 fields}false{5 fields}{2 fields}2026-10-14T13:23:07Z259[3 items]{3 fields}
324775877https://asunnot.oikotie.fi/myytavat-asunnot/helsinki/24775877saleapartment_buildingTilava olohuone tarjoaa avaran ja viihtyisän oleskelutilan, ja useat ikkunat tuovat huoneeseen runsaasti luonnonvaloa. Keittokomerossa on hyvin ty{3 fields}178.87{3 fields}22H+KK199312{1 fields}false{5 fields}{2 fields}2026-11-06T10:26:11Z104[3 items]{3 fields}

Recorded from our API · 3 items shown · 21 datapoints per itemGET /v1/oikotie/search?listing_type=sale&location_id=64&location_type=city&location_name=Helsinki&rooms[]=2&sort=price_asc

21 datapoints

Identity

  • idinteger
  • listing_typestring
  • building_typestring

Contact

  • urlurl

Location

  • addressobject

Reputation

  • imagesobject[]

Price

  • priceobject
  • price_per_sqmnumber
  • feesobject

Other

  • descriptionstring
  • sizeobject
  • roomsinteger
  • room_configurationstring
  • build_yearinteger
  • floorinteger
  • floor_countinteger
  • new_developmentboolean
  • coordinatesobject
  • publishedstring
  • visitsinteger
  • agencyobject

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/oikotie/search?listing_type=sale&location_id=64&location_type=city&location_name=Helsinki&rooms[]=2&sort=price_asc" \
  -H "X-API-Key: $API_KEY"

Oikotie · 4 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/oikotie/agency
none+3 optional
1 credit
GET/v1/oikotie/autocomplete
query
1 credit
GET/v1/oikotie/listing
card_id
1 credit
GET/v1/oikotie/search
none+18 optional
1 credit

Overview

What you can get

The Oikotie API returns Oikotie property data as JSON through 4 endpoints.

  • Search: search takes listing_type (sale or rent), location_id, location_type (street, district, postcode, city, region or country), location_name, price_min, price_max, size_min, size_max, rooms[], building_type[] and habitation_type[] (repeatable), new_development, construction_year_min, construction_year_max, lot_size_min, sort (published_desc, published_asc, price_asc, price_desc, size_asc or size_desc), page and limit.
  • Listings: listing takes a card_id.
  • Agencies: agency takes a company_id or a card_id, with include_brokers.
  • Autocomplete: autocomplete takes a query.

The recorded search for 2-room homes for sale in Helsinki, sorted by price_asc, returns pagination with a total of 2,553, limit (24), total_pages and has_next, and items, each with id, url, listing_type, building_type, price, price_per_sqm, size, rooms, room_configuration, build_year, floor, floor_count, fees, new_development, address, coordinates, published, visits, images and agency.

How a call works

Search a city: GET /v1/oikotie/search?listing_type=sale&location_id=64&location_type=city&location_name=Helsinki&rooms[]=2&sort=price_asc with your key in the X-API-Key header. Each item's id is what listing takes as card_id, and agency takes the same card_id to return the listing's agency. Check has_next before asking for the next page. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track asking prices and price per m² in Helsinki and other Finnish cities

Use the Oikotie API to track asking prices and price per m² in Helsinki and other Finnish cities

Compare homes by `build_year` and `room_configuration`

Use the Oikotie API to compare homes by `build_year` and `room_configuration`

Watch new developments with `new_development`

Use the Oikotie API to watch new developments with `new_development`

Gauge interest in a listing with `visits`

Use the Oikotie API to gauge interest in a listing with `visits`

FAQ

Questions

Do I need an Oikotie account?

No. You call this Oikotie API with your Perceptlayer key in the `X-API-Key` header, with no Oikotie login.

How much does the Oikotie API cost?

Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Can I search rentals too?

Yes. Set `listing_type` to rent, or sale for homes for sale.

Should I build an Oikotie scraper instead?

You can, but an Oikotie scraper is code you maintain: page changes break it, requests get blocked, and Oikotie's terms govern how you collect data. The Oikotie API gives you 4 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Oikotie API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs