Gap Canada APIgapcanada.ca ↗

"""Walkthrough: Gap Canada catalog — browse categories, list products, drill into detail."""
from parse_apis.gap_canada_product_catalog_api import GapCanada, ProductNotFound

client = GapCanada()

# List all categories, take the first one to explore.
category = client.categories.list(limit=5).first()
print(f"Category: {category.name} ({category.division}) — cid={category.cid}")

# Browse products in that category (capped to 3 items).
for product in category.products.list(limit=3):
    print(f"  {product.style_name} | {product.color_name} | ${product.effective_price} (was ${product.regular_price})")

# Drill into the first product's full detail via the summary → detail nav op.
summary = category.products.list(limit=1).first()
detail = summary.details()
print(f"\nDetail: {detail.name} — {len(detail.skus)} SKUs, sizes: {detail.sizes}")
for sku in detail.skus[:3]:
    print(f"  SKU {sku.sku_id}: size {sku.size}, status={sku.inventory_status}, ${sku.effective_price}")

# Fetch a product directly by pid.
try:
    direct = client.products.get(pid=summary.cc_id)
    print(f"\nDirect fetch: {direct.name}, currency={direct.currency}, variants={len(direct.customer_choice_ids)}")
except ProductNotFound as exc:
    print(f"Product not found: {exc}")

print("\nExercised: categories.list / category.products.list / summary.details / products.get")