Flatfox Listings and Rental Rates on Tap
Collecting Flatfox data across multiple Swiss cities usually means repeated polling, browser maintenance, and proxy management.
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.
| Field | Description |
|---|---|
| Asking rent | Monthly rent requested by the landlord or agent |
| Square meters | Living area of the property |
| Room count | Number of rooms in the listing |
| Neighborhood | District or area within the city |
| Available date | Date the property becomes available |
| Agent name | Name of the listing agent or contact |
| Image gallery | Full set of property images |
Field availability depends on what the Flatfox listing page exposes.
| Plan | Monthly price | API credits | Concurrent requests |
|---|---|---|---|
| Hobby | $19 /mo | 75,000 | 25 |
| Freelance | $49 /mo | 250,000 | 50 |
| Startup (Recommended) | $99 /mo | 1,000,000 | 100 |
| Business | $249 /mo | 3,000,000 | 200 |
| Business + | $599 /mo | 8,000,000 | 400 |
| Enterprise 14 | $999 /mo | 14,000,000 | 500 |
| Enterprise 24 | $1,599 /mo | 24,000,000 | 600 |
| Enterprise 41 (Recommended) | $2,399 /mo | 41,000,000 | 700 |
| Enterprise 69 | $3,599 /mo | 69,000,000 | 800 |
| Enterprise 120 | $5,799 /mo | 120,000,000 | 900 |
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.