Piloterr

ImmoScout24 Switzerland Search

GET
/v2/immoscout24ch/search

Search ImmoScout24.ch listings by city or search URL and retrieve the CHF price, rooms, living area, and address. Property pages are not available.

Credit cost: 2 credits per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Swiss city or a full ImmoScout24.ch search URL.

Example (city):

zurich

Example (search URL):

https://www.immoscout24.ch/de/wohnung/mieten/ort-zuerich

JSON: a city opens apartments for rent unless offer_type or property_type is set. results[].offer_type is rent and results[].price is the monthly gross rent in CHF. A listing URL such as /mieten/{id} returns 400. Property pages are not available.

offer_type?string

rent or buy.

Default: rent when query is a city. A search URL keeps its path unless this is set.

Aliases: mieten, kaufen, sale (sale means buy).

JSON: rent sets results[].offer_type to rent and price to the monthly gross rent. buy sets offer_type to buy and price to the sale price.

property_type?string

apartment, house, or all.

Default: apartment when query is a city. A search URL keeps its category unless this is set.

Aliases: flat and wohnung mean apartment. haus means house. immobilien means all.

JSON: apartment requests wohnung. house requests haus. all requests immobilien. results[].categories reflects that category.

page?number

Page from 1.

Default: 1. Page 1 omits pn. Page 2 sends pn=2.

JSON: pagination.page is the page you asked for. pagination.next is the next search URL, or null on the last page.

Default"1"
return_page_source?boolean

Optional. Default false.

false returns the parsed JSON described below. true returns {"result": ""} and omits results, pagination, and listing fields.

Default"false"

Response Body

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/immoscout24ch/search?query=string'
Example Response
{  "results": [    {      "id": "4002086198",      "url": "https://www.immoscout24.ch/mieten/4002086198",      "floor": null,      "price": 2257,      "rooms": 1.5,      "title": "City Pop - Cosy Studio Apartments just next to HB Zürich",      "canton": "ZH",      "street": "Militärstrasse 106",      "currency": "CHF",      "features": [        "has_cable_tv",        "has_dishwasher",        "has_elevator",        "has_garage",        "has_nice_view",        "has_parking",        "is_ground_floor_raised",        "is_quiet"      ],      "latitude": 47.375904371673,      "locality": "Zürich",      "bathrooms": 1,      "image_url": "https://cdn.immoscout24.ch/listings/v2/e335city/4002086198/image/92c334cb2a581eeda57f107e6b2d3fd3.jpg",      "longitude": 8.518085354726,      "price_net": null,      "categories": [        "apartment",        "flat"      ],      "created_at": "2025-04-07T14:53:38.768Z",      "offer_type": "rent",      "year_built": 2025,      "description": "Wir bieten zentral gelegene Apartments im Gebäude City Pop Zurich City an der Militarstrasse 106, 8004 Zürich an, die zwischen 19 und 46 Quadratmeter gross sind.",      "extra_costs": null,      "postal_code": "8004",      "living_space": 24,      "price_display": "CHF 2'257",      "ceiling_height": null,      "price_interval": "month",      "year_renovated": 2025    }  ],  "pagination": {    "next": "https://www.immoscout24.ch/de/wohnung/mieten/ort-zuerich?pn=2",    "page": 1,    "per_page": 20,    "total_pages": 50,    "total_results": 1222  }}