Flatfox.ch Property Scraper

What does Flatfox.ch Property Scraper do?

Flatfox.ch Property Scraper collects public Swiss property listings from Flatfox.ch and returns them as structured records. Provide a Flatfox search URL to collect listings from a selected map area, provide one listing URL to retrieve a specific property, or use a keyword to filter current listings by title, description, location, property type, offer type, and agency information.

The dataset is useful for Swiss real estate research, rental market analysis, property monitoring, relocation research, price comparisons, and data enrichment. Each saved record includes the listing URL, property details, pricing, address information, dates, agency information, coordinates, images, and available attributes.

Why use Flatfox.ch Property Scraper?

• Collect structured Swiss property data - Turn public Flatfox listings into records that are easier to search, compare, and analyze.
• Support rental and sales research - Use price, rent, property type, room count, floor, surface area, and location fields in market research workflows.
• Monitor selected areas - Re-run a Flatfox map search on a schedule to track new and changing listings.
• Retrieve one listing directly - Use a public Flatfox detail URL when you need a complete record for a specific property.
• Filter by practical search terms - Keyword matching covers listing text, address, city, region, category, property type, offer type, agency, and listing attributes.
• Use standard Apify workflows - Download results as JSON, CSV, Excel, XML, or other supported dataset formats, or connect the run to webhooks and external applications.

What data can you extract from Flatfox.ch?

The Actor normalizes the main public listing fields into a consistent dataset. Some fields are only available when the property owner or agency publishes them.

Field	Description
id	Flatfox listing identifier
title	Main public listing title
short_title	Short property title
pitch_title	Marketing or pitch title
description_title	Heading for the listing description
description	Public property description
url	Full Flatfox listing URL
short_url	Short Flatfox listing URL
status	Listing status, such as active
offer_type	Rental or sales offer type
object_category	Broad property category
object_type	Specific property type
price_display	Main displayed price
price_display_type	Price display classification
price_unit	Price unit, such as monthly
rent_net	Net rent when available
rent_charges	Additional rental charges when available
rent_gross	Gross rent or total rental price
surface_living	Living area
surface_property	Property area
surface_usable	Usable area
space_display	Displayed area value
number_of_rooms	Number of rooms
floor	Floor number
is_furnished	Whether the property is furnished
is_temporary	Whether the offer is temporary
is_swap	Whether the listing supports a property swap
is_selling_furniture	Whether furniture is offered for sale
reserved	Whether the listing is reserved
street	Street address when published
zipcode	Swiss postal code
city	City or municipality
state	State or canton when available
country	Country code or country name
public_address	Publicly displayed address
latitude	Property latitude
longitude	Property longitude
moving_date_type	Type of move-in date
moving_date	Available move-in date
published	Publication timestamp
created	Listing creation timestamp
year_built	Construction year
year_renovated	Renovation year
reference	Agency or property reference
smg_id	Source or marketplace identifier
agency_name	Listing agency name
agency_city	Agency city
agency_country	Agency country
image_url	Main listing image URL
Gallery_Urls	Available gallery image URLs
attributes	Published property attributes
formatted	Additional formatted listing values when available

How to use Flatfox.ch Property Scraper

1. Open the Actor in Apify Console.
2. Enter a public Flatfox search URL, a public listing URL, or a keyword.
3. Set results_wanted to the maximum number of records to save.
4. Set max_pages when using keyword-only collection without a bounded search URL.
5. Optionally configure an Apify Proxy for runs that need additional network reliability.
6. Start the run and open the dataset when it completes.
7. Download the records or connect the dataset to your next workflow.

A URL search takes priority over a keyword when both are explicitly supplied. A keyword-only run searches the available current listing pages and applies the keyword filter to the returned records. A listing detail URL retrieves that individual listing directly.

Input Parameters

Parameter	Type	Required	Default	Description
startUrl	String	No	Flatfox map search example	Public Flatfox search URL or listing detail URL. Search URLs with map bounds are supported.
keyword	String	No	Empty	Optional text filter matched against listing titles, descriptions, addresses, cities, categories, property types, offer types, agencies, and attributes.
results_wanted	Integer	No	20	Maximum number of listings to save. The value must be at least 1.
max_pages	Integer	No	5	Maximum number of listing pages to check when no bounded Flatfox search URL is provided.
proxyConfiguration	Object	No	{"useApifyProxy": false}	Optional Apify Proxy configuration for the run.

The Actor also accepts startUrls and url values when supplied through compatible Apify integrations, but startUrl is the documented form for the input schema.

Output Data

Each dataset item is a normalized Flatfox listing object. Values that Flatfox does not publish are omitted rather than filled with invented data. Dates are returned in the format provided by Flatfox, and image paths are converted to full URLs when possible.

Field	Type	Description
id	Number	Flatfox listing ID
title	String	Main listing title
description	String	Public listing description
url	String	Full listing URL
short_url	String	Short listing URL
status	String	Listing status
offer_type	String	Rental or sales offer
object_category	String	Property category
object_type	String	Property type
price_display	Number	Displayed price
price_unit	String	Price unit
rent_net	Number	Net rent when available
rent_charges	Number	Rental charges when available
rent_gross	Number	Gross rent or total rent
surface_living	Number	Living area
surface_property	Number	Property area
surface_usable	Number	Usable area
space_display	Number	Displayed area
number_of_rooms	String or Number	Room count
floor	Number	Floor number
is_furnished	Boolean	Furnished status
is_temporary	Boolean	Temporary offer status
is_swap	Boolean	Swap status
street	String	Street when public
zipcode	Number or String	Postal code
city	String	City
state	String	State or canton
country	String	Country
public_address	String	Public address
latitude	Number	Latitude
longitude	Number	Longitude
moving_date	String	Move-in date
published	String	Publication timestamp
created	String	Creation timestamp
year_built	Number	Construction year
year_renovated	Number	Renovation year
reference	String	Listing reference
smg_id	String	Source identifier
agency_name	String	Agency name
agency_city	String	Agency city
agency_country	String	Agency country
image_url	String	Main image URL
Gallery_Urls	Array	Gallery image URLs
attributes	Array	Published property attributes
formatted	Object	Additional formatted values

Usage Examples

Basic Flatfox map search

Collect listings from the supplied Flatfox map search area:

{
    "startUrl": "https://flatfox.ch/en/search/?east=10.492340&north=48.630528&south=44.951347&take=48&west=5.956080",
    "results_wanted": 20,
    "max_pages": 5
}

Keyword-only property search

Search current Flatfox listings and keep records containing the keyword in their searchable text fields. No URL is added to this mode:

{
    "keyword": "room Zurich",
    "results_wanted": 20,
    "max_pages": 5
}

Retrieve one listing

Use a public listing URL to collect the full record for that property:

{
    "startUrl": "https://flatfox.ch/en/flat/8045-zurich/86346286/",
    "results_wanted": 1
}

Use an Apify Proxy

Enable the proxy only when it is useful for your run or deployment environment:

{
    "startUrl": "https://flatfox.ch/en/search/?east=10.492340&north=48.630528&south=44.951347&take=48&west=5.956080",
    "results_wanted": 50,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
}

Sample Output

A dataset item can look like this. Fields not published by a particular listing may be absent:

{
    "id": 86346286,
    "title": "8045 Zürich - CHF 1’290 incl. utilities per month",
    "short_title": "Room in a shared flat",
    "pitch_title": "Rent a room in a shared flat in Zürich",
    "description_title": "Your Coliving Spot in the Heart of Zurich",
    "description": "Welcome to Moana, a modern coliving apartment in Zurich.",
    "url": "https://flatfox.ch/en/flat/8045-zurich/86346286/",
    "short_url": "https://flatfox.ch/86346286/",
    "status": "act",
    "offer_type": "RENT",
    "object_category": "SHARED",
    "object_type": "SHARED_FLAT",
    "price_display": 1290,
    "price_display_type": "TOTAL",
    "price_unit": "monthly",
    "rent_gross": 1290,
    "surface_living": 10,
    "surface_usable": 10,
    "space_display": 10,
    "number_of_rooms": "1.0",
    "floor": 5,
    "is_furnished": true,
    "is_temporary": false,
    "is_swap": false,
    "zipcode": 8045,
    "city": "Zürich",
    "country": "CH",
    "public_address": "8045 Zürich",
    "latitude": 47.351771547575,
    "longitude": 8.508592236981,
    "moving_date_type": "dat",
    "moving_date": "2026-11-01",
    "published": "2026-09-08T14:19:00.066242+02:00",
    "created": "2026-09-08T14:18:59.083745+02:00",
    "reference": "19121..184-3",
    "smg_id": "",
    "agency_name": "Room Estate AG",
    "agency_city": "Zürich",
    "agency_country": "CH",
    "image_url": "https://flatfox.ch/thumb/ff/2026/09/8zynvcthtuug12n344j5e1ubkyt8vxz7d6o6meojxpawyu9gny.jpg",
    "Gallery_Urls": ["https://flatfox.ch/thumb/ff/2026/09/8zynvcthtuug12n344j5e1ubkyt8vxz7d6o6meojxpawyu9gny.jpg"],
    "attributes": ["washingmachine"]
}

Tips for best results

• Use a Flatfox search URL with map bounds when you need listings from a specific geographic area.
• Start with results_wanted: 20 to confirm that the URL and filters produce the expected records.
• Use a single listing URL when you need one complete property record instead of a search result set.
• Keep keywords specific enough to reduce unrelated matches, such as 2 room apartment Zurich or furnished room Basel.
• Increase max_pages for broader keyword collection, but keep the result limit appropriate for the run.
• Check the dataset preview before scheduling repeated runs.
• Export image URLs separately if your downstream workflow needs to download property images.
• Public listings can change or be removed. A missing field usually means that Flatfox did not publish that value for the listing.

Integrations and exports

• JSON, CSV, Excel, and XML - Download the dataset in a format suited to analysis or archiving.
• Apify API - Retrieve completed dataset items programmatically.
• Webhooks - Trigger a downstream workflow after a run completes.
• Google Sheets - Send listing data to a spreadsheet for review and comparison.
• Make or Zapier - Connect new property records to alerts, databases, or CRM workflows.
• Scheduled runs - Refresh a selected search area on a recurring schedule for monitoring.

Frequently Asked Questions

Can I scrape Flatfox listings by city or region?

Yes. Use a Flatfox search URL containing the relevant map area and set results_wanted to the number of records you need. You can also add a keyword to filter the returned listing content.

Can I retrieve one Flatfox listing?

Yes. Put the public listing detail URL in startUrl and use results_wanted: 1. The Actor returns the normalized public fields available for that listing.

Can I search Flatfox with a keyword?

Yes. Provide keyword without startUrl for a keyword-only run. The keyword is matched against listing text, location fields, property classifications, offer type, agency data, and attributes.

Can I export Flatfox data to CSV or Excel?

Yes. Apify datasets can be downloaded as CSV, Excel, JSON, XML, and other supported formats after the run finishes.

Can I schedule recurring Flatfox monitoring?

Yes. Create an Apify schedule for the Actor and reuse the same search URL and limits. This is useful for tracking new listings and changes in a selected area.

Why is a field missing from a listing?

A field is omitted when Flatfox does not publish a usable value for that property. Rental charges, exact street addresses, surface measurements, agency details, and dates are not guaranteed for every listing.

Is it legal to collect Flatfox data?

You are responsible for complying with Flatfox terms, applicable Swiss and international laws, privacy requirements, and any restrictions that apply to your intended use. Use the Actor for legitimate collection of public information and avoid using personal or property data in ways that cause harm.

Related Actors

• Propertyfinder Scraper
• Daft.ie Property Scraper
• Domain.com.au Property Scraper

Support

For bugs, field requests, or questions about Flatfox data, use the Issues tab on the Actor page. Include the input mode, a sanitized example URL, and the relevant run details when reporting a problem.

Legal Notice

This Actor is intended for responsible collection of publicly available property listing information. You are responsible for respecting Flatfox terms of use, applicable laws, privacy obligations, intellectual property rights, and any restrictions on storing, analyzing, or redistributing collected data.