Zid APIzid.store ↗

"""Walkthrough: Mazeed (zid.store) SDK — browse featured stores, drill into products."""
from parse_apis.zid_store_api import ZidStore, InputNotFound

client = ZidStore()

# Browse the featured "Top Stores" section, capped at 5 items.
for summary in client.store_summaries.featured(limit=5):
    print(summary.name.ar, summary.store_id)

# Pick the first featured store and navigate to its full profile.
top = client.store_summaries.featured(limit=1).first()
if top is not None:
    store = top.details()
    print(store.name.en, "— rating:", store.rating_average, f"({store.rating_count} reviews)")
    print("website:", store.website_url)

    # Show advertised coupons
    for coupon in store.coupons:
        print(f"  coupon {coupon.code}: {coupon.amount}% off" if coupon.type == "percentage" else f"  coupon {coupon.code}: {coupon.amount}")

    # List up to 3 products from this store
    for product in store.products.list(limit=3):
        print(f"  {product.title.en} — {product.currency} {product.price}", "(on sale)" if product.sale_price else "")

# Search stores by keyword and get one store's details via point lookup.
hit = client.store_summaries.search(query="عطر", limit=1).first()
if hit is not None:
    try:
        detail = client.stores.get(store_id=hit.store_id)
        print(detail.name.en, "delivers in ~", detail.average_delivery_days, "days")
    except InputNotFound:
        print("store no longer exists")

# List top-level marketplace categories
for cat in client.categories.list(limit=5):
    print(cat.name.en, cat.category_id)

print("exercised: store_summaries.featured / details / stores.get / products.list / store_summaries.search / categories.list")