# Flatfox Swiss Rental and Sale Listings API

> Flatfox Switzerland: 39,000+ flats, houses and offices to rent or buy, with prices and photos

- Vendor: `flatfoxswissrentalandsalelisti` · version 1.0 · category Property Data · tags flatfox api, swiss rentals api, switzerland real estate api, apartments for rent api, swiss property api, flats api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/flatfoxswissrentalandsalelisti
- This document: https://apiclay.com/docs/flatfoxswissrentalandsalelisti.md
- OpenAPI 3.1: https://apiclay.com/api/flatfoxswissrentalandsalelisti/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `flatfoxswissrentalandsalelisti`
- Updated: 2026-11-18

## About

## Flatfox Swiss Rental and Sale Listings API

The public listing API of Flatfox, the Swiss rental and property platform: every published listing, paged, with type and category, rent (net, charges, gross) or sale price, rooms, living space, floor, year built and renovated, address with coordinates, move-in date, title and description, attributes, images, documents, virtual tour and the managing agency; and one listing by id.

Data comes from **flatfox.ch** (https://flatfox.ch). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/listings?limit=50&amp;offset=0`, then `/listing?pk=`.

### Routes

#### GET `/listings` - Listings
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| limit | query | number | no | Listings per page, e.g. `50`. |
| offset | query | number | no | Listings to skip. |

Returns: `count`, `next`, `previous` and `results`: `pk`, `slug`, `url`, `status`, `offer_type`, `object_category`, `object_type`, `rent_net`, `rent_charges`, `rent_gross`, `price_display`, `price_unit`, `number_of_rooms`, `floor`, `livingspace`, `street`, `zipcode`, `city`, `latitude`, `longitude`, `moving_date`, `description_title`, `description`, `attributes`, `images`, `agency`, `published`.

#### GET `/listing` - Listing
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| pk | path | number | yes | Listing `pk` from `/listings`. |

Returns: One listing with every field of `/listings` plus `documents`, `tour_url`, `video_url`, `year_built`, `year_renovated`, `surface_*`.

### Caveats

- Listings name the agency or private landlord as published on Flatfox.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by flatfox.ch.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /listings — Listings
- Gateway: `GET https://api.apiclay.com/v1/api/flatfoxswissrentalandsalelisti/listings`
- Public query params: `limit` (number), `offset` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /listing — Listing
- Gateway: `GET https://api.apiclay.com/v1/api/flatfoxswissrentalandsalelisti/listing`
- Public query params: `pk` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/flatfoxswissrentalandsalelisti/listings" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
