Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Vuokraovi

1 credit per call5 endpoints25 datapoints

Vuokraovi API

Vuokraovi API for Finnish rental homes, with rent, size, rooms, availability, listings, letting agencies and districts as JSON. 1 credit per successful call.

Get a free API keyRun it below
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.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idintegerfriendly_idstringurlurladdressstringdistrict_citystringlatitudenumberlongitudenumberyear_builtintegerpublished_atstringpublished_or_updated_atstringimage_urlurlofficeobjectis_company_announcementbooleannew_buildingbooleanproperty_subtypestringright_of_occupancybooleanroom_structurestringroom_countstringroomsintegerfloorintegerfloor_countintegerareaintegerrentintegercurrencystringavailabilityobject
12770013hq4489https://www.vuokraovi.com/kohde/hq4489Vanha Helsingintie 19Malmi Helsinki60.2491325.0094920232026-11-12T13:21:59.143Z2026-11-12T13:21:59.143Zhttps://d3ls91xgksobn.cloudfront.net/1280x854,fit,q80,f=webp/etuovimedia/images/rental/import/13/2770013/0e76b9541118d347871c0e0e51d244c4/ae8e6038502e625e0dcbbbbc294561ae/ORIGINAL.jpeg{3 fields}falsefalseAPARTMENT_HOUSEfalse1h-2h + kt + ranskTWO_ROOMS2131629785EUR{2 fields}
22769884hq4369https://www.vuokraovi.com/kohde/hq4369Ruusutarhantie 5Etelä-Haaga Helsinki60.20779124.88744319602026-11-12T12:11:41.381Z2026-11-12T12:11:41.381Zhttps://d3ls91xgksobn.cloudfront.net/1280x854,fit,q80,f=webp/etuovimedia/images/rental/import/884/2769884/0e76b9541118d347871c0e0e51d244c4/63c8fa63a24c4fc18aca36e9f7da7281/ORIGINAL.png{3 fields}falsefalseAPARTMENT_HOUSEfalse2h + kt + las.parvekeTWO_ROOMS22241830EUR{2 fields}
32769862hq4339https://www.vuokraovi.com/kohde/hq4339Koskenhaantie 26Vesala HELSINKI60.24181525.09167919892026-11-12T11:52:03.027Z2026-11-12T11:52:03.027Zhttps://d3ls91xgksobn.cloudfront.net/1280x854,fit,q80,f=webp/etuovimedia/images/rental/import/862/2769862/0e76b9541118d347871c0e0e51d244c4/72a0c20e5ca8eab02322aa9a93f7d76e/ORIGINAL.jpeg{3 fields}falsefalseAPARTMENT_HOUSEfalse2H + KTWO_ROOMS23356837EUR{2 fields}

Recorded from our API · 3 items shown · 25 datapoints per itemGET /v1/vuokraovi/search?location_code=FI_UUSIMAA_HELSINKI&location_type=CITY&max_rent=900&rooms=2&limit=30

25 datapoints

Identity

  • idinteger
  • friendly_idstring
  • property_subtypestring

Contact

  • urlurl
  • image_urlurl
  • is_company_announcementboolean

Location

  • addressstring
  • district_citystring
  • latitudenumber
  • longitudenumber
  • areainteger

Price

  • currencystring

Other

  • year_builtinteger
  • published_atstring
  • published_or_updated_atstring
  • officeobject
  • new_buildingboolean
  • right_of_occupancyboolean
  • room_structurestring
  • room_countstring
  • roomsinteger
  • floorinteger
  • floor_countinteger
  • rentinteger
  • availabilityobject

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/vuokraovi/search?location_code=FI_UUSIMAA_HELSINKI&location_type=CITY&max_rent=900&rooms=2&limit=30" \
  -H "X-API-Key: $API_KEY"

Vuokraovi · 5 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/vuokraovi/agency
id
1 credit
GET/v1/vuokraovi/districts
municipality_code
1 credit
GET/v1/vuokraovi/listing
id
1 credit
GET/v1/vuokraovi/location-autocomplete
q+2 optional
1 credit
GET/v1/vuokraovi/search
none+29 optional
1 credit

Overview

What you can get

The Vuokraovi API returns Vuokraovi rental data as JSON through 5 endpoints.

  • Search: search takes a location_code with location_type (CITY, DISTRICT, SUBDISTRICT, MUNICIPALITY, POST_CODE or STREET) and parent_region_code, plus min_rent, max_rent, min_size, max_size, min_year, max_year, rooms, property_type, kitchen_type, condition, living_form, lessor_type (all, private or agency), published_within (any, 1d, 2d, 7d or 30d), new_building (all, only or exclude), rental_agreement (open_ended), available_immediately, has_images, has_panorama, has_video, has_showing_within_7_days, query, office_id, sort (PUBLISHED_OR_UPDATED_AT, PUBLISHING_TIME, SEARCH_RENT, LIVING_AREA, CONSTRUCTION_FINISHED_YEAR, LOCATION, AVAILABILITY or NEXT_SHOWINGS), direction (asc or desc), limit (25, 30 or 100) and page.
  • Listings: listing takes an id.
  • Agencies: agency takes an id.
  • Locations: location-autocomplete takes a q, with type (the same six location types) and page; districts takes a municipality_code.

The recorded search for 2-room rentals in Helsinki up to €900 a month returns a total of 707, with limit (30) and has_more, and listings, each with id, friendly_id, url, address, district_city, latitude, longitude, year_built, published_at, office, new_building, property_subtype, room_structure, rooms, floor, floor_count, area, rent, currency and availability.

How a call works

Search a city: GET /v1/vuokraovi/search?location_code=FI_UUSIMAA_HELSINKI&location_type=CITY&max_rent=900&rooms=2&limit=30 with your key in the X-API-Key header. Each listing's friendly_id (such as hq4489) is the form of id that listing takes, and the id inside its office is what search takes as office_id. The same location_code feeds districts as municipality_code. Check has_more before asking for the next page. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track asking rents by room count in Helsinki and other Finnish cities

Use the Vuokraovi API to track asking rents by room count in Helsinki and other Finnish cities

Watch new rentals with `published_within=1d`

Use the Vuokraovi API to watch new rentals with `published_within=1d`

Find homes free now with `available_immediately`

Use the Vuokraovi API to find homes free now with `available_immediately`

Compare private landlords with letting agencies using `lessor_type`

Use the Vuokraovi API to compare private landlords with letting agencies using `lessor_type`

FAQ

Questions

Do I need a Vuokraovi account?

No. You call this Vuokraovi API with your Perceptlayer key in the `X-API-Key` header, with no Vuokraovi login.

How much does the Vuokraovi 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 only private landlords?

Yes. Set `lessor_type` to private, or agency for letting agencies only.

Should I build a Vuokraovi scraper instead?

You can, but a Vuokraovi scraper is code you maintain: page changes break it, requests get blocked, and Vuokraovi's terms govern how you collect data. The Vuokraovi API gives you 5 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 Vuokraovi API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs