ASDA APIasda.com ↗

"""Walkthrough: ASDA Groceries SDK — search, browse categories, get details and reviews."""
from parse_apis.asda_groceries_api import Asda, CategoryType, ProductNotFound

client = Asda()

# Search for products by keyword — limit= caps total items fetched.
for product in client.products.search(query="butter", limit=5):
    print(product.name, f"£{product.price}", product.availability)

# Get one product's full details via .first() then drill into reviews.
product = client.products.search(query="milk", limit=1).first()
if product:
    detail = client.products.get(id=product.id)
    print(detail.name, detail.brand, f"£{detail.price}", detail.package_size)

    for review in detail.reviews.list(limit=3):
        print(review.rating, review.user, review.text[:60] if review.text else "")

# Browse categories and filter by type using the enum.
for cat in client.categories.list(limit=10):
    if cat.type == CategoryType.DEPARTMENT:
        print(cat.name, cat.id)

# Drill into a category's products.
category = client.categories.list(limit=1).first()
if category:
    for p in category.products(limit=3):
        print(p.name, f"£{p.price}", p.category)

# Typed error handling for a missing product.
try:
    client.products.get(id="nonexistent_product_id_99999")
except ProductNotFound as exc:
    print(f"Product not found: {exc.product_id}")

# Browse rollback (price reduction) offers.
for deal in client.products.rollbacks(limit=3):
    print(deal.name, f"£{deal.price}", f"was £{deal.original_price}" if deal.original_price else "")

print("exercised: products.search / products.get / reviews.list / categories.list / category.products / products.rollbacks")