Vuokraovi: Search
Search from Vuokraovi as JSON. 1 credit per successful call.
GET /v1/vuokraovi/search
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
location_code | string | Optional | Any |
location_type | string | Optional | CITY, DISTRICT, SUBDISTRICT, MUNICIPALITY, POST_CODE, STREET |
parent_region_code | string | Optional | Any |
min_rent | integer | Optional | Any |
max_rent | integer | Optional | Any |
min_size | integer | Optional | Any |
max_size | integer | Optional | Any |
min_year | integer | Optional | Any |
max_year | integer | Optional | Any |
rooms | string | Optional | Any |
property_type | string | Optional | Any |
kitchen_type | string | Optional | Any |
condition | string | Optional | Any |
living_form | string | Optional | Any |
lessor_type | string | Optional | all, private, agency |
published_within | string | Optional | any, 1d, 2d, 7d, 30d |
new_building | string | Optional | all, only, exclude |
rental_agreement | string | Optional | open_ended |
available_immediately | string | Optional | true, 1 |
has_images | string | Optional | true, 1 |
has_panorama | string | Optional | true, 1 |
has_video | string | Optional | true, 1 |
has_showing_within_7_days | string | Optional | true, 1 |
query | string | Optional | Up to 120 characters |
office_id | integer | Optional | Any |
sort | string | Optional | PUBLISHED_OR_UPDATED_AT, PUBLISHING_TIME, SEARCH_RENT, LIVING_AREA, CONSTRUCTION_FINISHED_YEAR, LOCATION, AVAILABILITY, NEXT_SHOWINGS |
direction | string | Optional | asc, desc |
limit | integer | Optional | 25, 30, 100 |
page | integer | Optional | Any |
Example request
Vuokraovi
GET/v1/vuokraovi/search?location_code=FI_UUSIMAA_HELSINKI&location_type=CITY&max_rent=900&rooms=2&limit=30
{
"success": true,
"total": 707,
"returned": 30,
"page": 1,
"limit": 30,
"has_more": true,
"applied_filters": {
"location_code": "FI_UUSIMAA_HELSINKI",
"location_type": "CITY",
"max_rent": 900,
"rooms": [
"2"
],
"sort": "PUBLISHED_OR_UPDATED_AT",
"direction": "desc"
},
"listings": [
{
"id": 2770013,
"friendly_id": "hq4489",
"url": "https://www.vuokraovi.com/kohde/hq4489",
"address": "Vanha Helsingintie 19",
"district_city": "Malmi Helsinki",
"latitude": 60.24913,
"longitude": 25.00949,
"year_built": 2023,
"published_at": "2026-11-12T13:21:59.143Z",
"published_or_updated_at": "2026-11-12T13:21:59.143Z",
"image_url": "https://d3ls91xgksobn.cloudfront.net/1280x854,fit,q80,f=webp/etuovimedia/images/rental/import/13/2770013/0e76b9541118d347871c0e0e51d244c4/ae8e6038502e625e0dcbbbbc294561ae/ORIGINAL.jpeg",
"office": {
"id": 4068,
"name": "Juli Living Finland Oy",
"office_number": 35501
},
"is_company_announcement": false,
"new_building": false,
"property_subtype": "APARTMENT_HOUSE",
"right_of_occupancy": false,
"room_structure": "1h-2h + kt + ransk",
"room_count": "TWO_ROOMS",
"rooms": 2,
"floor": 13,
"floor_count": 16,
"area": 29,
"rent": 785,
"currency": "EUR",
"availability": {
"type": "VACANCY",
"date": "2026-12-01"
}
},
{
"id": 2769884,
"friendly_id": "hq4369",
"url": "https://www.vuokraovi.com/kohde/hq4369",
"address": "Ruusutarhantie 5",
"district_city": "Etelä-Haaga Helsinki",
"latitude": 60.207791,
"longitude": 24.887443,
"year_built": 1960,
"published_at": "2026-11-12T12:11:41.381Z",
"published_or_updated_at": "2026-11-12T12:11:41.381Z",
"image_url": "https://d3ls91xgksobn.cloudfront.net/1280x854,fit,q80,f=webp/etuovimedia/images/rental/import/884/2769884/0e76b9541118d347871c0e0e51d244c4/63c8fa63a24c4fc18aca36e9f7da7281/ORIGINAL.png",
"office": {
"id": 3775,
"name": "Kiinteistötahkola Helsinki",
"office_number": 32917
},
"is_company_announcement": false,
"new_building": false,
"property_subtype": "APARTMENT_HOUSE",
"right_of_occupancy": false,
"room_structure": "2h + kt + las.parveke",
"room_count": "TWO_ROOMS",
"rooms": 2,
"floor": 2,
"floor_count": 2,
"area": 41,
"rent": 830,
"currency": "EUR",
"availability": {
"type": "VACANCY",
"date": "2026-12-01"
}
},
{
"id": 2769862,
"friendly_id": "hq4339",
"url": "https://www.vuokraovi.com/kohde/hq4339",
"address": "Koskenhaantie 26",
"district_city": "Vesala HELSINKI",
"latitude": 60.241815,
"longitude": 25.091679,
"year_built": 1989,
"published_at": "2026-11-12T11:52:03.027Z",
"published_or_updated_at": "2026-11-12T11:52:03.027Z",
"image_url": "https://d3ls91xgksobn.cloudfront.net/1280x854,fit,q80,f=webp/etuovimedia/images/rental/import/862/2769862/0e76b9541118d347871c0e0e51d244c4/72a0c20e5ca8eab02322aa9a93f7d76e/ORIGINAL.jpeg",
"office": {
"id": 4137,
"name": "Lumo-kotikeskus PKS",
"office_number": 32132
},
"is_company_announcement": false,
"new_building": false,
"property_subtype": "APARTMENT_HOUSE",
"right_of_occupancy": false,
"room_structure": "2H + K",
"room_count": "TWO_ROOMS",
"rooms": 2,
"floor": 3,
"floor_count": 3,
"area": 56,
"rent": 837,
"currency": "EUR",
"availability": {
"type": "VACANCY",
"date": "2027-01-01"
}
}
],
"meta": {
"endpoint_family": "search",
"attempts": 1,
"request_id": "req_5ebcf6fcb17b498882c7e6c8c3e412ae",
"credits_charged": 1,
"credits_remaining": 1803
}
}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.