Alcampo APIcompraonline.alcampo.es ↗

"""Walkthrough: Alcampo Online Supermarket SDK — bounded, re-runnable."""
from parse_apis.alcampo_online_supermarket_api import Alcampo, ProductNotFound

client = Alcampo()

# Browse the category tree to discover retailerCategoryIds for browsing.
category = client.categories.list(limit=3).first()
if category:
    print(category.name, category.retailer_category_id, category.product_count)

# Search for products by keyword — limit caps total items fetched.
for group in client.productgroups.search(query="leche", limit=3):
    print(group.type, group.name)
    for product in group.decorated_products[:2]:
        print(" ", product.name, product.price.amount, product.brand)

# Browse a category's products.
for group in client.productgroups.by_category(category_id="OCLAC", limit=2):
    for product in group.decorated_products[:2]:
        print(product.name, product.available, product.price.currency)

# Drill into product details from a search result.
first_group = client.productgroups.search(query="pan", limit=1).first()
if first_group and first_group.decorated_products:
    summary = first_group.decorated_products[0]
    try:
        detail = summary.details()
        print(detail.name, detail.detailed_description, detail.ingredients)
    except ProductNotFound as exc:
        print(f"Product not found: {exc}")

# Find nearby stores by coordinates.
store = client.stores.search(lat=40.4168, lng=-3.7038, limit=1).first()
if store:
    print(store.name, store.city, store.distance, store.open_now)

# Check current promotions.
for group in client.productgroups.promotions(limit=2):
    for promo_product in group.decorated_products[:2]:
        for promo in promo_product.promotions:
            print(promo_product.name, promo.description, promo.type)

print("exercised: categories.list / productgroups.search / productgroups.by_category / details / stores.search / productgroups.promotions")