The Good Guys APIthegoodguys.com.au ↗

"""The Good Guys API — search products, browse categories/brands, check stores & delivery."""
from parse_apis.The_Good_Guys_API import (
    TheGoodGuys, CategoryHandle, BrandName, Postcode, ProductNotFound,
)

client = TheGoodGuys()

# Search for TVs — limit caps total items fetched across all pages.
for product in client.products.search(query="samsung tv", limit=5):
    print(product.title, product.price, product.vendor)

# Browse a category using the CategoryHandle enum (constructible resource).
tv_category = client.category(name=CategoryHandle.TELEVISIONS)
tv = tv_category.products(limit=1).first()
if tv:
    print(tv.title, tv.sku, tv.price)

    # Drill into sub-resources: reviews for this product.
    for review in tv.reviews.list(limit=3):
        print(review.your_name, review.rating, review.review_title)

    # Check delivery/stock availability at a given postcode.
    delivery = tv.delivery.check(postcode=Postcode._3000)
    for store_stock in delivery.check_stock_response.check_stock_response_object:
        print(store_stock.name, store_stock.distance, store_stock.in_store)

# Get products from a specific brand using the BrandName enum.
samsung = client.brand(name=BrandName.SAMSUNG)
for bp in samsung.products(limit=3):
    print(bp.title, bp.price)

# Get full product detail by handle.
detail = client.products.get_by_handle(handle="samsung-65-inches-ls03f-the-frame-pro-neo-qled-4k-mini-led-smart-ai-tv-2025-qa65ls03fwwxxy")
print(detail.title, detail.price, detail.body_html_safe[:80] if detail.body_html_safe else "")

# Find nearby stores by postcode.
for store in client.stores.find_nearby(postcode=Postcode._3000, limit=3):
    print(store.name, store.distance, store.address.suburb)

# Typed error handling for a product that doesn't exist.
try:
    client.products.get_by_handle(handle="nonexistent-product-xyz-12345")
except ProductNotFound as exc:
    print(f"Product not found: {exc.handle}")

print("exercised: products.search / category.products / reviews.list / delivery.check / brand.products / products.get_by_handle / stores.find_nearby")