---
title: "Vuokraovi API: Search | Perceptlayer"
description: "Search from Vuokraovi as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/vuokraovi/search
---

[APIs](https://perceptlayer.com/apis) / [Vuokraovi](https://perceptlayer.com/apis/vuokraovi) / Search

# 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 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/vuokraovi?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.