notonthehighstreet APInotonthehighstreet.com ↗

"""Not On The High Street SDK — browse unique handmade gifts, drill into details and reviews."""
from parse_apis.not_on_the_high_street_api import NotOnTheHighStreet, Sort, ProductNotFound

client = NotOnTheHighStreet()

# Search newest personalised gifts using the Sort enum.
for item in client.products.search(query="personalised gifts", sort=Sort.NEWEST, limit=3):
    print(item.title, item.price.currency, item.price.amount)

# Autocomplete: get search suggestions for a partial query.
for s in client.products.suggestions(query="birthday", limit=5):
    print(s.suggestion)

# Take the first result and navigate to full product details.
summary = client.products.search(query="music print", limit=1).first()
if summary:
    product = summary.details()
    print(product.title, product.inventory_status, product.number_of_reviews)

    # Walk the product's reviews sub-resource.
    for review in product.reviews.list(per_page=5, limit=3):
        print(review.rating, review.comment[:60])

    # Get similar product recommendations.
    for rec in product.similar(limit=3):
        print(rec.title, rec.price.amount)

# Browse a seller's catalog via the constructible Seller resource.
seller = client.seller(shortcode="elevencorners")
for p in seller.products.list(limit=3):
    print(p.title, p.seller_slug, p.product_slug)

# Typed error handling — catch when a product slug doesn't exist.
try:
    client.products.get(seller_slug="elevencorners", product_slug="nonexistent-product-xyz")
except ProductNotFound as exc:
    print(f"Not found: {exc.seller_slug}/{exc.product_slug}")

print("exercised: products.search / products.suggestions / summary.details / product.reviews.list / product.similar / seller.products.list / products.get")