PadMapper APIpadmapper.com ↗

"""PadMapper SDK — search rentals, browse map pins, get building details and city stats."""
from parse_apis.padmapper_api import PadMapper, ListingNotFound

client = PadMapper()

# Search listings in Montreal with price filters, capped to 5 results
for listing in client.listings.search(city_slug="montreal-qc", min_price=1200, max_price=2500, limit=5):
    print(listing.building_name, listing.address, listing.min_price, listing.max_price)

# Drill into first result for full building details
listing = client.listings.search(city_slug="toronto-on", bedrooms="1,2", limit=1).first()
if listing:
    building = client.buildings.get(listing_id=f"p{listing.pb_id}")
    print(building.name, building.formatted_address, building.description[:80])

    # Get contact info via instance method
    contact = building.contact()
    for agent in contact.agents:
        print(agent.long_name, agent.email, agent.company_name)

# Get city overview with price trends and neighborhoods
overview = client.cityoverviews.get(city_slug="montreal-qc")
print(overview.city_name, overview.listing_count)
for hood in overview.neighborhoods[:3]:
    print(hood.name, hood.listing_count, hood.lat, hood.lng)

# Map-based search for pins in a bounding box
for pin in client.mappins.search(west=-73.59, south=45.49, east=-73.55, north=45.52, limit=3):
    print(pin.building_name, pin.address, pin.min_price, pin.max_price)

# Typed error handling for a non-existent listing
try:
    client.buildings.get(listing_id="p999999999")
except ListingNotFound as exc:
    print(f"Not found: {exc}")

print("exercised: listings.search / buildings.get / building.contact / cityoverviews.get / mappins.search / ListingNotFound")