Woolworths APIwoolworths.co.za ↗

"""Walkthrough: Woolworths South Africa SDK — bounded, re-runnable."""
from parse_apis.Woolworths_South_Africa_API import Woolworths, ParseError

client = Woolworths()

# Browse food categories
for category in client.categories.list(limit=5):
    print(category.name, category.url)

# Search for products by keyword
for product in client.product_summaries.search(query="bread", limit=5):
    print(product.name, product.price, product.on_sale)

# Drill-down: get full details from a search result
item = client.product_summaries.search(query="chicken", limit=1).first()
if item:
    detail = item.details()
    print(detail.name, detail.brand, detail.rating, detail.review_count)
    for nutrient in detail.nutritional_info[:3]:
        print(nutrient.nutrient, nutrient.per_100g_ml, nutrient.unit)

# Browse products in a specific category (constructible by url/group_id)
pantry = client.category(url="ncat0010251")
for product in pantry.products(limit=3):
    print(product.name, product.price, product.price_per_kg)

# Find stores near a suburb
suburb = client.suburbs.list(limit=1).first()
if suburb:
    print(suburb.name, suburb.postal_code)
    for store in suburb.stores.list(distance=25, limit=3):
        print(store.name, store.address, store.phone)

# List provinces with availability flags
for province in client.provinces.list(limit=5):
    print(province.name, province.store_pickup_enabled, province.liquor_delivery_enabled)

# Handle errors gracefully
try:
    bad = client.category(url="invalid_category_xyz")
    list(bad.products(limit=1))
except ParseError as e:
    print(f"Error: {e}")

print("exercised: categories.list / product_summaries.search / details / category.products / suburbs.list / stores.list / provinces.list")