Oikotie: Search
Search from Oikotie as JSON. 1 credit per successful call.
GET /v1/oikotie/search
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
listing_type | string | Optional | sale, rent |
location_id | integer | Optional | Any |
location_type | string | Optional | street, district, postcode, city, region, country |
location_name | string | Optional | Up to 100 characters |
price_min | integer | Optional | Any |
price_max | integer | Optional | Any |
size_min | number | Optional | Any |
size_max | number | Optional | Any |
rooms[] | list of integer | Optional | Any |
building_type[] | list of string | Optional | apartment_building, row_house, house, leisure, detached, semi_detached, other, loft_house, wood_apartment_house |
habitation_type[] | list of string | Optional | ownership, right_of_occupancy, part_ownership |
new_development | boolean | Optional | Any |
construction_year_min | integer | Optional | Any |
construction_year_max | integer | Optional | Any |
lot_size_min | integer | Optional | Any |
sort | string | Optional | published_desc, published_asc, price_asc, price_desc, size_asc, size_desc |
page | integer | Optional | Any |
limit | integer | Optional | Any |
Example request
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.
Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.