Skip to content

Flatfox Listings and Rental Rates on Tap

Collecting Flatfox data across multiple Swiss cities usually means repeated polling, browser maintenance, and proxy management.

OUTPUT FORMATSHTMLJSONMarkdown

A single API call can return rendered HTML or structured JSON from any Flatfox URL, with options for JavaScript rendering, residential proxies, country targeting, and extraction rules.

What you can collect from Flatfox

Flatfox is a Swiss rental platform. Teams typically gather three kinds of data from it: city-level rent tracking, rental property listing details, and tenant feedback. A single request can return asking rent, square meters, room count, neighborhood, available date, agent name, and the full image gallery for each listing. Flatfox covers Zurich, Geneva, Bern, and Basel, so a weekly refresh can support rent tracking across those markets.

How the request flow works

Create an account to get an API key and free starting credits. Install the Python SDK or choose Node, Go, PHP, or Ruby; each Flatfox scrape becomes a single function call. Pass any Flatfox URL to the endpoint along with your API key. The service handles page rendering and bot bypass, then returns parsed HTML or structured JSON. For pages that need more control, add parameters: render_js for JavaScript, stealth_proxy for aggressive blocking, country_code for geotargeting, and ai_extract_rules for natural-language extraction.

Fields and output format

Every Flatfox listing returns asking rent, square meters, room count, neighborhood, available date, agent name, and the full image gallery. The API ingests Flatfox URLs plus your extraction logic; JavaScript renders behind the scenes, and you receive clean structured output. You can also request Markdown format for LLM-ready data, capture full-page screenshots, or run JavaScript scenarios to automate clicks and scrolling before extraction.

Handling blocks and JavaScript

The service rotates residential proxies and uses a real headless browser so requests resemble normal traffic. If a target becomes aggressive, enable stealth_proxy on the request. For JavaScript-heavy pages, pass render_js=true; the page runs in a headless browser, JavaScript executes server-side, and you receive the post-render HTML. To route through a specific country, pass country_code and the request uses a residential IP in that country. There are no per-target rate limits, only concurrency limits per plan; if the target throttles aggressive patterns, space out requests or use multiple sessions.

Getting structured JSON

Pass extract_rules with CSS selectors mapped to field names, or use ai_extract_rules with a natural-language specification. The response comes back as parsed JSON. This lets you define the exact fields you need without writing parsing logic for each page layout.

Plan and credit considerations

API credits are valid for one month and do not roll over. Requests start at 1 credit each. JavaScript rendering costs 5 API credits per successful request. Premium proxies cost 10 or 25 API credits per successful request, depending on whether JavaScript rendering is disabled or enabled. Concurrency limits vary by plan, from 25 concurrent requests on the Hobby plan up to 900 on Enterprise 120. Geotargeting is available across 200+ countries and territories, with 40+ on classic proxies. All prices are exclusive of VAT.

Decision checklist before you start

Use this checklist to choose the right request configuration:

  • If the page loads listings via JavaScript, set render_js=true.
  • If you receive repeated blocks despite proxy rotation, add stealth_proxy.
  • If content varies by country, set country_code to the target country.
  • If you need specific fields, define extract_rules with CSS selectors or use ai_extract_rules with a natural-language spec.
  • If you need LLM-ready text, request Markdown format.
  • If you need visual evidence, capture a full-page screenshot.
  • If you need to interact with the page before extraction, use JavaScript scenarios.
  • Check your plan's concurrency limit before scheduling high-volume polling.

Distinguishing common failure modes

A block usually appears as a CAPTCHA or an access-denied page; enabling stealth_proxy is the first response. A JavaScript rendering gap shows up as missing listing data in the HTML; set render_js=true to execute the page scripts. Target-side throttling produces rate-limit responses even when your plan concurrency is not exhausted; space out requests or use multiple sessions. If extraction rules return empty fields, verify the CSS selectors against the rendered page or switch to ai_extract_rules.

Flatfox listing fields returned per request
FieldDescription
Asking rentMonthly rent requested by the landlord or agent
Square metersLiving area of the property
Room countNumber of rooms in the listing
NeighborhoodDistrict or area within the city
Available dateDate the property becomes available
Agent nameName of the listing agent or contact
Image galleryFull set of property images

Field availability depends on what the Flatfox listing page exposes.

Plan concurrency and credit allowances
PlanMonthly priceAPI creditsConcurrent requests
Hobby$19 /mo75,00025
Freelance$49 /mo250,00050
Startup (Recommended)$99 /mo1,000,000100
Business$249 /mo3,000,000200
Business +$599 /mo8,000,000400
Enterprise 14$999 /mo14,000,000500
Enterprise 24$1,599 /mo24,000,000600
Enterprise 41 (Recommended)$2,399 /mo41,000,000700
Enterprise 69$3,599 /mo69,000,000800
Enterprise 120$5,799 /mo120,000,000900

All prices are exclusive of VAT. API credits are valid for one month and do not roll over. Requests start at 1 credit each; JavaScript rendering costs 5 API credits per successful request; premium proxies cost 10 or 25 API credits per successful request depending on JavaScript rendering.

Frequently asked questions

Will I get blocked when scraping Flatfox?

Requests are routed through rotating residential proxies and a genuine headless browser, which makes them resemble ordinary visitor traffic. Should a site start pushing back harder, turn on stealth_proxy for that request.

Can I scrape Flatfox without writing code?

Yes. The dashboard request builder lets you paste a URL, set parameters, and copy the generated snippet in Python, Node, Go, PHP, Ruby, or cURL.

How do I handle JavaScript when scraping Flatfox?

Pass render_js=true on the request. The page runs in a real headless browser, JavaScript executes server-side, and you receive the post-render HTML.

Can I scrape Flatfox from a specific country?

Yes. Pass country_code on the request to route through a residential IP in that country. This is useful when content varies by geo.

What's the rate limit for scraping Flatfox?

Throttling is governed by the concurrency allowance attached to your plan rather than by a fixed cap on requests to any single target. When a site reacts badly to rapid bursts, either widen the gap between calls or spread the work over several sessions.

How do I get structured JSON from Flatfox?

You have two routes to parsed JSON: supply extract_rules that pair CSS selectors with the field names you want, or describe the fields in plain language through ai_extract_rules. Either way, the response arrives already parsed as JSON.