Custom Lids APIcustomlids.com ↗

"""Walkthrough: Custom Lids SDK — search hats, inspect details, get a quote."""
from parse_apis.customlids_com_api import (
    CustomLids, SortOrder, DecorationMethod, InputNotFound,
)

client = CustomLids()

# Browse the catalog for snapback hats, capped at 5 results.
for hat in client.product_summaries.search(query="snapback", sort=SortOrder.BEST_SELLING, limit=5):
    print(hat.product_name, hat.brand, f"${hat.price}")

# Drill into the first matching product's full detail page.
summary = client.product_summaries.search(query="new era a-frame 9forty", limit=1).first()
if summary is not None:
    product = summary.details()
    print(product.product_name, product.color, product.available)
    print("Decoration methods:", product.decoration_methods)
    print("Thread colors:", product.thread_colors[:3])

    # Show available colorways for this product group.
    for color_opt in product.available_colors:
        print(f"  {color_opt.color}: ${color_opt.price} (in stock: {color_opt.available})")

    # Get a price quote: 12 embroidered hats with raised embroidery.
    quote = product.get_price(
        decoration_method=DecorationMethod.EMBROIDERY,
        quantity=12,
        embroidery_sides=2,
        raised_embroidery=True,
    )
    print(f"Unit price: ${quote.unit_discounted_price}  Total: ${quote.total_order_price}")
    print(f"Discount: {quote.quantity_discount_percent}% (tier {quote.quantity_tier})")
    for line in quote.decoration_line_items:
        print(f"  {line.item}: ${line.unit_price} x{line.quantity_per_hat}")

# Fetch a product directly by handle and catch a not-found error.
try:
    specific = client.products.get(product_handle="this-hat-does-not-exist")
except InputNotFound:
    print("Product not found — handle may be stale.")

# Read site-wide pricing rules (no inputs needed).
rules = client.pricing_rules.get()
print(f"Setup fee: ${rules.setup_fee} (waived from {rules.setup_fee_waived_from_quantity} units)")
for tier in rules.quantity_discounts:
    print(f"  {tier.quantity_range}: {tier.customized_discount_percent}% off customized")

print("exercised: product_summaries.search / details / products.get / get_price / pricing_rules.get")