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.

ParameterTypeRequiredAllowed values
location_codestringOptionalAny
location_typestringOptionalCITY, DISTRICT, SUBDISTRICT, MUNICIPALITY, POST_CODE, STREET
parent_region_codestringOptionalAny
min_rentintegerOptionalAny
max_rentintegerOptionalAny
min_sizeintegerOptionalAny
max_sizeintegerOptionalAny
min_yearintegerOptionalAny
max_yearintegerOptionalAny
roomsstringOptionalAny
property_typestringOptionalAny
kitchen_typestringOptionalAny
conditionstringOptionalAny
living_formstringOptionalAny
lessor_typestringOptionalall, private, agency
published_withinstringOptionalany, 1d, 2d, 7d, 30d
new_buildingstringOptionalall, only, exclude
rental_agreementstringOptionalopen_ended
available_immediatelystringOptionaltrue, 1
has_imagesstringOptionaltrue, 1
has_panoramastringOptionaltrue, 1
has_videostringOptionaltrue, 1
has_showing_within_7_daysstringOptionaltrue, 1
querystringOptionalUp to 120 characters
office_idintegerOptionalAny
sortstringOptionalPUBLISHED_OR_UPDATED_AT, PUBLISHING_TIME, SEARCH_RENT, LIVING_AREA, CONSTRUCTION_FINISHED_YEAR, LOCATION, AVAILABILITY, NEXT_SHOWINGS
directionstringOptionalasc, desc
limitintegerOptional25, 30, 100
pageintegerOptionalAny

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.