Cityofberkeley APIrentregistry.cityofberkeley.info ↗

"""Walkthrough: Berkeley Rent Registry — search properties, inspect units, check stats."""
from parse_apis.berkeley_rent_registry_api import (
    BerkeleyRentRegistry,
    PropertyNotFound,
)

client = BerkeleyRentRegistry()

# Search for properties on a street — limit caps total items fetched.
for summary in client.propertysummaries.search(query="University Ave", limit=3):
    print(summary.apn, summary.address, summary.total_units)

# Drill into one result: get full property detail via the summary's navigation op.
summary = client.propertysummaries.search(query="University Ave", limit=1).first()
if summary:
    prop = summary.details()
    print(prop.address)
    for unit in prop.units[:3]:
        print(unit.regulation_type, unit.current_rent, unit.max_allowed_rent, unit.status)

# Find a property directly by address — single round-trip.
found = client.properties.find_by_address(address="University Ave")
print(found.apn, found.address, len(found.units))

# Typed error handling: catch PropertyNotFound for a bad address.
try:
    client.properties.find_by_address(address="99999 Nonexistent Blvd")
except PropertyNotFound as exc:
    print(f"not found: {exc.address}")

# Registration statistics — aggregate counts, no input needed.
stats = client.registrationstatses.get()
print(stats.open, stats.closed)

# Browse FAQs.
for faq in client.faqs.list(limit=3):
    print(faq.title, faq.language)

print("exercised: propertysummaries.search / summary.details / properties.find_by_address / registrationstatses.get / faqs.list")