# ImmoScout24.ch Commercial Scraper — Swiss Offices & Gewerbe (`studio-amba/immoscout24-ch-commercial-scraper`) Actor

Scrape commercial property listings from immoscout24.ch (Switzerland): offices, Gewerbe, storage and building land. Rent and sale, CHF prices with per-m² units, surfaces, addresses and coordinates.

- **URL**: https://apify.com/studio-amba/immoscout24-ch-commercial-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **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 usage examples, see the [API](#api) section below.

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).

# README

## ImmoScout24.ch Commercial Scraper

Scrape commercial real estate listings from [immoscout24.ch](https://www.immoscout24.ch), Switzerland's largest property portal (SMG Swiss Marketplace Group). Offices, Gewerbe, storage and building land, for rent and for sale, across all 26 cantons.

This is the Swiss platform. It is a different company and a different website than German immobilienscout24.de.

### What you get

Structured JSON for every listing: title, description, CHF price with its exact unit (commercial rents are usually quoted per m² per year), gross and net rent, surfaces, full address with coordinates, canton, category tags, photos and the listing URL.

Price on application (Preis auf Anfrage) is common in commercial real estate. Those listings keep `price: null`. The scraper never invents a number.

### Use cases

- Track office and retail rents per m² across Swiss cities
- Build a pipeline of available commercial spaces for a relocation or expansion search
- Monitor building land (Bauland) supply and asking prices per canton
- Feed availability data into brokerage, valuation or market research tools
- Watch commercial supply in a specific city or canton over time

### How to scrape ImmoScout24.ch data

1. Pick a location. Swiss city or canton names work in German, French or Italian spelling: `Zürich`, `Genève`, `Lugano`, `Bern`, `Basel`, `Waadt`.
2. Pick a segment and listing type (rent or sale).
3. Set `maxResults` and run. The scraper resolves the location, walks the result pages (20 listings per page) and pushes each listing as one dataset item.

The site's anti-bot protection (DataDome) is handled automatically by the built-in unlocking service. You do not need to configure anything for it.

#### Example: offices for rent in Zürich

```json
{
    "searchQuery": "Zürich",
    "segment": "office",
    "listingType": "rent",
    "maxResults": 100
}
```

#### Example: building land for sale in Bern

```json
{
    "searchQuery": "Bern",
    "segment": "land",
    "listingType": "sale",
    "maxResults": 50
}
```

#### Example: storage space in Geneva, French spelling

```json
{
    "searchQuery": "Genève",
    "segment": "storage",
    "listingType": "rent",
    "maxResults": 50
}
```

#### Example: your own filtered search URL

Set filters on immoscout24.ch (price band, surface, subtypes) and paste the result URL:

```json
{
    "startUrls": [{ "url": "https://www.immoscout24.ch/de/buero-gewerbe-industrie/mieten/kanton-zuerich?pf=100&pt=400" }],
    "maxResults": 200
}
```

### Output example

```json
{
    "id": "4003298932",
    "title": "Moderne Bürofläche an zentraler Lage",
    "description": "Per sofort oder nach Vereinbarung vermieten wir diese helle Bürofläche...",
    "segment": "office",
    "listingType": "rent",
    "categories": ["OFFICE"],
    "price": 280,
    "currency": "CHF",
    "priceUnit": "CHF/m²/Jahr",
    "grossPrice": 280,
    "netPrice": 280,
    "surface": 383,
    "totalFloorSpace": 383,
    "singleFloorSpace": null,
    "lotSize": null,
    "floor": 1,
    "yearBuilt": 2008,
    "street": "Hardturmstrasse 101",
    "postalCode": "8005",
    "city": "Zürich",
    "canton": "ZH",
    "latitude": 47.39,
    "longitude": 8.51,
    "agencyLogoUrl": "https://cdn.immoscout24.ch/logos/l_h318415_example.png",
    "language": "de",
    "imageUrl": "https://cdn.immoscout24.ch/listings/v2/.../image/....jpg",
    "imageUrls": ["https://cdn.immoscout24.ch/listings/v2/.../image/....jpg"],
    "createdAt": "2026-08-05T15:30:09.565Z",
    "url": "https://www.immoscout24.ch/mieten/4003298932",
    "source": "immoscout24.ch",
    "scrapedAt": "2026-08-18T12:00:00.000Z"
}
```

### Price units explained

Swiss commercial listings quote prices in several ways. The `priceUnit` field always tells you which one you are looking at:

| priceUnit | Meaning | Typical for |
|---|---|---|
| `CHF/m²/Jahr` | Rent per m² per year | Offices, retail, industrial |
| `CHF/Monat` | Total rent per month | Small units, storage rooms |
| `CHF` | Purchase price | Sale listings, building land |
| `CHF/m²` | Purchase price per m² | Some land listings |
| `null` | Price on application | Common across the vertical |

`grossPrice` and `netPrice` carry Brutto- and Nettomiete in the same unit where the lister published both.

### Input reference

| Field | Type | Description |
|---|---|---|
| `searchQuery` | string | Swiss city or canton (DE/FR/IT spelling). Empty = Kanton Zürich |
| `segment` | string | `office`, `commercial`, `storage`, `land` or `all` |
| `listingType` | string | `rent` or `sale` |
| `startUrls` | array | Full immoscout24.ch search URLs, overrides the fields above |
| `maxResults` | integer | Cap on returned listings (default 100) |
| `brightDataApiKey` | string | Optional own unlocker key, normally leave empty |
| `proxyConfiguration` | object | Not used for fetching, kept for platform compatibility |

Segment notes: the segments follow the site's own search routes. For sale listings the site has one shared commercial route, so `office`, `commercial`, `storage` and `all` return the same sale results (use the `categories` field to filter). Building land (`land`) is sale-only on the site.

### Cost of usage

You pay per result plus a small run start fee. One fetched page yields 20 listings, so a 100-listing run needs about 5 page fetches and typically finishes in under a minute. As a rule of thumb, expect roughly $0.02 per result including compute at default settings.

A run's usage cost only settles after the run reports SUCCEEDED. Reading the dataset mid-run shows a partial cost that can be far lower than the final one.

### Good to know

- The site serves at most 1000 results per search. Searches over that cap get a log warning; split by city or segment for full coverage.
- Listings are deduplicated by listing ID within a run, also across multiple start URLs.
- The listing's own `offerType` decides `listingType` in the output, so a mixed start URL still labels every row correctly.
- Listing text comes in the lister's primary language (`language` field: de, fr, it or en).
- Long runs survive platform migrations: the scraper resumes from the last completed page instead of restarting.

### Legality

This scraper reads only publicly available listing data, the same information any visitor sees in a browser. It stores no personal data beyond what listers publish themselves (agency names and business contact details). For commercial reuse of the data, check the portal's terms and applicable law in your jurisdiction.

# Actor input Schema

## `searchQuery` (type: `string`):

Swiss city or canton to search. German, French or Italian spellings all work (e.g. 'Zürich', 'Genève', 'Lugano', 'Bern', 'Basel', 'Waadt'). Leave empty to search Kanton Zürich. For district-level searches, paste a full search URL into Start URLs instead.

## `segment` (type: `string`):

Which commercial segment to search. Segments follow the site's own search routes. Note: for SALE listings the site has one shared commercial route, so office/commercial/storage/all return the same sale results (filter by the 'categories' output field); building land is sale-only.

## `listingType` (type: `string`):

Rent (Mieten) or buy (Kaufen). Building land is always searched as buy — the site does not list land for rent.

## `startUrls` (type: `array`):

ImmoScout24.ch search result URLs, as an alternative to the Location field. Go to immoscout24.ch, set your filters, and paste the resulting URL(s) (e.g. https://www.immoscout24.ch/de/buero-gewerbe-industrie/mieten/ort-zuerich). Overrides Location/Segment/Listing Type when provided.

## `maxResults` (type: `integer`):

Hard cap on the number of listings returned (20 listings per fetched page). The site serves at most 1000 results per search — narrow the location or segment for full coverage of large searches.

## `brightDataApiKey` (type: `string`):

Optional: your own Bright Data API key for the Web Unlocker zone. Leave empty to use the built-in unlocking service.

## `proxyConfiguration` (type: `object`):

Not used for fetching — ImmoScout24.ch's DataDome anti-bot is handled automatically by the built-in unlocking service (recon proved no Apify proxy route works, see docs/site-recon/immoscout24-ch-commercial.md). Kept for platform compatibility.

## Actor input object example

```json
{
  "searchQuery": "Zürich",
  "segment": "office",
  "listingType": "rent",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "Zürich",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/immoscout24-ch-commercial-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQuery": "Zürich",
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/immoscout24-ch-commercial-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQuery": "Zürich",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/immoscout24-ch-commercial-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/immoscout24-ch-commercial-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/rXpHWhB8CXlqfmoAx/builds/PbP7FgwPbmIaZ3EX2/openapi.json