# Homegate Ad ## Overview | Property | Value | |----------|-------| | **Status** | private | | **Method** | `GET` | | **Endpoint** | `/v2/homegate/ad` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/homegate-ad | ## Description Retrieve full details of any Homegate.ch property listing by URL or ID, including price, amenities, floor plan, images, and contact info. ## 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/ad' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Villa for sale in Küsnacht ZH ```json { "id": "4001234567", "url": "https://www.homegate.ch/kaufen/4001234567", "meta": { "is_active": true, "scraped_at": "2026-04-29T17:31:00Z", "updated_at": "2026-04-27T11:30:00Z", "published_at": "2026-04-18T08:00:00Z" }, "floor": 0, "rooms": 5.5, "title": "Exklusive 5.5-Zimmer-Villa mit Seesicht und Garten, Küsnacht ZH", "images": [ { "url": "https://media2.homegate.ch/listings/hgadp/4001234567/image/e2f8a4b7c1d359046f7a2e9b4c3d8f01.jpg", "order": 0, "caption": "Haupteingang und Fassade", "thumbnail_url": "https://media2.homegate.ch/listings/hgadp/4001234567/image/e2f8a4b7c1d359046f7a2e9b4c3d8f01/300x200.jpg" }, { "url": "https://media2.homegate.ch/listings/hgadp/4001234567/image/a3c6f9b2e4d158027c5e3f8a1d7b9c02.jpg", "order": 1, "caption": "Wohnzimmer mit Seesicht", "thumbnail_url": "https://media2.homegate.ch/listings/hgadp/4001234567/image/a3c6f9b2e4d158027c5e3f8a1d7b9c02/300x200.jpg" }, { "url": "https://media2.homegate.ch/listings/hgadp/4001234567/image/b4d7a1c3f6e259038d6f4g9b2c8a0e03.jpg", "order": 2, "caption": "Garten und Terrasse", "thumbnail_url": "https://media2.homegate.ch/listings/hgadp/4001234567/image/b4d7a1c3f6e259038d6f4g9b2c8a0e03/300x200.jpg" } ], "address": { "canton": "ZH", "street": "Seestrasse 154", "country": "CH", "latitude": 47.3192, "locality": "Küsnacht", "longitude": 8.5897, "postal_code": "8700", "geo_accuracy": "HIGH" }, "contact": { "email": "zurich@sothebysrealty.ch", "phone": "+41 44 388 61 00", "website": "https://www.sothebysrealty.ch", "agency_id": "w00249", "agent_name": "Markus Brunner", "agency_name": "Sotheby's International Realty Zürich" }, "currency": "CHF", "features": { "is_quiet": true, "has_cellar": true, "has_garage": true, "has_garden": true, "allows_pets": true, "has_balcony": true, "has_elevator": false, "has_fireplace": true, "has_nice_view": true, "has_dishwasher": true, "parking_spaces": 2, "has_washing_machine": true, "is_wheelchair_accessible": false }, "price_net": 3850000, "year_built": 1962, "description": "Diese repräsentative Villa aus dem Jahr 1962, vollständig renoviert 2019, liegt in einer der begehrtesten Wohnlagen von Küsnacht. Das grosszügige Grundstück von 1'200 m² bietet einen weitläufigen Garten mit direktem Blick auf den Zürichsee. Im Innenbereich überzeugen edle Materialien, eine offene Wohnküche sowie ein grosszügiges Elternschlafzimmer mit Ankleide. Vier weitere Zimmer, ein Büro und ein Weinkeller runden das Angebot ab. Doppelgarage mit zwei Aussenparkplätzen vorhanden. Öffentliche Verkehrsanbindung (S-Bahn Küsnacht) in 8 Gehminuten.", "extra_costs": null, "price_gross": null, "energy_class": "B", "heating_type": "heat_pump", "listing_type": "buy", "living_space": 248, "total_floors": 2, "property_type": "VILLA", "last_renovation": 2019 } ``` ### Apartment for rent in Lausanne by listing ID ```json { "id": "4009876543", "url": "https://www.homegate.ch/mieten/4009876543", "meta": { "is_active": true, "scraped_at": "2026-04-29T17:31:00Z", "updated_at": "2026-04-28T16:00:00Z", "published_at": "2026-04-21T09:00:00Z" }, "floor": 3, "rooms": 3.5, "title": "Appartement lumineux 3.5 pièces avec balcon, Lausanne Ouchy", "images": [ { "url": "https://media2.homegate.ch/listings/hgadp/4009876543/image/f3a9c5d7b2e468019h7i5j1k6l0m7n01.jpg", "order": 0, "caption": "Salon avec vue lac", "thumbnail_url": "https://media2.homegate.ch/listings/hgadp/4009876543/image/f3a9c5d7b2e468019h7i5j1k6l0m7n01/300x200.jpg" }, { "url": "https://media2.homegate.ch/listings/hgadp/4009876543/image/g4b0d6e8c3f579120i8j6k2l7m1n8o02.jpg", "order": 1, "caption": "Cuisine équipée", "thumbnail_url": "https://media2.homegate.ch/listings/hgadp/4009876543/image/g4b0d6e8c3f579120i8j6k2l7m1n8o02/300x200.jpg" } ], "address": { "canton": "VD", "street": "Avenue d'Ouchy 74", "country": "CH", "latitude": 46.5107, "locality": "Lausanne", "longitude": 6.6336, "postal_code": "1006", "geo_accuracy": "HIGH" }, "contact": { "email": "lausanne@sothebysrealty.ch", "phone": "+41 21 614 00 00", "website": "https://www.sothebysrealty.ch", "agency_id": "w00317", "agent_name": "Sophie Mercier", "agency_name": "Rea Sotheby's International Realty Lausanne" }, "currency": "CHF", "features": { "is_quiet": true, "has_cellar": true, "has_garage": false, "has_garden": false, "allows_pets": null, "has_balcony": true, "has_elevator": true, "has_fireplace": false, "has_nice_view": true, "has_dishwasher": true, "parking_spaces": 0, "has_washing_machine": true, "is_wheelchair_accessible": true }, "price_net": 2780, "year_built": 2017, "description": "Magnifique appartement situé au 3ème étage d'un immeuble récent, en plein coeur du quartier Ouchy à Lausanne. Vue dégagée sur le lac Léman depuis le salon et le balcon orienté sud. Cuisine entièrement équipée, double vitrage, chauffage au sol. Parking couvert disponible à CHF 150 par mois en supplément. Proche des transports publics (métro M2 Ouchy à 5 min à pied). Disponible à partir du 1er juin 2026.", "extra_costs": 200, "price_gross": 2980, "energy_class": "A", "heating_type": "district_heating", "listing_type": "rent", "living_space": 86, "total_floors": 5, "property_type": "APARTMENT", "last_renovation": null } ``` ## Documentation ## Overview Homegate.ch is Switzerland's leading real estate marketplace. Piloterr bypasses Cloudflare and returns a full JSON record for any listing URL or ID: price in CHF, rooms, area, amenities, all images, and contact details, in real time. ## Quickstart ``` GET https://api.piloterr.com/v2/homegate/ad?query=https://www.homegate.ch/kaufen/4001234567 ``` ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | Homegate.ch listing URL or numeric listing ID | ## Main use cases - Monitor price changes on specific Homegate listings over time - Enrich CRM systems with full property records pulled from Homegate.ch - Automate investment analysis by extracting yield-relevant fields at scale - Build listing enrichment pipelines that sync Homegate data into internal databases - Extract agency contact information for real estate lead qualification