# Homegate Search ## Overview | Property | Value | |----------|-------| | **Status** | private | | **Method** | `GET` | | **Endpoint** | `/v2/homegate/search` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/homegate-search | ## Description Search Homegate.ch listings in real time and retrieve price, rooms, area, and location for any Swiss property query. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/homegate/search' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Search apartments for rent in Zurich ```json { "meta": { "page": 1, "query": "appartement Zurich", "total_pages": 43, "listing_type": "rent", "has_next_page": true, "total_results": 847 }, "results": [ { "id": "4000847231", "url": "https://www.homegate.ch/mieten/4000847231", "floor": 4, "rooms": 3.5, "title": "Helle 3.5-Zimmer-Wohnung mit Balkon und Seeblick, Zürich Seefeld", "canton": "ZH", "street": "Seefeldstrasse 112", "currency": "CHF", "latitude": 47.3589, "locality": "Zürich", "longitude": 8.5541, "price_net": 3200, "has_garage": false, "agency_name": "Zurich Realty Group AG", "extra_costs": 280, "has_balcony": true, "postal_code": "8008", "price_gross": 3480, "has_elevator": true, "listing_type": "rent", "living_space": 94, "published_at": "2026-04-25T10:30:00Z", "has_nice_view": true, "property_type": "APARTMENT", "thumbnail_url": "https://media2.homegate.ch/listings/hgadp/4000847231/image/a3c7d8e2f14b59067c3a1d8f2e4b9c01.jpg" }, { "id": "4000912504", "url": "https://www.homegate.ch/mieten/4000912504", "floor": 2, "rooms": 2.5, "title": "Moderne 2.5-Zimmer-Wohnung im Kreis 5, ruhige Lage", "canton": "ZH", "street": "Langstrasse 187", "currency": "CHF", "latitude": 47.3796, "locality": "Zürich", "longitude": 8.5268, "price_net": 2450, "has_garage": false, "agency_name": null, "extra_costs": 200, "has_balcony": false, "postal_code": "8005", "price_gross": 2650, "has_elevator": false, "listing_type": "rent", "living_space": 72, "published_at": "2026-04-26T14:15:00Z", "has_nice_view": false, "property_type": "APARTMENT", "thumbnail_url": "https://media2.homegate.ch/listings/hgadp/4000912504/image/b7f2e1a3d6c849017d2e5f9c3a7b8e02.jpg" }, { "id": "4000763890", "url": "https://www.homegate.ch/mieten/4000763890", "floor": 6, "rooms": 4.5, "title": "4.5-Zimmer-Attikawohnung mit grosser Dachterrasse, Zürich Altstetten", "canton": "ZH", "street": "Altstetterstrasse 241", "currency": "CHF", "latitude": 47.3854, "locality": "Zürich", "longitude": 8.4887, "price_net": 4100, "has_garage": true, "agency_name": "Helvetia Immobilien GmbH", "extra_costs": 350, "has_balcony": true, "postal_code": "8048", "price_gross": 4450, "has_elevator": true, "listing_type": "rent", "living_space": 138, "published_at": "2026-04-24T09:00:00Z", "has_nice_view": true, "property_type": "ATTIC_FLAT", "thumbnail_url": "https://media2.homegate.ch/listings/hgadp/4000763890/image/c9a4f6b2e7d158023e4f7a1c2d8e9b03.jpg" } ] } ``` ### Search properties for sale in Geneva ```json { "meta": { "page": 1, "query": "maison Geneve", "total_pages": 16, "listing_type": "buy", "has_next_page": true, "total_results": 312 }, "results": [ { "id": "4001103847", "url": "https://www.homegate.ch/kaufen/4001103847", "floor": 3, "rooms": 3.5, "title": "Appartement de 3.5 pièces avec terrasse, Genève Plainpalais", "canton": "GE", "street": "Rue de Carouge 58", "currency": "CHF", "latitude": 46.1978, "locality": "Genève", "longitude": 6.1425, "price_net": 1185000, "has_garage": false, "agency_name": "Naef Immobilier SA", "extra_costs": null, "has_balcony": true, "postal_code": "1205", "price_gross": null, "has_elevator": true, "listing_type": "buy", "living_space": 88, "published_at": "2026-04-22T11:00:00Z", "has_nice_view": false, "property_type": "APARTMENT", "thumbnail_url": "https://media2.homegate.ch/listings/hgadp/4001103847/image/d1e7b3f5a2c948016g5h3i9j4k8l5m04.jpg" }, { "id": "4001057312", "url": "https://www.homegate.ch/kaufen/4001057312", "floor": 0, "rooms": 5.5, "title": "Villa individuelle 5.5 pièces avec jardin, Carouge GE", "canton": "GE", "street": "Route de Saint-Julien 42", "currency": "CHF", "latitude": 46.1872, "locality": "Carouge", "longitude": 6.1367, "price_net": 2450000, "has_garage": true, "agency_name": "Agence Schmid & Associés", "extra_costs": null, "has_balcony": true, "postal_code": "1227", "price_gross": null, "has_elevator": false, "listing_type": "buy", "living_space": 210, "published_at": "2026-04-20T08:30:00Z", "has_nice_view": false, "property_type": "VILLA", "thumbnail_url": "https://media2.homegate.ch/listings/hgadp/4001057312/image/e2f8c4a6b3d059127h6i4j0k5l9m6n05.jpg" } ] } ``` ## Documentation ## Overview Homegate.ch is Switzerland's leading real estate marketplace, with listings across all 26 cantons. The platform uses Cloudflare to block automated access. Piloterr handles the bypass and returns structured JSON in real time, no proxies to manage, no HTML to parse. ## Quickstart ``` GET https://api.piloterr.com/v2/homegate/search?query=appartement+Zurich ``` ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | City, canton, postal code, or keyword | | `listing_type` | string | no | `rent` (default) or `buy` | | `property_type` | string | no | `APARTMENT`, `HOUSE`, `VILLA`, `CHALET`, `LOFT`, `STUDIO` | | `min_price` / `max_price` | number | no | Price range in CHF | | `min_rooms` / `max_rooms` | number | no | Room count range | | `min_area` / `max_area` | number | no | Living area range in m² | | `page` | integer | no | Page number (default: 1) | ## Main use cases - Track rental price trends across Swiss cities and cantons in real time - Monitor Homegate listings and trigger alerts when new properties match a search - Build price-per-m² benchmarks for Swiss real estate by aggregating search results - Enrich comparison platforms with live CHF pricing across all cantons - Power investment scoring models with location and amenity data from listings