ImmoScout24 APIimmoscout24.ch ↗
Search and retrieve Swiss property listings from ImmoScout24.ch. Filter by location, price, and rooms. Access details, images, and agency data via 6 endpoints.
What is the ImmoScout24 API?
The ImmoScout24 Switzerland API provides access to residential and commercial property listings across Switzerland through 6 endpoints. Use search_listings to filter rentals and purchases by location slug, CHF price range, and room count, or use search_office_listings for commercial properties including office, retail, and industrial spaces. Each listing object includes address, pricing, characteristics, and image data.
curl -X GET 'https://api.parse.bot/scraper/5a1f2c54-82bd-4f5d-8200-de59a3c1fc9b/search_listings?page=1&location=city-zurich&price_to=5000&rooms_to=5&offer_type=rent&price_from=500&rooms_from=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace immoscout24-ch-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: ImmoScout24 SDK — search Swiss property listings, drill into details."""
from parse_apis.immoscout24_api import ImmoScout24, OfferType, ListingNotFound
client = ImmoScout24()
# Search residential rentals in Zurich, bounded iteration
zurich = client.location("city-zurich")
for listing in zurich.search_residential(offer_type=OfferType.RENT, price_to=3000, rooms_from=2, limit=5):
print(listing.id, listing.listing_type)
# Drill into one listing's full details
first = zurich.search_residential(offer_type=OfferType.BUY, limit=1).first()
if first:
detail = first.details()
print(detail.title, detail.price, detail.currency, detail.rooms)
print(detail.address.locality, detail.address.postal_code)
# Sub-resource: photos
for photo in detail.photos.list(limit=3):
print(photo.listing_id, photo.images)
# Sub-resource: agency info
agency = detail.agency_info.get()
if agency.company:
print(agency.company.legal_name, agency.company.subscription_type)
# Search commercial listings in Geneva
geneva = client.location("canton-geneva")
for office in geneva.search_commercial(offer_type=OfferType.RENT, limit=3):
info = office.details()
print(info.title, info.offer_type, info.living_space_sqm)
# Typed error handling
try:
bad = client.location("city-zurich").search_residential(limit=1).first()
if bad:
bad.details()
except ListingNotFound as exc:
print(f"Listing gone: {exc.listing_id}")
print("exercised: search_residential / search_commercial / details / photos.list / agency_info.get")
Search for residential property listings for rent or buy on immoscout24.ch. Returns paginated results ordered by top listing score. Each page contains up to 20 listings with full address, price, characteristics, and image data. Pagination via the page parameter; total pages available in the response.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| location | string | Location slug for geographic filtering (e.g. 'city-zurich', 'canton-geneva', '8048'). |
| price_to | number | Maximum price in CHF. |
| rooms_to | number | Maximum number of rooms. |
| offer_type | string | Listing offer type. |
| price_from | number | Minimum price in CHF. |
| rooms_from | number | Minimum number of rooms. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"listings": "array of listing objects with id, address, categories, characteristics, prices, and localization data",
"page_count": "integer total number of pages",
"result_count": "integer total number of matching listings",
"has_next_page": "boolean indicating if more pages are available"
},
"sample": {
"data": {
"page": 1,
"listings": [
{
"id": "4002086198",
"listing": {
"prices": {
"rent": {
"gross": 2208,
"interval": "MONTH"
},
"currency": "CHF"
},
"address": {
"street": "Militärstrasse 106",
"locality": "Zürich",
"postalCode": "8004"
},
"offerType": "RENT",
"categories": [
"APARTMENT",
"FLAT"
],
"characteristics": {
"livingSpace": 24,
"numberOfRooms": 1.5
}
},
"listingType": {
"type": "PREMIUM"
}
}
],
"page_count": 50,
"result_count": 1100,
"has_next_page": true
},
"status": "success"
}
}About the ImmoScout24 API
Searching Listings
The search_listings endpoint accepts filters for location (e.g. city-zurich, canton-geneva, or a postal code like 8048), price_from, price_to, rooms_from, rooms_to, and offer_type (rent or buy). Results are paginated at up to 20 listings per page. The response includes result_count, page_count, and has_next_page so you can iterate through all matching records. For commercial properties, search_office_listings covers the same pagination structure but is scoped to office, retail, and industrial categories, with location and offer_type as its available filters.
Listing Details and Sub-Resources
Once you have a listing ID from either search endpoint, get_listing_details returns the full record: gross price in CHF, rooms, title, an HTML description, images array, and an address object that includes geoCoordinates alongside street, postal code, locality, and region fields. It also returns a company object with the agency's legalName, logoUrl, address, and subscriptionType. Two focused endpoints exist for retrieving subsets of this data: get_listing_images returns only the images array for a given listing_id, and get_listing_company returns only the company object.
Property Type Reference
The get_property_types endpoint takes no inputs and returns a static list of category strings used across the platform: APARTMENT, HOUSE, OFFICE, COMMERCIAL, RETAIL, STORAGE, and PARKING. These values correspond to the categories field returned in listing search results and can be used to understand how listings are classified before filtering or displaying them in your application.
The ImmoScout24 API is a managed, monitored endpoint for immoscout24.ch — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when immoscout24.ch changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official immoscout24.ch API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a Swiss rental search tool filtered by canton, price range, and minimum room count using
search_listings. - Aggregate commercial real estate availability across Swiss cities using
search_office_listingswith location slugs. - Display a listing detail page with address, geocoordinates, and HTML description from
get_listing_details. - Generate a property image gallery by fetching the
imagesarray viaget_listing_images. - Show agency branding and contact info by pulling
legalNameandlogoUrlfromget_listing_company. - Map property locations using
geoCoordinatesreturned in theaddressobject ofget_listing_details. - Classify and filter stored listings by property type using the static values from
get_property_types.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ImmoScout24 Switzerland offer an official developer API?+
How does the location filter work in `search_listings`?+
location parameter accepts a slug string in three forms: a city slug like city-zurich, a canton slug like canton-geneva, or a postal code string like 8048. Passing no location returns nationwide results. The search_office_listings endpoint uses the same slug format.Does the API return saved searches, user accounts, or mortgage calculator data?+
Is there a limit to how many results I can retrieve across all pages?+
search_listings or search_office_listings returns up to 20 listings. The response includes page_count and result_count so you know the full scope upfront, and has_next_page tells you whether to fetch the next page. Very broad searches (e.g., all Swiss listings with no filters) may return a large number of pages; narrowing by location or price range reduces the set.Does `get_listing_details` include floor plans or virtual tour links?+
images array, an HTML description, and core listing fields like price, rooms, address, and company. Dedicated floor plan images or virtual tour URLs are not currently returned as distinct fields. You can fork the API on Parse and revise it to surface those assets if they appear in the listing source.