--- title: "Etuovi API: Search | Perceptlayer" description: "Search from Etuovi as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/etuovi/search --- [APIs](https://perceptlayer.com/apis) / [Etuovi](https://perceptlayer.com/apis/etuovi) / Search # Etuovi: Search Search from Etuovi as JSON. 1 credit per successful call. GET `/v1/etuovi/search` ## Parameters Send parameters in the query string. | Parameter | Type | Required | Allowed values | | --- | --- | --- | --- | | `listing_type` | string | Optional | sale, rent | | `location` | string | Optional | Up to 100 characters | | `location_type` | string | Optional | Any | | `location_code` | string | Optional | Any | | `property_type` | string | Optional | residential, plot, leisure, estate, other | | `residential_type[]` | list of string | Optional | apartment\_house, row\_house, semi\_detached\_house, detached\_house, separate\_house, balcony\_access\_block, wooden\_house\_apartment | | `room_counts[]` | list of string | Optional | 1, 2, 3, 4, 5, more\_than\_five | | `min_price` | integer | Optional | Any | | `max_price` | integer | Optional | Any | | `min_area` | integer | Optional | Any | | `max_area` | integer | Optional | Any | | `min_year` | integer | Optional | Any | | `max_year` | integer | Optional | Any | | `agency_id` | integer | Optional | Any | | `sort` | string | Optional | newest, oldest, price\_asc, price\_desc, area\_asc, area\_desc, year\_asc, year\_desc | | `page` | integer | Optional | Any | | `per_page` | integer | Optional | 30, 50, 100 | ## Example request Etuovi GET /v1/etuovi/search?listing\_type=sale&location=Tampere&room\_counts\[\]=2&max\_price=200000 ``` { "success": true, "data": { "items": [ { "id": 2770003, "friendly_id": "20831797", "url": "https://www.etuovi.com/kohde/20831797", "listing_type": "sale", "address_line_1": "Ristinarkuntie 20", "address_line_2": "Janka Tampere", "location": "Ristinarkuntie 20 Janka Tampere", "geo": { "lat": 61.488856, "lng": 23.854849 }, "year_built": 2019, "published_at": "2026-11-12T13:20:04+00:00", "updated_at": "2026-11-12T13:20:04+00:00", "price": { "amount": 154000, "currency": "EUR", "is_share_price": false }, "area": 37.5, "total_area": 37.5, "room_count": { "count": 2, "type": "TWO_ROOMS" }, "room_structure": "2h, k, kph, lasit. parveke", "floor": 4, "floor_count": 7, "property_type": "RESIDENTIAL", "property_subtype": "APARTMENT_HOUSE", "new_building": false, "image": "https://d3ls91xgksobn.cloudfront.net/800x600/etuovimedia/images/property/import/3/2770003/0e76b9541118d347871c0e0e51d244c4/25467491564731048a0ddb8f622aaf04/ORIGINAL.jpeg", "office": { "id": 2681, "name": "Herrainmäki | Sami Nyman LKV Oy", "logo": "https://d3ls91xgksobn.cloudfront.net/800x600/etuovimedia/images/office/logo/customerlogo2681_1.png", "url": "https://www.herrainmaki.fi/" }, "agent": { "name": "Nyman Sami", "image": "https://d3ls91xgksobn.cloudfront.net/800x600/etuovimedia/images/agent/import/41383e893b76788fdf9f4f871772c49e/f1b0debe73c9a6b5165535f60feeb738/ORIGINAL.jpeg" }, "preview_images": [ "https://d3ls91xgksobn.cloudfront.net/800x600/etuovimedia/images/property/import/3/2770003/0e76b9541118d347871c0e0e51d244c4/9256ff8d83f976fc77f78f15e73b7c9f/ORIGINAL.jpeg", "https://d3ls91xgksobn.cloudfront.net/800x600/etuovimedia/images/property/import/3/2770003/0e76b9541118d347871c0e0e51d244c4/4fdbabe5d0e06625e47cf35c31f253f8/ORIGINAL.jpeg" ] }, { "id": 2769992, "friendly_id": "628844", "url": "https://www.etuovi.com/kohde/628844", "listing_type": "sale", "address_line_1": "Sarvijaakonkatu 23 B", "address_line_2": "Kaleva Tampere", "location": "Sarvijaakonkatu 23 B Kaleva Tampere", "geo": { "lat": 61.492977, "lng": 23.812435 }, "year_built": 2018, "published_at": "2026-11-12T13:11:13+00:00", "updated_at": "2026-11-12T13:11:13+00:00", "price": { "amount": 189000, "currency": "EUR", "is_share_price": false }, "area": 45.5, "total_area": 45.5, "room_count": { "count": 2, "type": "TWO_ROOMS" }, "room_structure": "2h + kt + vh + p", "floor": 5, "floor_count": 6, "property_type": "RESIDENTIAL", "property_subtype": "APARTMENT_HOUSE", "new_building": false, "image": "https://d3ls91xgksobn.cloudfront.net/800x600/etuovimedia/images/property/import/992/2769992/0e76b9541118d347871c0e0e51d244c4/665bf4765b6e48b0dd346328d2b590fd/ORIGINAL.jpeg", "office": { "id": 420, "name": "OP Koti Sisä-Suomi Oy LKV, Tampere Keskusta", "logo": "https://d3ls91xgksobn.cloudfront.net/800x600/etuovimedia/images/etuovi/customer/logo/customerImage23_20261020_125652.jpeg", "url": "https://op-koti.fi?cmpid=.opkoti..huom.1.etuovi.banner.yrityslogo.ha_jn_opkoti_valitys" }, "agent": { "name": "Heli Jussila", "image": "https://d3ls91xgksobn.cloudfront.net/800x600/etuovimedia/images/agent/import/41383e893b76788fdf9f4f871772c49e/e7eac067c6d52df6796cf7eae47b13f1/ORIGINAL.jpeg" }, "preview_images": [ "https://d3ls91xgksobn.cloudfront.net/800x600/etuovimedia/images/property/import/992/2769992/0e76b9541118d347871c0e0e51d244c4/df5f314cbd1f1bd5087d405cc1eb4091/ORIGINAL.jpeg" ] }, { "id": 2769973, "friendly_id": "67432227", "url": "https://www.etuovi.com/kohde/67432227", "listing_type": "sale", "address_line_1": "Hallituskatu 15", "address_line_2": "Keskusta Tampere", "location": "Hallituskatu 15 Keskusta Tampere", "geo": { "lat": 61.496086, "lng": 23.754608 }, "year_built": 1962, "published_at": "2026-11-12T12:54:05+00:00", "updated_at": "2026-11-12T12:54:05+00:00", "price": { "amount": 162000, "currency": "EUR", "is_share_price": false }, "area": 36, "total_area": 36, "room_count": { "count": 2, "type": "TWO_ROOMS" }, "room_structure": "2h, kk, kph / wc, vh", "floor": 8, "floor_count": 8, "property_type": "RESIDENTIAL", "property_subtype": "APARTMENT_HOUSE", "new_building": false, "image": "https://d3ls91xgksobn.cloudfront.net/800x600/etuovimedia/images/property/import/973/2769973/0e76b9541118d347871c0e0e51d244c4/e6144c7ae5a375b4de875e03405b953c/ORIGINAL.jpeg", "office": { "id": 3297, "name": "Bo LKV Tampere | Valtteri Lampinen LKV Oy", "logo": "https://d3ls91xgksobn.cloudfront.net/800x600/etuovimedia/images/etuovi/customer/logo/customerImage68v2.jpeg", "url": "https://bo.fi/myymassa/" }, "agent": { "name": "Valtteri Lampinen", "image": "https://d3ls91xgksobn.cloudfront.net/800x600/etuovimedia/images/agent/import/41383e893b76788fdf9f4f871772c49e/957bc6f22f9717a41980a8cf4e48b1b4/ORIGINAL.png" }, "preview_images": [ "https://d3ls91xgksobn.cloudfront.net/800x600/etuovimedia/images/property/import/973/2769973/0e76b9541118d347871c0e0e51d244c4/eef287a17928a479b80449db49b94da4/ORIGINAL.jpeg", "https://d3ls91xgksobn.cloudfront.net/800x600/etuovimedia/images/property/import/973/2769973/0e76b9541118d347871c0e0e51d244c4/9898dfb64598af0f0e5f9c35e5f882af/ORIGINAL.png" ] } ], "pagination": { "page": 1, "per_page": 30, "total": 752, "total_pages": 26, "has_next": true } }, "meta": { "endpoint_family": "search", "location": { "type": "CITY", "code": "FI_PIRKANMAA_TAMPERE", "name": "Tampere", "full_name": "Tampere" }, "dropped_by_filter": 0, "request_id": "req_04ca53d239f44c81a3c9c0828fa83c82", "credits_charged": 1, "credits_remaining": 1872 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. [Run this endpoint in the playground](https://perceptlayer.com/apis/etuovi?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.