Hepsiburada APIhepsiburada.com ↗

"""Walkthrough: Hepsiburada SDK — search products, drill into details and reviews, browse categories and campaigns."""
from parse_apis.hepsiburada_api import Hepsiburada, ProductSummary, Product, Review, Category, CampaignPage, ProductNotFound

hepsiburada = Hepsiburada()

# Search for SSDs with a price filter, capped at 5 results
for item in hepsiburada.products.search(query="SSD", filters="fiyat:0-2000", limit=5):
    print(item.name, item.brand, item.price, item.review_count)

# Drill into the first search result's full details
result = hepsiburada.products.search(query="laptop", limit=1).first()
if result:
    full = result.details()
    print(full.product_name, full.category, full.unit_price, full.stock_status)
    print(full.review_summary.average_rating, full.review_summary.total_reviews)

# Fetch reviews for a known product via constructible Product
product = hepsiburada.product(product_id="HBC0000DLDY3M")
for review in product.list_reviews(limit=3):
    print(review.user_name, review.rating, review.comment[:60], review.is_purchase_verified)

# Browse top-level categories
for category in hepsiburada.categories.list(limit=5):
    print(category.title, category.entity_type, category.id)

# Get active campaigns
campaigns = hepsiburada.campaignpages.get()
print(campaigns.data)

# Typed error handling
try:
    bad = hepsiburada.products.search(query="nonexistent_xyz_zzz", limit=1).first()
    if bad:
        bad.details()
except ProductNotFound as exc:
    print(f"Product not found: {exc.url}")

print("exercised: products.search / details / product.list_reviews / categories.list / campaignpages.get")