comparis.ch APIcomparis.ch ↗
Access Swiss real estate listings, car marketplace data, and mortgage interest rates from Comparis.ch via 7 structured API endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/f21cd4c4-6927-4b2b-96d5-738e8b93b458/get_real_estate_filters' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns available filters and property types for real estate search, including deal types, property type IDs, and sort options.
No input parameters required.
{
"type": "object",
"fields": {
"deal_types": "object mapping deal type ID to label (10=Rent, 20=Buy)",
"sort_options": "object mapping sort ID to label",
"property_types": "object mapping property type ID to label"
},
"sample": {
"data": {
"deal_types": {
"10": "Rent",
"20": "Buy"
},
"sort_options": {
"0": "Relevance",
"1": "Price Ascending",
"2": "Price Descending",
"3": "Date Descending"
},
"property_types": {
"1": "Wohnung",
"3": "WG-Zimmer",
"4": "Grundstück",
"5": "Parkplatz, Garage",
"8": "Gewerbeobjekt",
"9": "Bastelraum",
"10": "Haus"
}
},
"status": "success"
}
}About the comparis.ch API
The Comparis.ch API covers 7 endpoints across three Swiss marketplace verticals: real estate listings, car listings, and mortgage interest rates. Use search_real_estate to query properties by location, price range, room count, and deal type, search_cars to filter vehicles by make, mileage, and registration year, or get_mortgage_rates to retrieve current benchmark rates and per-term min/max ranges from Swiss providers.
Real Estate Endpoints
The real estate surface starts with get_real_estate_filters, which returns the full set of valid deal_type IDs (10=Rent, 20=Buy), sort_options, and property_type IDs needed to build structured queries. search_real_estate accepts those filter values alongside location (city name or postal code), price_to, area_from/area_to in m², and rooms_to, returning paginated listing arrays with fields like AdId, Title, Address, Price, and PropertyTypeText. Pass any AdId to get_real_estate_detail for the full record: NumRooms, AddressSegments, Features, PriceInformation, MapData, contact_information, and external source_links.
Car Marketplace Endpoints
get_car_filters returns all available Makes with their MakeId and DisplayName values; Models and ModelGroups arrays are populated once a make is selected. search_cars accepts a make ID, optional model, price_to in CHF, year_from, mileage_to in km, and vehicle_type (1=New, 2=Used), returning paginated results with per-listing fields including Make, Model, Price, VehicleType, and Specifications. get_car_detail returns the complete record for a single vehicle: MainInformation (make, model, mileage, registration date, condition), Overview (fuel type, transmission, body type, engine info, seats, doors), TechnicalDetails (color, weight, emissions, engine size), PriceInformation (Price, MarketPrice, OriginalPrice), Features as a flat string array, and ContactInformation with dealer name, address, and phone.
Mortgage Rates Endpoint
get_mortgage_rates requires no inputs and returns structured rate data for Switzerland. The response includes a ComparisOffer benchmark object with InterestRate and ProviderId, a ProviderInfos array with per-provider rates and ProductId references, TermInformations with Term in years and LocalMin/LocalMax/ServiceMin/ServiceMax rate fields for each term length, and ProviderFootnotes with regulatory or disclaimer text indexed to specific providers.
- Aggregate Swiss rental listings by city using
search_real_estatewithdeal_type=10and alocationfilter - Track asking price distributions for apartments in a canton by iterating
search_real_estatepages witharea_from/area_tobounds - Build a used-car price comparison tool using
search_carsfiltered bymake,year_from, andmileage_to - Display full dealer contact details and feature lists for specific vehicles via
get_car_detail - Monitor Swiss fixed-rate mortgage benchmarks across different term lengths using
get_mortgage_ratesTermInformations - Populate property detail pages with
MapData,Features, andPriceInformationfromget_real_estate_detail - Index car make and model hierarchies for autocomplete using the
MakesandModelGroupsarrays fromget_car_filters
| 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 | 250 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 Comparis.ch have an official developer API?+
What does `get_mortgage_rates` return, and does it include per-bank product details?+
get_mortgage_rates returns the Comparis benchmark rate (ComparisOffer), a ProviderInfos array with ProviderId, InterestRate, and ProductId per provider, TermInformations with min/max rates for each mortgage term in years, and ProviderFootnotes. It does not return individual bank product names, application URLs, or eligibility criteria beyond what ProviderFootnotes contains.Does `search_real_estate` support filtering by specific canton or Swiss region?+
location parameter accepts city names or postal codes. There is no dedicated canton or region parameter. You can fork this API on Parse and revise it to add a canton-level filter if needed.Does the car search support filtering by fuel type or transmission?+
search_cars filters cover make, model, price_to, year_from, mileage_to, and vehicle_type (New/Used). Fuel type and transmission data are available in get_car_detail under Overview, but cannot be used as search filters at this time. You can fork the API on Parse and revise it to add those filter parameters.What pagination behavior should I expect from `search_real_estate` and `search_cars`?+
page parameter and return a page field in the response. total_count is present but may be null for some queries, so you should paginate until the returned listings array is empty rather than relying solely on total_count to determine when to stop.