sainsburys APIsainsburys.co.uk ↗

"""Walkthrough: Sainsburys grocery SDK — bounded, re-runnable; every call capped."""
from parse_apis.sainsburys_grocery_api import Sainsburys, CategoryId, ProductNotFound

client = Sainsburys()

# Search for products — limit= caps total items fetched
for product in client.products.search(query="bread", page_size=20, limit=3):
    print(product.name, product.retail_price.price, product.is_available)

# Drill into one product's full details by SKU
first = client.products.search(query="milk", limit=1).first()
if first:
    detail = client.products.get(sku=first.product_uid)
    print(detail.name, detail.brand, detail.short_description)
    if detail.reviews:
        print(detail.reviews.total, detail.reviews.average_rating)

# Browse products by category using the enum
for item in client.products.by_category(category_id=CategoryId._12431, limit=3):
    print(item.name, item.retail_price.price)
    for cat in item.categories:
        print(cat.id, cat.name)
    break

# List top-level categories and explore the full hierarchy tree
for category in client.categories.list(limit=5):
    print(category.name, category.slug)

tree = client.categories.tree()
print(tree.name, tree.slug, len(tree.children))

# Get trending search terms
trends = client.trendingtermses.get()
for term in trends.terms[:5]:
    print(term)

# Typed error handling
try:
    client.products.get(sku="9999999999")
except ProductNotFound as exc:
    print(f"Product not found: {exc}")

print("exercised: products.search / products.get / products.by_category / categories.list / categories.tree / trendingtermses.get")