Property Search
/api/oikotie/search
Search Finnish properties for sale or for rent
Scrappa's Oikotie API returns structured JSON from Oikotie Asunnot, a Finnish property marketplace. Search homes for sale or for rent with location, price, rooms, area, building type and build year filters, open any listing for price, fees, address, coordinates, building data, images and vendor id, read agency profiles with their brokers, and autocomplete cities, districts, streets and postcodes. Scrappa is an independent service and is not affiliated with or endorsed by Oikotie.
Try it now
Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.
curl -X GET "https://scrappa.co/api/oikotie/search?location_id=64&location_type=city&location_name=Helsinki&listing_type=sale" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
{
"success": true,
"data": {
"pagination": { "page": 1, "limit": 24, "total_pages": 342, "has_next": true, "total": 8191, "total_is_estimate": false },
"items": [
{
"id": 24755858,
"url": "https://asunnot.oikotie.fi/myytavat-asunnot/helsinki/24755858",
"listing_type": "sale",
"building_type": "apartment_building",
"price": { "amount": 139000, "currency": "EUR", "period": null, "text": "139 000 €" },
"size": { "min": 32, "max": 32, "text": "32 m²" },
"rooms": 1,
"address": { "street": "Ruusutarhantie 5 D", "district": "Haaga", "city": "Helsinki", "postcode": "00300", "country": "Suomi" },
"agency": { "id": 14641782, "name": "Bo LKV | Espoo" }
}
]
},
"meta": { "endpoint_family": "search", "billable": true, "dropped_by_filter": 0 }
}
Structured data for real applications. Here are some ideas.
Track asking prices, prices per square meter and monthly rents in EUR by city, district, rooms and building type.
Page through filtered searches sorted by publish date and open each listing for fees, building data and images.
Filter new developments and build years to follow what comes to market.
Read agency profiles with address, contact data, branches and the brokers who list for them.
Oikotie scraper API
The Oikotie API is built for real-estate analytics, listing tools and market research in Finland. Each search item carries the price in EUR (rent per month), maintenance fee, living area, rooms, build year, address with coordinates, images and the listing agency. Listing detail adds heating, renovation, energy, ownership, rent terms and viewings. A missing value is null, never 0.
One search route for sale and rent.
Filters are always honoured: items that break a filter are dropped and counted in the response.
A page past the last page is an empty page, never repeated data.
A valid empty result is a successful, billable response; failures are never billed.
Pass the place triple from autocomplete, add filters and sort, then page through the results.
Open Oikotie Search API docsPass a card id from search to get fees, building data, features, viewings and all images.
Open Oikotie Listing API docsResolve a place name to the location_id, location_type and location_name that search needs.
Open Oikotie Autocomplete API docsEverything you need in one API.
/api/oikotie/search
Search Finnish properties for sale or for rent
/api/oikotie/listing
Get the full record of one listing by card id
/api/oikotie/autocomplete
Autocomplete cities, districts, streets, regions and postcodes
/api/oikotie/agency
Get an agency profile with optional brokers
See how Scrappa compares to the official API.
| Feature | Scrappa | ScrapingBee / ScraperAPI |
|---|---|---|
| Oikotie listing data as JSON | Build your own parser | |
| Sale and rent in one route | Separate scrapers | |
| Filters guaranteed on every item | Not available | |
| Price per 1k requests | From $0.20 | Varies by plan |
| Unified API key | Yes (80+ APIs) | Scraping only |
| Free tier | 500 credits/month | Trial credits only |
No. Scrappa is an independent service and is not affiliated with or endorsed by Oikotie. The Oikotie API returns structured JSON from public listing data through a Scrappa API key.
Oikotie can return a card that breaks a filter you sent. The API drops it and reports the count in meta.dropped_by_filter.
No. Oikotie has no bathrooms filter, so the API rejects the parameter with a validation error instead of ignoring it.
The API returns an empty page with has_next set to false. It never returns the first page under another page number.
No. Only successful responses are billed. A valid empty result is successful and billable.