--- title: "Vuokraovi API: JSON data, 5 endpoints, 1 credit per call" description: "Vuokraovi API for Finnish rental homes, with rent, size, rooms, availability, listings, letting agencies and districts as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/vuokraovi --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Vuokraovi 1 credit per call 5 endpoints 25 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | id integer | friendly\_id string | url url | address string | district\_city string | latitude number | longitude number | year\_built integer | published\_at string | published\_or\_updated\_at string | image\_url url | office object | is\_company\_announcement boolean | new\_building boolean | property\_subtype string | right\_of\_occupancy boolean | room\_structure string | room\_count string | rooms integer | floor integer | floor\_count integer | area integer | rent integer | currency string | availability object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 2770013 | hq4489 | https://www.vuokraovi.com/kohde/hq4489 | Vanha Helsingintie 19 | Malmi Helsinki | 60.24913 | 25.00949 | 2023 | 2026-11-12T13:21:59.143Z | 2026-11-12T13:21:59.143Z | https://d3ls91xgksobn.cloudfront.net/1280x854,fit,q80,f=webp/etuovimedia/images/rental/import/13/2770013/0e76b9541118d347871c0e0e51d244c4/ae8e6038502e625e0dcbbbbc294561ae/ORIGINAL.jpeg | {3 fields} | false | false | APARTMENT\_HOUSE | false | 1h-2h + kt + ransk | TWO\_ROOMS | 2 | 13 | 16 | 29 | 785 | EUR | {2 fields} | | 2 | 2769884 | hq4369 | https://www.vuokraovi.com/kohde/hq4369 | Ruusutarhantie 5 | Etelä-Haaga Helsinki | 60.207791 | 24.887443 | 1960 | 2026-11-12T12:11:41.381Z | 2026-11-12T12:11:41.381Z | https://d3ls91xgksobn.cloudfront.net/1280x854,fit,q80,f=webp/etuovimedia/images/rental/import/884/2769884/0e76b9541118d347871c0e0e51d244c4/63c8fa63a24c4fc18aca36e9f7da7281/ORIGINAL.png | {3 fields} | false | false | APARTMENT\_HOUSE | false | 2h + kt + las.parveke | TWO\_ROOMS | 2 | 2 | 2 | 41 | 830 | EUR | {2 fields} | | 3 | 2769862 | hq4339 | https://www.vuokraovi.com/kohde/hq4339 | Koskenhaantie 26 | Vesala HELSINKI | 60.241815 | 25.091679 | 1989 | 2026-11-12T11:52:03.027Z | 2026-11-12T11:52:03.027Z | https://d3ls91xgksobn.cloudfront.net/1280x854,fit,q80,f=webp/etuovimedia/images/rental/import/862/2769862/0e76b9541118d347871c0e0e51d244c4/72a0c20e5ca8eab02322aa9a93f7d76e/ORIGINAL.jpeg | {3 fields} | false | false | APARTMENT\_HOUSE | false | 2H + K | TWO\_ROOMS | 2 | 3 | 3 | 56 | 837 | EUR | {2 fields} | Recorded from our API · 3 items shown · 25 datapoints per item GET /v1/vuokraovi/search?location\_code=FI\_UUSIMAA\_HELSINKI&location\_type=CITY&max\_rent=900&rooms=2&limit=30 25 datapoints ### Identity - id integer - friendly\_id string - property\_subtype string ### Contact - url url - image\_url url - is\_company\_announcement boolean ### Location - address string - district\_city string - latitude number - longitude number - area integer ### Price - currency string ### Other - year\_built integer - published\_at string - published\_or\_updated\_at string - office object - new\_building boolean - right\_of\_occupancy boolean - room\_structure string - room\_count string - rooms integer - floor integer - floor\_count integer - rent integer - availability object Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/vuokraovi/agency`](https://perceptlayer.com/apis/vuokraovi/agency) | `id` | 1 credit | | [GET `/v1/vuokraovi/districts`](https://perceptlayer.com/apis/vuokraovi/districts) | `municipality_code` | 1 credit | | [GET `/v1/vuokraovi/listing`](https://perceptlayer.com/apis/vuokraovi/listing) | `id` | 1 credit | | [GET `/v1/vuokraovi/location-autocomplete`](https://perceptlayer.com/apis/vuokraovi/location-autocomplete) | `q` +2 optional | 1 credit | | [GET `/v1/vuokraovi/search`](https://perceptlayer.com/apis/vuokraovi/search) | none +29 optional | 1 credit | Overview ## About the Vuokraovi API ## 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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)