--- title: "Oikotie API: JSON data, 4 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/oikotie --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Oikotie 1 credit per call 4 endpoints 21 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | id integer | url url | listing\_type string | building\_type string | description string | price object | price\_per\_sqm number | size object | rooms integer | room\_configuration string | build\_year integer | floor integer | floor\_count integer | fees object | new\_development boolean | address object | coordinates object | published string | visits integer | images object\[\] | agency object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 24642369 | https://asunnot.oikotie.fi/myytavat-asunnot/helsinki/24642369 | sale | apartment\_building | Vapautumassa ihana peruskorjattu kaksio Vuosaaren Ramsinniemestä. Asunnossa on valoisa olohuone ja tilava keittiö. Erillinen makuuhuone tarjoaa hy | {3 fields} | 177.41 | {3 fields} | 2 | 2H+KK | 1993 | 2 | 2 | {1 fields} | false | {5 fields} | {2 fields} | 2026-08-14T11:22:14Z | 1114 | \[3 items\] | {3 fields} | | 2 | 24743611 | https://asunnot.oikotie.fi/myytavat-asunnot/helsinki/24743611 | sale | apartment\_building | Ihana valoisa toisen kerroksen kaksio vapautumassa Vuosaaren Ramsinniemestä. Avara olohuone tarjoaa hyvin tilaa niin oleskeluun kuin ruokailuryhmä | {3 fields} | 178.5 | {3 fields} | 2 | 2H+KK | 1993 | 2 | 2 | {1 fields} | false | {5 fields} | {2 fields} | 2026-10-14T13:23:07Z | 259 | \[3 items\] | {3 fields} | | 3 | 24775877 | https://asunnot.oikotie.fi/myytavat-asunnot/helsinki/24775877 | sale | apartment\_building | Tilava olohuone tarjoaa avaran ja viihtyisän oleskelutilan, ja useat ikkunat tuovat huoneeseen runsaasti luonnonvaloa. Keittokomerossa on hyvin ty | {3 fields} | 178.87 | {3 fields} | 2 | 2H+KK | 1993 | 1 | 2 | {1 fields} | false | {5 fields} | {2 fields} | 2026-11-06T10:26:11Z | 104 | \[3 items\] | {3 fields} | Recorded from our API · 3 items shown · 21 datapoints per item GET /v1/oikotie/search?listing\_type=sale&location\_id=64&location\_type=city&location\_name=Helsinki&rooms\[\]=2&sort=price\_asc 21 datapoints ### Identity - id integer - listing\_type string - building\_type string ### Contact - url url ### Location - address object ### Reputation - images object\[\] ### Price - price object - price\_per\_sqm number - fees object ### Other - description string - size object - rooms integer - room\_configuration string - build\_year integer - floor integer - floor\_count integer - new\_development boolean - coordinates object - published string - visits integer - agency object Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/oikotie/agency`](https://perceptlayer.com/apis/oikotie/agency) | none +3 optional | 1 credit | | [GET `/v1/oikotie/autocomplete`](https://perceptlayer.com/apis/oikotie/autocomplete) | `query` | 1 credit | | [GET `/v1/oikotie/listing`](https://perceptlayer.com/apis/oikotie/listing) | `card_id` | 1 credit | | [GET `/v1/oikotie/search`](https://perceptlayer.com/apis/oikotie/search) | none +18 optional | 1 credit | Overview ## About the Oikotie API ## 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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)