Hm APIwww2.hm.com ↗

"""
H&M US Store API - Browse products, search, and find stores
Get your API key from: https://parse.bot/settings
"""

from parse_apis.h_m_us_store_api import HM, Product, ProductListing, Store, Category, RecommendationList

hm = HM(api_key="YOUR_API_KEY")

# Search for products by keyword
for product in hm.products.search(query="denim jacket", limit=5):
    print(product.product_name, product.brand_name)
    for price in product.prices:
        print(price.formatted_price, price.price_type)

# Get full product details by article code
detail = hm.products.get(article_code="1347416001")
print(detail.product_name, detail.color_name)
for swatch in detail.swatches:
    print(swatch.color_name, swatch.color_code)

# Get similar product recommendations
for rec_list in detail.similar():
    print(rec_list.label, rec_list.id)
    for item in rec_list.product_list:
        print(item.product_name)

# Browse category listings
for listing in hm.productlistings.list(category="men/products/view-all", limit=3):
    print(listing.title, listing.article_code, listing.regular_price)

# Get sale products
for item in hm.productlistings.sale(category="women/sale/view-all", limit=3):
    print(item.title, item.red_price, item.discount_percentage)

# Navigate from listing to full detail
first_listing = next(iter(hm.productlistings.new_arrivals(category="men/new-arrivals/view-all", limit=1)))
full_product = first_listing.details()
print(full_product.product_name, full_product.availability.stock_state)

# Browse the category tree
for category in hm.categories.list():
    print(category.node_name, category.href)
    for child in category.children:
        print(child.node_name)

# Find stores by city
for store in hm.stores.search(city="New York"):
    print(store.name, store.city)
    print(store.address.street_name, store.address.state)
    for hours in store.opening_hours:
        print(hours.name, hours.opens, hours.closes)