# Homegate Scraper (beta) (`covassoftware/homegate-scraper-beta`) Actor Scrape real estate listings from Homegate.ch — Switzerland's largest property marketplace. Extract rentals & purchases with filters for location, price, rooms. Clean JSON output with prices, addresses, coordinates, images. Pagination & anti-detection built in. - **URL**: https://apify.com/covassoftware/homegate-scraper-beta.md - **Developed by:** [Miguel Covas](https://apify.com/covassoftware) (community) - **Categories:** Real estate, E-commerce, Other - **Stats:** 20 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## Homegate.ch Property Scraper Extract comprehensive real estate data from [Homegate.ch](https://www.homegate.ch), Switzerland's largest property marketplace with 100,000+ active listings. ### What does it do? This actor scrapes property listings from Homegate.ch — both **rental** and **purchase** listings across all Swiss cantons. It supports three modes: - **Search mode**: Discover listings by location, price, rooms, property type - **Details mode**: Extract full details from specific listing URLs - **Full mode**: Search + automatically fetch full details for each result Get structured JSON output with all listing data: prices, locations, property characteristics, images, agent info, travel times, and more. ### Why use this actor? - 🏠 **Complete data** — Extracts ALL available fields (50+ data points per listing) - 🔍 **Smart search** — Filter by city, canton, ZIP, price range, rooms, property type - 🌍 **Multi-language** — Output in German, French, Italian, or English - 📊 **Clean JSON** — Normalized, analysis-ready output format - ⚡ **Fast & reliable** — Concurrent scraping with automatic retry and proxy rotation - 🔄 **Deduplication** — Track changes across runs, skip already-scraped listings ### Input ```json { "mode": "full", "offerType": "rent", "locations": ["zurich", "bern"], "propertyType": "apartment", "priceMin": 1000, "priceMax": 3000, "roomsMin": 2, "roomsMax": 4, "livingSpaceMin": 50, "maxPages": 10, "maxItems": 200, "language": "en", "sortBy": "dateCreated-desc", "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "CH" } } ```` #### Input fields | Field | Type | Required | Description | |-------|------|----------|-------------| | `mode` | string | No | `"search"`, `"details"`, or `"full"` (default: `"full"`) | | `offerType` | string | Yes | `"rent"` or `"buy"` | | `locations` | string\[] | Yes\* | City names, cantons, or ZIP codes (e.g., `["zurich", "8001"]`) | | `urls` | string\[] | Yes\* | Direct listing or search page URLs (alternative to locations) | | `propertyType` | string | No | `"apartment"`, `"house"`, or `"all"` (default: `"all"`) | | `priceMin` | number | No | Minimum price (CHF) | | `priceMax` | number | No | Maximum price (CHF) | | `roomsMin` | number | No | Minimum rooms (supports .5, e.g., `2.5`) | | `roomsMax` | number | No | Maximum rooms | | `livingSpaceMin` | number | No | Minimum living space (m²) | | `livingSpaceMax` | number | No | Maximum living space (m²) | | `maxPages` | number | No | Max search pages to scrape (default: all) | | `maxItems` | number | No | Max total items to return (default: unlimited) | | `language` | string | No | Output language: `"de"`, `"en"`, `"fr"`, `"it"` (default: `"de"`) | | `sortBy` | string | No | Sort order (default: `"dateCreated-desc"`) | | `proxy` | object | No | Proxy configuration (recommended: Swiss residential) | | `maxRetries` | number | No | Max retries per request (default: 3) | | `requestDelay` | number | No | Delay between requests in ms (default: 2000) | \*Either `locations` or `urls` must be provided. ### Output Each listing is output as a clean JSON object: ```json { "id": "4002421549", "url": "https://www.homegate.ch/rent/4002421549", "offerType": "RENT", "categories": ["APARTMENT", "ATTIC_FLAT"], "title": "Sunny attic apartment in Dübendorf", "description": "We rent out this beautiful and modern 3.5-room attic apartment...", "price": { "amount": 4540, "currency": "CHF", "interval": "MONTH", "area": "ALL" }, "characteristics": { "livingSpace": 160, "numberOfRooms": 3.5, "floor": 4, "hasBalcony": true, "hasElevator": false, "hasNiceView": false, "isQuiet": false, "yearBuilt": null, "yearLastRenovated": null, "hasGarage": false }, "address": { "street": "Überlandstrasse 198", "postalCode": "8600", "locality": "Dübendorf", "region": "ZH", "country": "CH", "latitude": 47.401134, "longitude": 8.621861 }, "images": [ { "url": "https://media2.homegate.ch/listings/...", "title": "Aussenansicht" } ], "documents": [ { "url": "https://media2.homegate.ch/listings/...", "title": "Grundriss.pdf" } ], "lister": { "name": "Schaeppi Grundstücke AG", "phone": "+41 44 456 57 67", "website": "http://www.schaeppi.ch", "contactPerson": "Marc Schweizer" }, "availableFrom": "2025-08-13", "createdAt": "2025-08-06T16:28:59.491Z", "updatedAt": "2025-08-13T05:34:36.853Z", "platforms": ["homegate", "immoscout24", "alleimmobilien"], "travelTimes": { "pharmacy": { "time": 358, "name": "Amavita Apotheke Dübendorf" }, "supermarket": { "time": 189, "name": "Hangar" }, "school": { "time": 398, "name": "Primarschule" }, "station": { "time": 160, "name": "Dübendorf Bahnhof Nord" } }, "listingType": "PREMIUM", "scrapedAt": "2026-02-02T10:00:00.000Z" } ``` ### Usage Examples #### Find apartments to rent in Zurich under 2500 CHF ```json { "mode": "full", "offerType": "rent", "locations": ["zurich"], "propertyType": "apartment", "priceMax": 2500, "roomsMin": 2 } ``` #### Scrape all houses for sale in Canton Bern ```json { "mode": "search", "offerType": "buy", "locations": ["canton-bern"], "propertyType": "house", "maxPages": 50 } ``` #### Get details for specific listings ```json { "mode": "details", "urls": [ "https://www.homegate.ch/rent/4002421549", "https://www.homegate.ch/rent/4002408298", "https://www.homegate.ch/buy/3003548501" ] } ``` #### Monitor new listings in Geneva (run daily via schedule) ```json { "mode": "full", "offerType": "rent", "locations": ["geneva"], "propertyType": "apartment", "priceMax": 3000, "roomsMin": 3, "sortBy": "dateCreated-desc", "maxPages": 3 } ``` ### Supported Property Types **Apartments:** Flat, Studio, Loft, Maisonette, Duplex, Attic Flat, Roof Flat, Terrace Flat, Bachelor Flat, Single Room **Houses:** Single House, Row House, Terrace House, Villa, Chalet, Rustico, Farm House, Bifamiliar House ### Swiss Cantons & Locations Works with all 26 Swiss cantons and all municipalities. Locations can be specified as: - City names: `"zurich"`, `"bern"`, `"geneva"`, `"lausanne"` - Cantons: `"canton-zurich"`, `"canton-bern"` - ZIP codes: `"8001"`, `"3000"` - Regions: `"region-bern-mittelland"` ### Tips for Best Results 1. **Use Swiss residential proxies** — Set `apifyProxyCountry: "CH"` for best success rate 2. **Don't rush** — Keep `requestDelay` at 2000ms+ to avoid rate limiting 3. **Use `full` mode** — Gets both search summaries and complete listing details 4. **Schedule runs** — Set up a daily schedule to monitor new listings 5. **Start small** — Test with `maxItems: 10` before doing large scrapes ### Pricing This actor uses Apify platform resources. Typical costs: - \~20 listings per minute in `full` mode - \~100 listings per minute in `search` mode - Residential proxy usage is the main cost driver - Approximately **$1-2 per 1,000 listings** (varies with proxy usage) ### Disclaimer This actor is provided as a tool for data extraction. Users are responsible for ensuring their use complies with Homegate.ch's [terms of service](https://www.homegate.ch/c/en/about-us/legal-issues/disclaimer) and applicable laws. The actor should be used responsibly with appropriate rate limiting to avoid disrupting the platform. ### Feedback & Support Found a bug or have a feature request? Please open an issue on the [Issues tab](../../issues). We actively maintain this actor and welcome feedback. # Actor input Schema ## `mode` (type: `string`): search = list results only (fast, less data). details = full data from specific URLs. full = search + auto-fetch complete details for each listing. ## `offerType` (type: `string`): Whether to scrape rental or purchase listings. ## `locations` (type: `array`): City names, cantons, ZIP codes, or regions to search. Examples: 'zurich', 'canton-bern', '8001', 'region-bern-mittelland'. ## `urls` (type: `array`): Specific Homegate listing or search page URLs. Use this instead of locations for precise control. ## `propertyType` (type: `string`): Filter by property category. ## `priceMin` (type: `integer`): Minimum price in CHF. For rent = monthly rent, for buy = purchase price. ## `priceMax` (type: `integer`): Maximum price in CHF. ## `roomsMin` (type: `number`): Minimum number of rooms. Swiss convention supports .5 increments (e.g., 2.5 = 2 rooms + kitchen). ## `roomsMax` (type: `number`): Maximum number of rooms. ## `livingSpaceMin` (type: `integer`): Minimum living space in square meters. ## `livingSpaceMax` (type: `integer`): Maximum living space in square meters. ## `maxPages` (type: `integer`): Maximum number of search result pages to scrape. 0 = scrape all available pages. ## `maxItems` (type: `integer`): Maximum total listings to return. 0 = unlimited. ## `language` (type: `string`): Language for title and description fields. Most listings are originally in German; other languages may be machine-translated. ## `sortBy` (type: `string`): How to sort search results. Only affects search mode. ## `proxy` (type: `object`): Swiss residential proxies are strongly recommended for reliable scraping. Datacenter proxies will likely be blocked by Cloudflare. ## `maxRetries` (type: `integer`): Maximum retry attempts per failed request. ## `requestDelay` (type: `integer`): Minimum delay between requests in milliseconds. Lower values = faster but higher block risk. ## Actor input object example ```json { "mode": "search", "offerType": "rent", "locations": [ "zurich" ], "propertyType": "all", "maxPages": 1, "maxItems": 10, "language": "de", "sortBy": "dateCreated-desc", "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "CH" }, "maxRetries": 3, "requestDelay": 1000 } ``` # 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 = { "locations": [ "zurich" ], "maxPages": 1, "maxItems": 10, "requestDelay": 1000 }; // Run the Actor and wait for it to finish const run = await client.actor("covassoftware/homegate-scraper-beta").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 = { "locations": ["zurich"], "maxPages": 1, "maxItems": 10, "requestDelay": 1000, } # Run the Actor and wait for it to finish run = client.actor("covassoftware/homegate-scraper-beta").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 '{ "locations": [ "zurich" ], "maxPages": 1, "maxItems": 10, "requestDelay": 1000 }' | apify call covassoftware/homegate-scraper-beta --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=covassoftware/homegate-scraper-beta", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Homegate Scraper (beta)", "description": "Scrape real estate listings from Homegate.ch — Switzerland's largest property marketplace. Extract rentals & purchases with filters for location, price, rooms. Clean JSON output with prices, addresses, coordinates, images. Pagination & anti-detection built in.", "version": "1.0", "x-build-id": "3cwMlOVCBqXqMSbVQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/covassoftware~homegate-scraper-beta/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-covassoftware-homegate-scraper-beta", "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/covassoftware~homegate-scraper-beta/runs": { "post": { "operationId": "runs-sync-covassoftware-homegate-scraper-beta", "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/covassoftware~homegate-scraper-beta/run-sync": { "post": { "operationId": "run-sync-covassoftware-homegate-scraper-beta", "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", "required": [ "offerType" ], "properties": { "mode": { "title": "Scraping Mode", "enum": [ "search", "details", "full" ], "type": "string", "description": "search = list results only (fast, less data). details = full data from specific URLs. full = search + auto-fetch complete details for each listing.", "default": "search" }, "offerType": { "title": "Offer Type", "enum": [ "rent", "buy" ], "type": "string", "description": "Whether to scrape rental or purchase listings.", "default": "rent" }, "locations": { "title": "Locations", "type": "array", "description": "City names, cantons, ZIP codes, or regions to search. Examples: 'zurich', 'canton-bern', '8001', 'region-bern-mittelland'.", "items": { "type": "string" }, "default": [ "zurich" ] }, "urls": { "title": "Direct URLs", "type": "array", "description": "Specific Homegate listing or search page URLs. Use this instead of locations for precise control.", "items": { "type": "string" } }, "propertyType": { "title": "Property Type", "enum": [ "all", "apartment", "house" ], "type": "string", "description": "Filter by property category.", "default": "all" }, "priceMin": { "title": "Min Price (CHF)", "minimum": 0, "type": "integer", "description": "Minimum price in CHF. For rent = monthly rent, for buy = purchase price." }, "priceMax": { "title": "Max Price (CHF)", "minimum": 0, "type": "integer", "description": "Maximum price in CHF." }, "roomsMin": { "title": "Min Rooms", "minimum": 1, "type": "number", "description": "Minimum number of rooms. Swiss convention supports .5 increments (e.g., 2.5 = 2 rooms + kitchen)." }, "roomsMax": { "title": "Max Rooms", "minimum": 1, "type": "number", "description": "Maximum number of rooms." }, "livingSpaceMin": { "title": "Min Living Space (m²)", "minimum": 0, "type": "integer", "description": "Minimum living space in square meters." }, "livingSpaceMax": { "title": "Max Living Space (m²)", "minimum": 0, "type": "integer", "description": "Maximum living space in square meters." }, "maxPages": { "title": "Max Pages", "minimum": 0, "type": "integer", "description": "Maximum number of search result pages to scrape. 0 = scrape all available pages.", "default": 1 }, "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum total listings to return. 0 = unlimited.", "default": 10 }, "language": { "title": "Output Language", "enum": [ "de", "en", "fr", "it" ], "type": "string", "description": "Language for title and description fields. Most listings are originally in German; other languages may be machine-translated.", "default": "de" }, "sortBy": { "title": "Sort Order", "enum": [ "dateCreated-desc", "dateCreated-asc", "resultingSearchablePrice-asc", "resultingSearchablePrice-desc" ], "type": "string", "description": "How to sort search results. Only affects search mode.", "default": "dateCreated-desc" }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "Swiss residential proxies are strongly recommended for reliable scraping. Datacenter proxies will likely be blocked by Cloudflare.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "CH" } }, "maxRetries": { "title": "Max Retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum retry attempts per failed request.", "default": 3 }, "requestDelay": { "title": "Request Delay (ms)", "minimum": 500, "type": "integer", "description": "Minimum delay between requests in milliseconds. Lower values = faster but higher block risk.", "default": 1000 } } }, "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 } } } } } } } } } } ```