JYSK APIjysk.ca ↗

"""Walkthrough: JYSK.ca SDK — search, browse categories, get details and availability."""
from parse_apis.jysk_ca_e_commerce_api import Jysk, ProductNotFound

client = Jysk()

# Search for sofas — limit caps total items fetched across all pages.
for product in client.products.search(query="sofa", limit=5):
    print(product.name, product.price, product.sku)

# Drill into one product's full details and dimensions.
product = client.products.search(query="mattress", limit=1).first()
if product:
    detail = product.details()
    print(detail.name, detail.product_id, detail.description[:80])
    for key, val in detail.specifications.items():
        print(f"  {key}: {val}")

    dims = product.dimensions()
    print(dims.measurements, dims.number_of_packages)
    for pkg in dims.package_dimensions_structured:
        print(f"  Package {pkg.package}: {pkg.value}")

# Check store availability for a product.
if product:
    for store in product.availability.list(limit=3):
        print(store.source_id, store.quantity, store.store_pickup_label)

# Browse a category to find products.
for p in client.products.browse_category(category_path="living-room-furniture/sofas-sofa-beds-futons", limit=3):
    print(p.name, p.price, p.url)

# List top-level categories and their subcategories.
cat = client.categories.list(limit=1).first()
if cat:
    print(cat.name, cat.url)
    for sub in cat.subcategories:
        print(f"  {sub.name}: {sub.url}")

# Typed error handling for a non-existent product.
try:
    bad = client.products.search(query="sofa", limit=1).first()
    if bad:
        bad.details()
except ProductNotFound as exc:
    print(f"Product not found: {exc}")

print("exercised: products.search / browse_category / details / dimensions / availability.list / categories.list")