Com APIdubizzle.com.eg ↗

"""Walkthrough: Dubizzle Egypt SDK — property search, agency exploration, and category filters."""
from parse_apis.dubizzle_egypt_api import DubizzleEgypt, Sort, PropertyNotFound

client = DubizzleEgypt()

# Search for apartments in Cairo sorted by price ascending
for listing in client.propertysummaries.search(
    location="cairo", category="apartments-duplex-for-sale", sort=Sort.PRICE_ASC, limit=3
):
    print(listing.title, listing.price, listing.currency)

# Drill into the first result for full details (photos, amenities, description)
listing = client.propertysummaries.search(location="cairo", limit=1).first()
if listing:
    detail = listing.details()
    print(detail.title, detail.area, detail.amenities)

# Search all classifieds (not just properties) by keyword
item = client.propertysummaries.search_all(query="iphone", limit=1).first()
if item:
    print(item.title, item.price, item.seller.name)

# Discover categories and get filter options for one
category = client.categories.list(limit=1).first()
if category:
    filters = category.filters()
    print(category.name, category.count, filters.bedrooms[0].value, filters.bedrooms[0].count)

# Browse top agencies and their listings
agency = client.agencies.list(limit=1).first()
if agency:
    print(agency.name, agency.ads_count)
    for prop in agency.listings(limit=2):
        print(prop.title, prop.price)

# Typed error handling: attempt to fetch a non-existent property
try:
    client.propertysummaries.search(limit=1).first().details()
except PropertyNotFound as exc:
    print(f"Property not found: {exc.ad_id}")

print("exercised: search / search_all / details / categories.list / filters / agencies.list / agency.listings")