# Homegate Scraper (`anyxsolutions/homegate-scraper`) Actor Scrapes property listings from Homegate, Switzerland's largest real-estate portal. Collects rental and sale listings from search pages and full details from individual property pages: address, rooms, living space, prices, photos, and lister contact data. - **URL**: https://apify.com/anyxsolutions/homegate-scraper.md - **Developed by:** [Anyx Solutions](https://apify.com/anyxsolutions) (community) - **Categories:** - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.99 / 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#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 ![banner](generated) ## Homegate Scraper **Rental and sale property listings from homegate.ch — search results and full listing details as clean JSON.** Scrapes property listings from Homegate, Switzerland's largest real-estate portal. Collects rental and sale listings from search pages and full details from individual property pages: address, rooms, living space, prices, photos, and lister contact data. Point it at any Homegate search — a city, a canton, a radius, with whatever filters you set on the site — and get every matching listing back with its location, rooms, living space, price, photos, and description. Add listing URLs to pull the full detail record, including the lister's contact data and the listing's reference IDs. Built for real-estate market analysis, price monitoring, lead generation, and portfolio research across Switzerland. ### ⚡ Quick start ```json { "startUrls": [ { "url": "https://www.homegate.ch/rent/real-estate/city-bern/matching-list" } ], "maxItems": 5 } ``` ### 🧩 Input | Field | Type | Required | Default | Description | | -------------------- | ------- | -------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `startUrls` | array | yes | — | Homegate URLs to scrape. Search pages (`/rent/real-estate/city-bern/matching-list`, with any filters applied) and listing pages (`/rent/4002086534`) are both supported. | | `maxItems` | integer | no | `5` | Maximum number of listings to return per start URL. | | `proxyConfiguration` | object | no | `{ "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "CH" }` | Proxy settings. Homegate is protected by DataDome, so Swiss residential proxies are used by default. | ### 📤 Output Every listing is one dataset row. The `itemType` field tells the two shapes apart: `search` for a card from a results page and `property` for a full listing page. Both carry the listing `id` and its public `url`; the nested objects (`address`, `characteristics`, `prices`, `localization`, ...) hold the listing data exactly as Homegate publishes it, so every attribute the site shows is available. #### Fields | Field | Type | Description | | --------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | `itemType` | string | `search` or `property`. | | `id` | string | Homegate listing ID. | | `url` | string | Public listing URL, e.g. `https://www.homegate.ch/rent/4002086534`. | | `listingType` | object | Search only. Placement tier of the card, e.g. `{ "type": "PREMIUM" }`. | | `listing` | object | Search only. The listing record: `address`, `categories`, `characteristics`, `localization` (title, description, photos), `meta`, `offerType`, `prices`. | | `listingCard` | object | Search only. Card size on the results page. | | `listingScores` | object | Search only. Completeness and package scores. | | `listerBranding` | object | Search only. Agency logo and partner status. | | `newConstructionData` | object | Search only. New-build project data, when the card belongs to one. | | `agencyAgent` | object | Search only. The agent shown on the card, when there is one. | | `remoteViewing` | boolean | Search only. Whether a remote viewing is offered. | | `offerType` | string | Property only. `RENT` or `BUY`. | | `categories` | array | Property only. Property categories, e.g. `["APARTMENT", "FLAT"]`. | | `platforms` | array | Property only. Portals the listing is published on. | | `address` | object | Property only. Street, postal code, locality, country, and geo-coordinates. | | `characteristics` | object | Property only. Rooms, living space, floor, year built, and amenity flags. | | `localization` | object | Property only. Title, description, and photo attachments per language. | | `prices` | object | Property only. Rent or sale price, currency, and interval. | | `lister` | object | Property only. Agency or private lister details, including website and phone. | | `meta` | object | Property only. Created and updated timestamps. | | `externalIds` | object | Property only. The lister's own reference IDs. | | `contactForm` | object | Property only. Contact-form configuration for the listing. | | `valueAddedServices` | object | Property only. Extra service flags such as TenantPlus. | | `legacy` | object | Property only. Legacy identifiers used by the lister's system. | | `bfs` | object | Property only. Swiss Federal Statistical Office municipality data. | | `availableFrom` | string | Property only. Availability date, when the lister set one. |
Example output ```json { "itemType": "property", "id": "4002086534", "url": "https://www.homegate.ch/rent/4002086534", "offerType": "RENT", "categories": ["APARTMENT", "FLAT"], "platforms": ["homegate"], "address": { "street": "Belpstrasse 23", "postalCode": "3007", "locality": "Bern", "country": "CH", "geoCoordinates": { "latitude": 46.9446241, "longitude": 7.4332342, "accuracy": "HIGH" } }, "characteristics": { "numberOfRooms": 1, "livingSpace": 23, "floor": 2, "hasElevator": true }, "prices": { "currency": "CHF", "rent": { "gross": 1650, "interval": "MONTH" } }, "availableFrom": null } ```
### 💡 Use cases - **Market analysis** — track asking rents and sale prices by city, canton, or neighbourhood over time. - **Price monitoring** — watch specific listings or searches and get notified when prices or availability change. - **Lead generation** — collect agency names, websites, and contact data from active listings in a region. - **Portfolio research** — compare rooms, living space, and price per square metre across comparable properties. ### ❓ FAQ - **Do I need a proxy?** Yes. Homegate is protected by DataDome, so the Actor runs a real browser on Apify Swiss residential proxies by default; other settings are likely to be blocked. - **Can I use my own search filters?** Yes — set them on homegate.ch and paste the resulting URL as a start URL. Rent and buy searches are both supported. - **How many results can I get?** `maxItems` caps results per start URL, and the Actor pages through the search automatically. Add more start URLs to widen coverage. - **What is the difference between `search` and `property` items?** A search item is a card from a results page, with the listing data nested under `listing`. A property item is the full record from the listing page, with lister contact data, reference IDs, and municipality data at the top level. - **Why did a run return fewer items than expected?** The site may have changed its layout or tightened its protection, or a listing may have expired. Open an issue and we will update the Actor. ### 🔗 More scrapers by Anyx - [Autoscout24 Scraper](https://apify.com/anyxsolutions/autoscout24-scraper) - [Jobs.ch Scraper](https://apify.com/anyxsolutions/jobs-ch) - [Kleinanzeigen Scraper](https://apify.com/anyxsolutions/kleinanzeigen) - [Indeed Scraper](https://apify.com/anyxsolutions/indeed-scraper) ### 🤝 Anyx Solutions We build custom scrapers and data-extraction pipelines. - Email: tantosthor@gmail.com ### 🖼 Image credit Image credit: [homegate.ch](https://www.homegate.ch/) # Actor input Schema ## `startUrls` (type: `array`): Homegate URLs to scrape. Search pages (for example https://www.homegate.ch/rent/real-estate/city-bern/matching-list, with any filters applied) and listing pages (https://www.homegate.ch/rent/4002086534) are both supported. ## `maxItems` (type: `integer`): Maximum number of listings to return per start URL. A search page carries 20 listings, so the default finishes in a single request. ## `proxyConfiguration` (type: `object`): Apify proxy settings. Homegate is protected by DataDome, so Swiss residential proxies are used by default. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.homegate.ch/rent/real-estate/city-bern/matching-list" } ], "maxItems": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "CH" } } ``` # Actor output Schema ## `overview` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.homegate.ch/rent/real-estate/city-bern/matching-list" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("anyxsolutions/homegate-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://www.homegate.ch/rent/real-estate/city-bern/matching-list" }] } # Run the Actor and wait for it to finish run = client.actor("anyxsolutions/homegate-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 '{ "startUrls": [ { "url": "https://www.homegate.ch/rent/real-estate/city-bern/matching-list" } ] }' | apify call anyxsolutions/homegate-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,anyxsolutions/homegate-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 ` 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/5t8XZEhxs3dZQe3r0/builds/zsE8QQP4ro9OURFTh/openapi.json