ImmoScout24 Switzerland Search API
Search ImmoScout24.ch listings by city or search URL and retrieve the CHF price, rooms, living area, and address. Property pages are not available.
Endpoint Overview
Detailed documentation, pricing, and usage examples.
OverviewLink to Overview
Search rental and for-sale listings on ImmoScout24 Switzerland. Pass a city name or a full search URL from immoscout24.ch. Each listing includes the price in CHF, rooms, living area, and address.
Property pages are not available. A listing URL such as https://www.immoscout24.ch/mieten/4002086198 returns 400. This endpoint is Switzerland only.
QuickstartLink to Quickstart
Apartments for rent in Zurich. A city defaults to offer_type=rent and property_type=apartment.
GET https://api.piloterr.com/v2/immoscout24ch/search?query=zurich&offer_type=rent
The same search as a saved URL. Filters already on the URL, such as nrf and nrt, are kept.
GET https://api.piloterr.com/v2/immoscout24ch/search?query=https://www.immoscout24.ch/de/wohnung/mieten/ort-zuerich
Houses for sale in Geneva. offer_type=buy sets results[].offer_type to buy.
GET https://api.piloterr.com/v2/immoscout24ch/search?query=geneve&offer_type=buy&property_type=house
Page 2. ImmoScout24 receives pn=2.
GET https://api.piloterr.com/v2/immoscout24ch/search?query=zurich&page=2
ParametersLink to Parameters
queryLink to query
Required string.
- A city:
zurich,zuerich,geneve,geneva,bern,berne,basel,luzern, orlucerne. The city is sent asort-{slug}. - Default for a city: apartments for rent.
results[].offer_typeisrentandresults[].priceis the monthly gross rent in CHF. - A full immoscout24.ch search URL keeps its path and query filters unless
offer_typeorproperty_typeis also set. - A listing URL returns 400.
- A numeric id returns 400.
- There is no default.
offer_typeLink to offer_type
Optional string. Default rent when query is a city. When omitted on a search URL, the URL path is kept.
rent(aliasmieten):results[].offer_typeisrent.priceis the monthly gross rent.price_intervalismonthwhen the listing says so.buy(aliaseskaufen,sale):results[].offer_typeisbuy.priceis the sale price.- Any other value returns 400.
property_typeLink to property_type
Optional string. Default apartment when query is a city. When omitted on a search URL, the URL category is kept.
apartment(aliasesflat,wohnung): flats. The path useswohnung.house(aliashaus): houses. The path useshaus.all(aliasimmobilien): every residential type.results[].categorieslists the categories on the card.- Any other value returns 400.
pageLink to page
Optional integer. Default 1.
- Page 1 omits
pn. Page 2 sendspn=2. pagination.pageis the page you asked for.pagination.nextis the next search URL, or null on the last page.- A value below 1 returns 400.
return_page_sourceLink to return_page_source
Optional boolean. Default false. true returns { "result": "<html>" } instead of results and pagination.
Response fieldsLink to Response fields
| Field | Type | Description |
|---|---|---|
results[].id |
string | Listing id |
results[].url |
string | Listing URL. Not a callable property endpoint |
results[].title |
string or null | Listing title |
results[].offer_type |
string or null | rent or buy |
results[].categories |
array | Categories such as apartment and flat |
results[].price |
number or null | CHF amount. Gross monthly rent, or the sale price |
results[].price_display |
string or null | Same amount rebuilt as CHF 2'257 |
results[].currency |
string or null | CHF |
results[].price_interval |
string or null | month for a rental |
results[].rooms |
number or null | Room count |
results[].living_space |
number or null | Living area in m² |
results[].bathrooms |
number or null | Bathrooms |
results[].floor |
number or null | Floor |
results[].street |
string or null | Street |
results[].locality |
string or null | City |
results[].postal_code |
string or null | Postal code |
results[].canton |
string or null | Canton code |
results[].latitude |
number or null | Latitude |
results[].longitude |
number or null | Longitude |
results[].image_url |
string or null | First photo |
results[].features |
array | Feature keys |
results[].description |
string or null | Short description |
pagination.page |
integer | Current page |
pagination.per_page |
integer | Page size |
pagination.total_results |
integer or null | Matching listings |
pagination.total_pages |
integer or null | Page count |
pagination.next |
string or null | Next search URL, or null |
NotesLink to Notes
price_display is rebuilt from price with an apostrophe as the thousands separator, and without a trailing dash. When price is present, that number is the amount in price_display.
Use casesLink to Use cases
- Track asking rents in Zurich, Geneva, and other Swiss cities
- Compare apartments and houses for sale from a saved search URL
- Page through a city search with
page
Error codesLink to Error codes
| Code | Meaning |
|---|---|
| 400 | Missing query, unknown offer or property type, unknown domain, or a listing URL |
| 401 | Missing API key |
| 404 | The search page had no listings |
| 500 | The page could not be rendered |
Ready to get started?
Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.
- +500 credits
- No credit card required
- All endpoints included