# Rental Apartments in Helsinki

**Use case:** 

Export live Helsinki rental listings: monthly rent, m2, rooms, floor, build year, district, coordinates, photos and the letting agency. CSV, JSON or Excel.

## Input

```json
{
  "operation": "search",
  "section": "homesForRent",
  "locations": [
    "Helsinki"
  ],
  "sortBy": "newest",
  "maxResults": 30,
  "minPrice": 0,
  "maxPrice": 0,
  "minSizeSqm": 0,
  "maxSizeSqm": 0,
  "rooms": "any",
  "propertyType": "any",
  "minYearBuilt": 0,
  "maxYearBuilt": 0,
  "newDevelopmentOnly": false,
  "fullDetails": false,
  "listingUrls": [
    "https://asunnot.oikotie.fi/myytavat-asunnot/helsinki/24678422"
  ],
  "agencyQuery": ""
}
```

## Output

```json
{
  "listingId": {
    "label": "🆔 Listing ID",
    "format": "number"
  },
  "listingUrl": {
    "label": "🔗 Listing URL",
    "format": "string"
  },
  "headline": {
    "label": "🏷️ Headline",
    "format": "string"
  },
  "section": {
    "label": "🏘️ Section",
    "format": "string"
  },
  "propertyType": {
    "label": "🏗️ Building type",
    "format": "string"
  },
  "imageUrl": {
    "label": "🖼️ Photo",
    "format": "string"
  },
  "priceText": {
    "label": "🏷️ Price as shown",
    "format": "string"
  },
  "priceEur": {
    "label": "💶 Debt-free price (€)",
    "format": "number"
  },
  "sellingPriceEur": {
    "label": "💰 Selling price (€)",
    "format": "number"
  },
  "shareOfDebtEur": {
    "label": "🧾 Share of debt (€)",
    "format": "number"
  },
  "rentPerMonthEur": {
    "label": "🔑 Rent (€/month)",
    "format": "number"
  },
  "pricePerSqmEur": {
    "label": "📊 Price per m² (€)",
    "format": "number"
  },
  "sizeSqm": {
    "label": "📏 Living area (m²)",
    "format": "number"
  },
  "lotSizeSqm": {
    "label": "🟩 Lot area (m²)",
    "format": "number"
  },
  "rooms": {
    "label": "🚪 Rooms",
    "format": "number"
  },
  "roomLayout": {
    "label": "🧭 Room layout",
    "format": "string"
  },
  "streetAddress": {
    "label": "📍 Street address",
    "format": "string"
  },
  "district": {
    "label": "🗺️ District",
    "format": "string"
  },
  "city": {
    "label": "🏙️ City",
    "format": "string"
  },
  "postalCode": {
    "label": "📮 Postcode",
    "format": "string"
  },
  "region": {
    "label": "🌍 Region",
    "format": "string"
  },
  "latitude": {
    "label": "📌 Latitude",
    "format": "number"
  },
  "longitude": {
    "label": "📌 Longitude",
    "format": "number"
  },
  "buildYear": {
    "label": "📅 Year built",
    "format": "number"
  },
  "floor": {
    "label": "🪜 Floor",
    "format": "number"
  },
  "floorCount": {
    "label": "🏢 Floors in building",
    "format": "number"
  },
  "newDevelopment": {
    "label": "🏗️ New development",
    "format": "boolean"
  },
  "publishedAt": {
    "label": "🕒 Published",
    "format": "string"
  },
  "priceChangedAt": {
    "label": "📉 Price changed",
    "format": "string"
  },
  "nextViewingDate": {
    "label": "👀 Next viewing",
    "format": "string"
  },
  "nextViewingTime": {
    "label": "⏰ Viewing time",
    "format": "string"
  },
  "viewsTotal": {
    "label": "👁️ Views",
    "format": "number"
  },
  "viewsWeekly": {
    "label": "📈 Views this week",
    "format": "number"
  },
  "agentName": {
    "label": "🧑‍💼 Agent",
    "format": "string"
  },
  "agentPhone": {
    "label": "📞 Agent phone",
    "format": "string"
  },
  "agentTitle": {
    "label": "🎓 Agent title",
    "format": "string"
  },
  "agentPhotoUrl": {
    "label": "🖼️ Agent photo",
    "format": "string"
  },
  "agencyName": {
    "label": "🏢 Agency",
    "format": "string"
  },
  "agencyOfficialName": {
    "label": "🏛️ Agency legal name",
    "format": "string"
  },
  "agencyPhone": {
    "label": "☎️ Agency phone",
    "format": "string"
  },
  "agencyEmail": {
    "label": "📧 Agency email",
    "format": "string"
  },
  "agencyWebsite": {
    "label": "🌐 Agency website",
    "format": "string"
  },
  "agencyAddress": {
    "label": "🏠 Agency address",
    "format": "string"
  },
  "agencyCity": {
    "label": "🏙️ Agency city",
    "format": "string"
  },
  "agencyPostalCode": {
    "label": "📮 Agency postcode",
    "format": "string"
  },
  "agencyBusinessId": {
    "label": "🧾 Agency business ID",
    "format": "string"
  },
  "agencyGroupName": {
    "label": "🏛️ Agency group",
    "format": "string"
  },
  "agencyProfileUrl": {
    "label": "🔗 Agency profile",
    "format": "string"
  },
  "agencyLogoUrl": {
    "label": "🖼️ Agency logo",
    "format": "string"
  },
  "agencyOfficeId": {
    "label": "🆔 Agency office ID",
    "format": "number"
  },
  "descriptionText": {
    "label": "📝 Description",
    "format": "string"
  },
  "maintenanceFeeEur": {
    "label": "🧹 Maintenance fee (€/mo)",
    "format": "number"
  },
  "financialFeeEur": {
    "label": "🏦 Financial fee (€/mo)",
    "format": "number"
  },
  "waterFeeEur": {
    "label": "🚿 Water fee (€/mo)",
    "format": "number"
  },
  "energyClass": {
    "label": "⚡ Energy class",
    "format": "string"
  },
  "heating": {
    "label": "🔥 Heating",
    "format": "string"
  },
  "ventilation": {
    "label": "💨 Ventilation",
    "format": "string"
  },
  "buildingMaterial": {
    "label": "🧱 Building material",
    "format": "string"
  },
  "roofType": {
    "label": "🏠 Roof",
    "format": "string"
  },
  "lotOwnership": {
    "label": "🟩 Lot ownership",
    "format": "string"
  },
  "housingCompanyName": {
    "label": "🏛️ Housing company",
    "format": "string"
  },
  "housingCompanyBusinessId": {
    "label": "🧾 Housing company ID",
    "format": "string"
  },
  "renovationsDone": {
    "label": "🔨 Renovations done",
    "format": "string"
  },
  "renovationsPlanned": {
    "label": "📋 Renovations planned",
    "format": "string"
  },
  "availability": {
    "label": "🚚 Available",
    "format": "string"
  },
  "hasSauna": {
    "label": "🧖 Sauna",
    "format": "boolean"
  },
  "hasLift": {
    "label": "🛗 Lift",
    "format": "boolean"
  },
  "hasBalcony": {
    "label": "🌤️ Balcony",
    "format": "boolean"
  },
  "parkingInfo": {
    "label": "🅿️ Parking",
    "format": "string"
  },
  "kitchenAppliances": {
    "label": "🍳 Kitchen",
    "format": "string"
  },
  "storageInfo": {
    "label": "📦 Storage",
    "format": "string"
  },
  "photoUrls": {
    "label": "🖼️ All photos",
    "format": "array"
  },
  "photoCount": {
    "label": "🔢 Photo count",
    "format": "number"
  }
}
```

## About this Actor

This example demonstrates how to use [Oikotie Property Scraper](https://apify.com/sian.agency/oikotie-property-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/sian.agency/oikotie-property-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/sian.agency/oikotie-property-scraper.md

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).