Flatfox Property Search Scraper

Pull rental and for-sale property listings from Flatfox (flatfox.ch) at scale — titles, descriptions, full price breakdowns, room counts, living space, exact map coordinates, ready-to-use image URLs, and listing-agency contact details for every property across Switzerland. Built for relocation services, property investors, and real-estate analysts who need clean, structured Swiss housing data without browsing the portal one listing at a time.

Why This Scraper?

• Six property categories in one run — apartments, houses, secondary rooms (storage/hobby), shared flats, commercial/industrial space, and parking/garage slots, each filterable on its own.
• Rent and sale in one run, with the full CHF breakdown — flip one dropdown between "For rent" and "For sale". Rentals return net rent, utility charges, and gross rent as three separate fields; for-sale listings return a total asking price, worked out for you even when the listing quotes a rate per square meter instead of a lump sum.
• Mixed price units made comparable — Flatfox quotes commercial space in CHF per m² per year and apartments in CHF per month. Every listing carries a plain-English price unit plus a monthlyPrice in CHF per month, so a warehouse and a flat sit in the same column — and your budget band and price sorting run on that comparable figure. In a mixed-unit commercial search this took out-of-budget rows from 71% down to zero and returned 36% more genuinely in-budget listings.
• Exact map coordinates, not blurred — precise latitude and longitude on every listing for mapping, distance, and catchment analysis.
• Ready-to-use image URLs — full-resolution photo links and a cover image come back as direct, signed URLs you can load straight into a sheet or app — no asset-ID guesswork.
• Listing-agency contacts — agency name, full postal address, and logo URL captured for every property, ready for outreach lists.
• 40+ structured fields per listing — reference code, object type, floor, year built, year renovated, furnished and temporary flags, moving date, feature tags (balcony, garage, pets…), canton, and publish timestamps.
• Half-room and CHF-precise filters — filter by minimum and maximum rooms down to the half-room (2.5), plus exact CHF price bands and square-meter living-space ranges that Swiss housing uses.
• All of Switzerland, no URL-crafting — type a city, region, or postal code and the actor builds the search for you, or paste a flatfox.ch search URL to mirror filters you already set up on the site.

Use Cases

Relocation & Housing Search

• Build daily shortlists of apartments matching a relocating employee's budget, rooms, and neighborhood
• Compare rent levels across Zurich, Geneva, Basel, and Lausanne for relocation packages
• Track new rentals in a target postal code as they appear
• Filter furnished listings for short-term and corporate stays

Real-Estate Investment

• Pull for-sale listings with selling prices to model yields by city and canton
• Compare price per square meter across regions using exact living-space data
• Spot commercial and industrial space coming to market
• Monitor parking and garage inventory as a standalone asset class

Market Research & Analytics

• Map listing density and pricing by exact coordinates across Swiss cities
• Measure average net vs. gross rent spreads by region
• Track rooms, living space, and year-built distributions in a market
• Feed structured Swiss housing data into dashboards and reports

Lead Generation

• Build listing-agency contact lists with name, address, and logo
• Identify the most active agencies in a target city
• Target outreach by property category (e.g. only commercial listings)
• Enrich existing CRM records with fresh Flatfox listings

Getting Started

Search by Location

The simplest start — one city and a result cap:

{
    "location": "Zurich",
    "maxResults": 50
}

Filtered Rental Search

Two-to-three-room apartments under CHF 2,500 a month, newest first:

{
    "offerType": "RENT",
    "location": "Geneva",
    "objectCategories": ["APARTMENT"],
    "priceMax": 2500,
    "roomsMin": 2,
    "roomsMax": 3,
    "sortBy": "newest",
    "maxResults": 200
}

For-Sale Search by URL

Paste one or more Flatfox search URLs to mirror filters set up on the site:

{
    "startUrls": [
        "https://flatfox.ch/en/search/?offer_type=SALE&north=47.43&south=47.32&east=8.63&west=8.45"
    ],
    "maxResults": 500,
    "maxResultsPerUrl": 250
}

Input Reference

What to Scrape

Parameter	Type	Default	Description
startUrls	string[]	—	Paste one or more Flatfox search result URLs. The scraper reads the filters straight from each URL. Leave empty to build a search with the filter fields below.

Build a Search

These fields are used only when no Search URLs are provided.

Parameter	Type	Default	Description
offerType	select	For rent	Search properties for rent or for sale.
location	string	—	City, region, or postal code to search (for example "Zurich", "Geneva", or "8005"). Leave empty to search all of Switzerland.
objectCategories	select[]	[]	Limit results to these categories: Apartment, House, Secondary rooms (storage, hobby), Shared / room in flat, Commercial / industrial, Parking / garage. Leave empty for all.
priceMin	integer	—	Only include listings at or above this price in Swiss francs. For rentals this is the monthly cost, and commercial space quoted per m² per year is converted before it is compared, so the band means the same thing for every listing.
priceMax	integer	—	Only include listings at or below this price in Swiss francs, on the same comparable monthly (or total, for sales) figure.
roomsMin	number	—	Minimum number of rooms (for example 2.5).
roomsMax	number	—	Maximum number of rooms.
spaceMin	integer	—	Minimum living space in square meters.
spaceMax	integer	—	Maximum living space in square meters.
sortBy	select	Newest first	Result order: Newest first, Price low to high, Price high to low, Rooms fewest first, Rooms most first, or Largest living space first.

Limits

Parameter	Type	Default	Description
maxResults	integer	100	Total number of listings to collect across all searches and URLs. Set to 0 to collect as many as available.
maxResultsPerUrl	integer	0	Maximum listings to collect from each individual search or URL. Set to 0 for no per-URL limit.
ignoreUrlFailures	boolean	true	When enabled, the scraper skips any search or URL that fails and continues with the rest. When disabled, the run stops on the first failure.

Output

Each record is one property listing, flat and ready for a spreadsheet:

{
    "id": 421337,
    "reference": "ZH-4021",
    "title": "Bright 3.5-room apartment near the lake",
    "description": "Renovated apartment with balcony, modern kitchen, and lake views...",
    "objectCategory": "APARTMENT",
    "objectType": "APARTMENT",
    "offerType": "RENT",
    "price": 2450,
    "priceUnit": "monthly",
    "priceUnitLabel": "CHF per month",
    "monthlyPrice": 2450,
    "priceDisplayType": "TOTAL",
    "rentNet": 2200,
    "rentCharges": 250,
    "rentGross": 2450,
    "sellingPrice": null,
    "livingSpace": 86,
    "surfaceProperty": null,
    "surfaceUsable": null,
    "numberOfRooms": 3.5,
    "floor": 2,
    "yearBuilt": 1998,
    "yearRenovated": 2021,
    "isFurnished": false,
    "isTemporary": false,
    "attributes": ["balcony", "elevator", "pets_allowed"],
    "street": "Seestrasse 14",
    "zipcode": "8002",
    "city": "Zürich",
    "publicAddress": "Seestrasse 14, 8002 Zürich",
    "latitude": 47.3567,
    "longitude": 8.5361,
    "state": "ZH",
    "country": "CH",
    "movingDate": "2026-08-01",
    "movingDateType": "DATE",
    "publishedAt": "2026-06-10T09:22:00Z",
    "createdAt": "2026-06-10T09:20:00Z",
    "images": ["https://flatfox.ch/media/listing/421337/01.jpg?signature=..."],
    "coverImage": "https://flatfox.ch/media/listing/421337/cover.jpg?signature=...",
    "agencyName": "Lakeview Immobilien AG",
    "agencyAddress": "Bahnhofstrasse 5, 8001 Zürich, CH",
    "agencyLogo": "https://flatfox.ch/media/agency/logo.png",
    "url": "https://flatfox.ch/en/flat/bright-3-5-room-apartment/421337/"
}

Core Fields

Field	Type	Description
id	number	Unique Flatfox listing identifier
reference	string	Agency reference code
title	string	Listing title
description	string	Full listing description text
objectCategory	string	APARTMENT, HOUSE, SECONDARY, SHARED, INDUSTRY, or PARK
objectType	string	More specific object type (e.g. APARTMENT, OFFICE, GARAGE_SLOT)
offerType	string	RENT or SALE
url	string	Direct Flatfox listing URL

Pricing

Field	Type	Description
price	number	The price exactly as the listing quotes it in CHF. The unit varies by listing — read priceUnitLabel to know what it means.
priceUnitLabel	string	Plain-English unit for price: CHF per month, CHF per m² per year (common for commercial and industrial space), CHF per year, or CHF total for a sale. Filled on every listing that carries a price.
monthlyPrice	number	Comparable rent in CHF per month for every rental, whatever unit it was quoted in — monthly rents pass through, yearly rents are divided across the year, and per-m²-per-year rates are applied to the listing's surface. Empty on for-sale listings.
priceUnit	string	Raw Flatfox price-unit code (e.g. "monthly", "yearlym2", "sell")
priceDisplayType	string	How the price is shown (e.g. "TOTAL")
rentNet	number	Net rent in CHF
rentCharges	number	Utility and service charges in CHF
rentGross	number	Gross rent in CHF (net + charges)
sellingPrice	number	Total asking price in CHF on a for-sale listing. When the listing quotes a price per square meter instead of a total, this is the total that rate works out to, so it is filled on virtually every priced for-sale listing.

Property Details

Field	Type	Description
livingSpace	number	Living space in square meters
surfaceProperty	number	Total property surface in square meters
surfaceUsable	number	Usable surface in square meters
numberOfRooms	number	Number of rooms (e.g. 3.5)
floor	number	Floor number
yearBuilt	number	Year the property was built
yearRenovated	number	Year of the last renovation
isFurnished	boolean	Whether the property is furnished
isTemporary	boolean	Whether the lease is temporary
attributes	string[]	Feature tags (balcony, garage, pets allowed, etc.)

Address & Location

Field	Type	Description
street	string	Street and number
zipcode	string	Postal code
city	string	City
publicAddress	string	Full display address
state	string	Canton code (e.g. ZH, GE)
country	string	Country code (CH)
latitude	number	Exact latitude
longitude	number	Exact longitude

Media, Agency & Dates

Field	Type	Description
images	string[]	Full-resolution photo URLs
coverImage	string	Cover photo URL
agencyName	string	Listing agency name
agencyAddress	string	Listing agency postal address
agencyLogo	string	Listing agency logo URL
movingDate	string	Available-from date
movingDateType	string	How the moving date is expressed (e.g. fixed date or "by arrangement")
publishedAt	string	Publication timestamp
createdAt	string	Creation timestamp

Tips for Best Results

• Paste a flatfox.ch search URL to copy your exact on-site filters — set up a search on Flatfox, copy the address bar, and drop it into startUrls. Every filter, including the map area, is mirrored exactly with no rebuilding.
• Each search area returns up to 1,000 listings — Flatfox caps a single search at 1,000 results. To gather more from a large region, split it into several narrower searches (by city or postal code) and pass them all in one run; set maxResultsPerUrl to balance how much comes from each area, and the totals add up across them.
• Switching to "For sale" changes the price fields — sale listings populate sellingPrice, while the rent breakdown (rentNet, rentCharges, rentGross) and monthlyPrice apply to rentals. Check the right field for the offer type you searched.
• Searching commercial or industrial space? Sort on monthlyPrice, not price — roughly a third of Swiss commercial listings are advertised in CHF per m² per year, so their raw price is a rate, not a rent. monthlyPrice puts every one of them on a CHF-per-month footing you can rank, average, and budget against.
• Use half-room filters the Swiss way — roomsMin and roomsMax accept decimals like 2.5 or 3.5, matching how Swiss listings count rooms.
• Start small to test — run with maxResults at 20–50 first to confirm the filters return what you expect, then scale up.
• Leave the location empty for a national sweep — clear location and the search covers all of Switzerland; narrow later with categories and price bands.

Pricing

From $0.90 per 1,000 results — undercutting comparable Flatfox extractors, with cleaner defaults so you are never over-charged by a runaway result cap. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier.

Results	No discount	Bronze	Silver	Gold
100	$0.105	$0.100	$0.095	$0.090
1,000	$1.05	$1.00	$0.95	$0.90
10,000	$10.50	$10.00	$9.50	$9.00
100,000	$105.00	$100.00	$95.00	$90.00

A "result" is one property listing in the output dataset. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new results
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This actor is designed for legitimate real-estate research, market analysis, and lead generation. Users are responsible for complying with applicable laws and Flatfox's Terms of Service. Do not use extracted data for spam, harassment, or any illegal purpose, and handle any personal data, such as agency contacts, in line with applicable privacy regulations.