# Swiss Rentals Scraper — Flatfox, Newhome & Homegate (`muhammadafzal/swiss-rentals-scraper`) Actor Scrape public Swiss rental listings from Flatfox, Newhome and Homegate. Get rent, costs, rooms, living area, address, availability, images and source URLs for relocation research and AI agents. No login required. - **URL**: https://apify.com/muhammadafzal/swiss-rentals-scraper.md - **Developed by:** [Muhammad Afzal](https://apify.com/muhammadafzal) (community) - **Categories:** Real estate, Lead generation, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 rental listings This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use 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 ## Swiss Rentals Scraper — Flatfox, Newhome & Homegate Scrape public rental listings across Switzerland from Flatfox, Newhome and Homegate. Provide one or more public search URLs, or direct listing URLs, and receive normalized JSON records for market research, rental monitoring, relocation workflows and AI-agent pipelines. The actor extracts the public fields that portals commonly expose: listing title, URL, portal, address/locality, postal code, net rent, additional costs, gross rent, currency, rooms, living area, floor, availability, description and image URLs. Missing fields are returned as `null`; images and warnings are always arrays for stable downstream processing. ### Supported portals - Flatfox (`flatfox.ch`) — search pages and public `/flat/` listings. - Newhome (`newhome.ch`) — public rental search and property pages. - Homegate (`homegate.ch`) — public rental search and property pages. The actor does not log in, access private applications, bypass account controls, collect tenant data, or retrieve private advertiser information. Use only where your collection and downstream use are authorized by the portal terms and applicable Swiss privacy, copyright and database laws. ### Input ```json { "startUrls": [ { "url": "https://flatfox.ch/c/en/" }, { "url": "https://www.homegate.ch/en" } ], "maxResults": 20, "enrichDetails": true, "proxyCountry": "CH" } ```` `startUrls` accepts public search, category, results and direct listing URLs. The default Flatfox homepage is a safe prefill for the Apify health test; for useful data, paste a portal search URL with your desired location and filters. `maxResults` is a hard run-wide cap. `enrichDetails` opens discovered listing pages for fuller fields. Residential Switzerland proxy sessions are enabled by default; choose `none` for local parser testing. ### Output example ```json { "source": "Flatfox", "listingUrl": "https://flatfox.ch/en/flat/8041-zurich/86056757/", "title": "Rent a 2 ½ rooms apartment in Zürich", "propertyType": "Apartment", "address": "Zürich", "postalCode": "8041", "locality": "Zürich", "rent": 1850, "additionalCosts": 250, "grossRent": 2100, "currency": "CHF", "rooms": 2.5, "livingAreaM2": 62, "floor": "2", "availableFrom": "01.09.2026", "description": "Public listing description...", "imageUrls": ["https://cdn.example/image.jpg"], "scrapedAt": "2026-07-16T12:00:00.000Z", "warnings": [] } ``` ### Reliability and billing The browser uses low concurrency, persistent session cookies, retries and Swiss residential proxy routing. The parser uses JSON-LD plus visible page content and listing links; when a page changes, the run preserves valid partial records and writes diagnostics to `OUTPUT` instead of inventing values. Portal pages may rate-limit or challenge automated traffic, so an empty result set is not proof that no rentals exist. The intended pay-per-event price is `$0.005` per schema-valid listing returned, plus Apify platform usage. The actor charges only after writing a valid dataset item and never charges beyond `maxResults`. Local runs do not create platform charges. ### API and MCP ```javascript const run = await client.actor('YOUR_USERNAME/swiss-rentals-scraper').call({ startUrls: [{ url: 'https://flatfox.ch/c/en/' }], maxResults: 25, enrichDetails: true }); ``` The stable flat record shape is suitable for Apify API, datasets, webhooks, Make/Zapier workflows and Apify MCP. Use concise inputs and a small `maxResults` when an AI agent needs a quick shortlist. ### Limitations Portal search URLs and HTML structures change over time, and some results can be rendered only after JavaScript executes. Search pages with no public listing links return a truthful warning in `OUTPUT`. The actor intentionally avoids login-only listings, contact harvesting beyond public page text, and any claim that the returned inventory is complete. # Actor input Schema ## `startUrls` (type: `array`): Use this when you have public Flatfox, Newhome or Homegate rental search or listing URLs. The actor follows listing links found on search pages and also accepts direct listing pages. ## `maxResults` (type: `integer`): Use this to cap returned rental listings and billable result events. The cap applies across all start URLs. ## `enrichDetails` (type: `boolean`): Use this when you want fuller public details from each listing page, including description, features, contact text and images. Disable for a faster link/card crawl. ## `proxyCountry` (type: `string`): Use this to select the Apify residential proxy country for Swiss sites. Switzerland is the default; choose none only for local parser testing. ## Actor input object example ```json { "startUrls": [ { "url": "https://flatfox.ch/c/en/" } ], "maxResults": 20, "enrichDetails": true, "proxyCountry": "CH" } ``` # Actor output Schema ## `results` (type: `string`): Structured rental records in the default dataset. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://flatfox.ch/c/en/" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("muhammadafzal/swiss-rentals-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://flatfox.ch/c/en/" }] } # Run the Actor and wait for it to finish run = client.actor("muhammadafzal/swiss-rentals-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://flatfox.ch/c/en/" } ] }' | apify call muhammadafzal/swiss-rentals-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=muhammadafzal/swiss-rentals-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Swiss Rentals Scraper — Flatfox, Newhome & Homegate", "description": "Scrape public Swiss rental listings from Flatfox, Newhome and Homegate. Get rent, costs, rooms, living area, address, availability, images and source URLs for relocation research and AI agents. No login required.", "version": "0.1", "x-build-id": "y0dvchGEIiSI26U1q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/muhammadafzal~swiss-rentals-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-muhammadafzal-swiss-rentals-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/muhammadafzal~swiss-rentals-scraper/runs": { "post": { "operationId": "runs-sync-muhammadafzal-swiss-rentals-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/muhammadafzal~swiss-rentals-scraper/run-sync": { "post": { "operationId": "run-sync-muhammadafzal-swiss-rentals-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Use this when you have public Flatfox, Newhome or Homegate rental search or listing URLs. The actor follows listing links found on search pages and also accepts direct listing pages.", "default": [ { "url": "https://flatfox.ch/c/en/" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Use this to cap returned rental listings and billable result events. The cap applies across all start URLs.", "default": 20 }, "enrichDetails": { "title": "Open listing details", "type": "boolean", "description": "Use this when you want fuller public details from each listing page, including description, features, contact text and images. Disable for a faster link/card crawl.", "default": true }, "proxyCountry": { "title": "Proxy country", "enum": [ "CH", "none" ], "type": "string", "description": "Use this to select the Apify residential proxy country for Swiss sites. Switzerland is the default; choose none only for local parser testing.", "default": "CH" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```