Skip to main content
Piloterr
Back to library

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.

Active2 credits = 1 requestGET/v2/immoscout24ch/search

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, or lucerne. The city is sent as ort-{slug}.
  • Default for a city: apartments for rent. results[].offer_type is rent and results[].price is the monthly gross rent in CHF.
  • A full immoscout24.ch search URL keeps its path and query filters unless offer_type or property_type is 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 (alias mieten): results[].offer_type is rent. price is the monthly gross rent. price_interval is month when the listing says so.
  • buy (aliases kaufen, sale): results[].offer_type is buy. price is 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 (aliases flat, wohnung): flats. The path uses wohnung.
  • house (alias haus): houses. The path uses haus.
  • all (alias immobilien): every residential type.
  • results[].categories lists the categories on the card.
  • Any other value returns 400.

pageLink to page

Optional integer. Default 1.

  • Page 1 omits pn. Page 2 sends pn=2.
  • pagination.page is the page you asked for.
  • pagination.next is 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