WatchBase APIwatchbase.com ↗

from parse_apis.watchbase_api import WatchBase, Brand, BrandSummary, Collection, WatchSummary, CaliberBrand, CaliberSummary

watchbase = WatchBase()

# Search for watches across the entire database
for watch_summary in watchbase.brands.search_watches(query="daytona", limit=5):
    print(watch_summary.reference, watch_summary.name, watch_summary.thumbnail_url)

# List all brands
for brand_summary in watchbase.brands.list(limit=3):
    print(brand_summary.name, brand_summary.slug, brand_summary.watch_count)

# Fetch a full brand profile using constructible Brand
rolex = watchbase.brand("rolex")

# Navigate to collections sub-resource
for collection in rolex.collections.list(limit=3):
    print(collection.name, collection.slug, collection.watch_count)

# List watches in a collection using constructible Collection
submariner = watchbase.collection("submariner")
for ws in submariner.watches.list(brand_slug="rolex", limit=2):
    print(ws.reference, ws.name, ws.url)

    # Get full watch details
    watch = ws.details(brand_slug="rolex", collection_slug="submariner")
    print(watch.name, watch.reference, watch.produced, watch.description)
    if watch.case:
        print(watch.case.material, watch.case.diameter, watch.case.water_resistance)
    if watch.dial:
        print(watch.dial.color, watch.dial.indexes)

    # Get image URLs for this watch
    for img_url in ws.images(brand_slug="rolex", collection_slug="submariner", limit=5):
        print(img_url)

# List all caliber brands
for caliber_brand in watchbase.brands.list_all_calibers(limit=2):
    print(caliber_brand.brand_name, caliber_brand.brand_slug)
    for cal in caliber_brand.calibers:
        print(cal.name, cal.slug)

# Get caliber details via brand sub-resource
for cal_summary in rolex.calibers.list(limit=2):
    print(cal_summary.name, cal_summary.slug)
    caliber = cal_summary.details(brand_slug="rolex")
    print(caliber.reference, caliber.movement, caliber.jewels, caliber.reserve)
    for wr in caliber.watches_using_caliber:
        print(wr.reference, wr.url)