Comparis APIcomparis.ch ↗

"""Walkthrough: Comparis.ch SDK — search Swiss real estate, cars, and mortgage rates."""
from parse_apis.comparis_ch_api import (
    Comparis, DealType, RealEstateSort, VehicleType, ListingNotFound
)

client = Comparis()

# Fetch available real estate filter vocabulary (deal types, property types, sort options).
filters = client.realestatefilters.get()
print(f"Deal types: {filters.deal_types}, Property types available: {len(filters.property_types)}")

# Search rental apartments in Zurich, sorted by date, capped at 3 results.
for listing in client.realestatelistingsummaries.search(
    location="Zurich", deal_type=DealType.RENT, sort=RealEstateSort.DATE_DESC, limit=3
):
    print(f"  {listing.title} — CHF {listing.price_value}, {listing.property_type_text}")

# Drill into one listing's full details via .first() then .details().
listing = client.realestatelistingsummaries.search(
    location="Zurich", deal_type=DealType.RENT, limit=1
).first()
if listing:
    detail = listing.details()
    print(f"Detail: {detail.title}, rooms={detail.num_rooms}, floor={detail.floor}")

# Typed error handling when fetching a listing by ID.
try:
    full = client.realestatelistings.get(ad_id="999999999")
    print(f"Found: {full.title}")
except ListingNotFound as exc:
    print(f"Listing gone: {exc}")

# Search used cars under CHF 20,000 from 2015+.
for car in client.carlistingsummaries.search(
    vehicle_type=VehicleType.USED, price_to=20000, year_from=2015, limit=3
):
    print(f"  {car.make} {car.model} — CHF {car.price}, {car.vehicle_type}")

# Fetch current mortgage rates and inspect the Comparis benchmark.
rates = client.mortgagerates.get()
print(f"Comparis benchmark rate: {rates.comparis_offer.interest_rate}%")
for term in rates.term_informations[:3]:
    print(f"  {term.term}y: {term.local_min}%-{term.local_max}%")

print("Exercised: realestatefilters.get / realestatelistingsummaries.search / details / realestatelistings.get / carlistingsummaries.search / mortgagerates.get")