# Swiss Estate Agencies by Live Inventory

**Use case:** 

Every Geneva rental listing with the advertising agency behind it: legal name, postal address, website, portal profile and advertising tier.

## Input

```json
{
  "operation": "search",
  "locations": [
    "Kanton Genf"
  ],
  "listingUrls": [],
  "transactionType": "rent",
  "propertyCategory": "all",
  "maxResults": 30,
  "descriptionLanguage": "original",
  "includeDetails": true,
  "minPrice": 0,
  "maxPrice": 0,
  "minRooms": 0,
  "maxRooms": 0,
  "minLivingSpace": 0,
  "maxLivingSpace": 0,
  "petsAllowed": false
}
```

## Output

```json
{
  "listingId": {
    "label": "🆔 Listing ID",
    "format": "string"
  },
  "url": {
    "label": "🔗 Listing URL",
    "format": "string"
  },
  "propertyTitle": {
    "label": "🏷️ Title",
    "format": "string"
  },
  "thumbnail": {
    "label": "🖼️ Thumbnail",
    "format": "string"
  },
  "offerType": {
    "label": "🤝 Rent or buy",
    "format": "string"
  },
  "price": {
    "label": "💰 Price (CHF)",
    "format": "number"
  },
  "priceCurrency": {
    "label": "💱 Currency",
    "format": "string"
  },
  "priceOnRequest": {
    "label": "🤫 Price on request",
    "format": "boolean"
  },
  "rentGross": {
    "label": "🏦 Gross rent / month",
    "format": "number"
  },
  "rentNet": {
    "label": "🧾 Net rent / month",
    "format": "number"
  },
  "rentExtraCosts": {
    "label": "➕ Nebenkosten / month",
    "format": "number"
  },
  "rentInterval": {
    "label": "🗓️ Rent interval",
    "format": "string"
  },
  "buyPrice": {
    "label": "🏷️ Asking price",
    "format": "number"
  },
  "pricePerSqm": {
    "label": "📊 Price per m²",
    "format": "number"
  },
  "categoryMain": {
    "label": "🏠 Category",
    "format": "string"
  },
  "categorySub": {
    "label": "🏘️ Sub-category",
    "format": "string"
  },
  "categories": {
    "label": "🗂️ All categories",
    "format": "array"
  },
  "numberOfRooms": {
    "label": "🚪 Rooms",
    "format": "number"
  },
  "livingSpace": {
    "label": "📐 Living space m²",
    "format": "number"
  },
  "totalFloorSpace": {
    "label": "📏 Total floor space m²",
    "format": "number"
  },
  "lotSize": {
    "label": "🌳 Plot m²",
    "format": "number"
  },
  "cubage": {
    "label": "🧊 Volume m³",
    "format": "number"
  },
  "ceilingHeight": {
    "label": "📶 Ceiling height m",
    "format": "number"
  },
  "floor": {
    "label": "🛗 Floor",
    "format": "number"
  },
  "numberOfFloors": {
    "label": "🏢 Floors in building",
    "format": "number"
  },
  "numberOfBathrooms": {
    "label": "🛁 Bathrooms",
    "format": "number"
  },
  "numberOfToilets": {
    "label": "🚽 Toilets",
    "format": "number"
  },
  "yearBuilt": {
    "label": "🏗️ Year built",
    "format": "number"
  },
  "yearLastRenovated": {
    "label": "🔨 Year renovated",
    "format": "number"
  },
  "isNewBuilding": {
    "label": "✨ New building",
    "format": "boolean"
  },
  "isOldBuilding": {
    "label": "🏚️ Old building",
    "format": "boolean"
  },
  "street": {
    "label": "🛣️ Street",
    "format": "string"
  },
  "postalCode": {
    "label": "📮 Postcode",
    "format": "string"
  },
  "locality": {
    "label": "🏙️ Municipality",
    "format": "string"
  },
  "canton": {
    "label": "🏳️ Canton",
    "format": "string"
  },
  "country": {
    "label": "🌍 Country",
    "format": "string"
  },
  "latitude": {
    "label": "📍 Latitude",
    "format": "number"
  },
  "longitude": {
    "label": "📍 Longitude",
    "format": "number"
  },
  "geoAccuracy": {
    "label": "🎯 Coordinate accuracy",
    "format": "string"
  },
  "geoTags": {
    "label": "🧭 Geo tags",
    "format": "array"
  },
  "descriptionText": {
    "label": "📝 Description",
    "format": "string"
  },
  "descriptionLanguage": {
    "label": "🗣️ Description language",
    "format": "string"
  },
  "descriptionIsMachineTranslated": {
    "label": "🤖 Machine-translated",
    "format": "boolean"
  },
  "availableLanguages": {
    "label": "🌐 Available languages",
    "format": "array"
  },
  "hasBalcony": {
    "label": "🌇 Balcony",
    "format": "boolean"
  },
  "hasElevator": {
    "label": "🛗 Lift",
    "format": "boolean"
  },
  "hasParking": {
    "label": "🅿️ Parking",
    "format": "boolean"
  },
  "hasGarage": {
    "label": "🚗 Garage",
    "format": "boolean"
  },
  "hasDishwasher": {
    "label": "🍽️ Dishwasher",
    "format": "boolean"
  },
  "hasWashingMachine": {
    "label": "🧺 Washing machine",
    "format": "boolean"
  },
  "hasTumbleDryer": {
    "label": "🌀 Tumble dryer",
    "format": "boolean"
  },
  "hasFireplace": {
    "label": "🔥 Fireplace",
    "format": "boolean"
  },
  "hasSwimmingPool": {
    "label": "🏊 Pool",
    "format": "boolean"
  },
  "hasChargingStation": {
    "label": "🔌 EV charger",
    "format": "boolean"
  },
  "hasNiceView": {
    "label": "🌄 Nice view",
    "format": "boolean"
  },
  "hasMountainView": {
    "label": "🏔️ Mountain view",
    "format": "boolean"
  },
  "isQuiet": {
    "label": "🤫 Quiet location",
    "format": "boolean"
  },
  "isSunny": {
    "label": "☀️ Sunny",
    "format": "boolean"
  },
  "isChildFriendly": {
    "label": "🧒 Child friendly",
    "format": "boolean"
  },
  "isWheelchairAccessible": {
    "label": "♿ Step-free",
    "format": "boolean"
  },
  "arePetsAllowed": {
    "label": "🐾 Pets allowed",
    "format": "boolean"
  },
  "isMinergieCertified": {
    "label": "🌱 Minergie certified",
    "format": "boolean"
  },
  "isMinergieGeneral": {
    "label": "🍃 Minergie standard",
    "format": "boolean"
  },
  "distancePublicTransport": {
    "label": "🚌 Metres to transport",
    "format": "number"
  },
  "distanceKindergarten": {
    "label": "🧸 Metres to nursery",
    "format": "number"
  },
  "distancePrimarySchool": {
    "label": "🏫 Metres to primary school",
    "format": "number"
  },
  "distanceHighSchool": {
    "label": "🎓 Metres to high school",
    "format": "number"
  },
  "distanceShop": {
    "label": "🛒 Metres to shop",
    "format": "number"
  },
  "distanceMotorway": {
    "label": "🛣️ Metres to motorway",
    "format": "number"
  },
  "images": {
    "label": "📸 Photos",
    "format": "array"
  },
  "imageCount": {
    "label": "🔢 Photo count",
    "format": "number"
  },
  "virtualTourUrl": {
    "label": "🕶️ Virtual tour",
    "format": "string"
  },
  "videoUrl": {
    "label": "🎬 Video",
    "format": "string"
  },
  "advertiserLogoUrl": {
    "label": "🏢 Advertiser logo",
    "format": "string"
  },
  "advertiserPackage": {
    "label": "📦 Advertiser package",
    "format": "string"
  },
  "advertiserSubscription": {
    "label": "💳 Advertiser subscription",
    "format": "string"
  },
  "advertiserIsQualityPartner": {
    "label": "⭐ Quality partner",
    "format": "boolean"
  },
  "listingTier": {
    "label": "🥇 Listing tier",
    "format": "string"
  },
  "completenessScore": {
    "label": "✅ Completeness score",
    "format": "number"
  },
  "packageScore": {
    "label": "📈 Package score",
    "format": "number"
  },
  "crossPostedPlatforms": {
    "label": "🔁 Also published on",
    "format": "array"
  },
  "newConstructionType": {
    "label": "🏗️ New-build project",
    "format": "string"
  },
  "newConstructionUrl": {
    "label": "🔗 Project website",
    "format": "string"
  },
  "publishedAt": {
    "label": "🗓️ First published",
    "format": "string"
  },
  "updatedAt": {
    "label": "🔄 Last updated",
    "format": "string"
  },
  "availableFrom": {
    "label": "🔑 Available from",
    "format": "string"
  },
  "agencyName": {
    "label": "🏛️ Agency legal name",
    "format": "string"
  },
  "agencyId": {
    "label": "🆔 Agency ID",
    "format": "string"
  },
  "agencyStreet": {
    "label": "🛣️ Agency street",
    "format": "string"
  },
  "agencyPostalCode": {
    "label": "📮 Agency postcode",
    "format": "string"
  },
  "agencyLocality": {
    "label": "🏙️ Agency town",
    "format": "string"
  },
  "agencyWebsite": {
    "label": "🌐 Agency website",
    "format": "string"
  },
  "agencyProfileUrl": {
    "label": "👤 Agency profile",
    "format": "string"
  },
  "referenceId": {
    "label": "#️⃣ Advertiser reference",
    "format": "string"
  },
  "egid": {
    "label": "🏢 EGID (building register)",
    "format": "string"
  },
  "egrid": {
    "label": "🗺️ EGRID (property register)",
    "format": "string"
  },
  "searchLocation": {
    "label": "📍 Searched location",
    "format": "string"
  },
  "searchUrl": {
    "label": "🔎 Search URL",
    "format": "string"
  },
  "resultPage": {
    "label": "📄 Result page",
    "format": "number"
  },
  "scrapedAt": {
    "label": "⏱️ Read at",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [ImmoScout24.ch Scraper — Switzerland Property Listings](https://apify.com/sian.agency/immoscout24-ch-property-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/sian.agency/immoscout24-ch-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/immoscout24-ch-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).