hepsiburada.com APIhepsiburada.com ↗
Access Hepsiburada product data, prices, reviews, categories, and campaigns via 5 endpoints. Filter by keyword, price range, and page.
curl -X GET 'https://api.parse.bot/scraper/a42a78b8-347f-4c69-8e83-135320d2b001/search_products?page=1&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword query on Hepsiburada. Returns paginated product listings with brand, rating, and review count. Supports price filters.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword (e.g. 'laptop', 'headphones', 'SSD') |
| filters | string | Advanced filter string in the format used by Hepsiburada (e.g. 'fiyat:0-1000' for a price range of 0–1000 TL). |
{
"type": "object",
"fields": {
"page": "integer current page number",
"products": "array of product objects with productId, brand, rating, reviewCount, and other fields",
"totalCount": "integer total number of search results"
},
"sample": {
"data": {
"page": 1,
"products": [
{
"sku": null,
"url": null,
"name": null,
"brand": "Lenovo",
"price": null,
"rating": 5,
"imageUrl": null,
"priceText": null,
"productId": "HBC0000DLDY3M",
"isSponsored": false,
"reviewCount": 49,
"discountRate": null,
"merchantName": null
}
],
"totalCount": 8152
},
"status": "success"
}
}About the hepsiburada.com API
The Hepsiburada API provides 5 endpoints covering product search, full product details, customer reviews, category navigation, and active campaigns from Hepsiburada.com, Turkey's largest e-commerce marketplace. The get_product_details endpoint returns price, stock status, specifications, and a structured review summary in a single call, while search_products supports keyword queries with price-range filters and pagination.
Product Search and Details
The search_products endpoint accepts a query string (e.g. 'laptop' or 'SSD') and returns a paginated list of matching products. Each product object includes productId, brand, rating, and reviewCount. You can narrow results using the filters param, which accepts Hepsiburada's native filter syntax — for example, 'fiyat:0-1000' restricts results to items priced between 0–1000 TL. The totalCount field lets you calculate how many pages exist before iterating.
The get_product_details endpoint accepts a bare product ID in HBC format (e.g. HBC00006TCEUL), a full product URL, or a slug path. It returns product_name, brand, unit_price, original_price, stock_status, category (as a > -separated hierarchy string), description, specifications (array or null), and a review_summary object containing average_rating, total_reviews, and rating_distribution.
Reviews and Category Navigation
get_product_reviews accepts the same flexible product identifier as get_product_details and returns paginated review objects. Each review includes id, userName, rating, comment, createdAt, merchantName, and isPurchaseVerified. The averageRating and totalCount fields are returned at the top level alongside the reviews array, making it straightforward to aggregate sentiment without iterating all pages.
get_category_tree takes no inputs and returns the full Hepsiburada category hierarchy as a nested tree. Each node exposes id, title, url, entityType, and a children array for subcategories. The get_campaigns endpoint retrieves the current promotional campaign page, returning campaign cards with titles, images, and URLs inside a structured result.data.items array along with seoData.
- Build a price-comparison tool using
unit_priceandoriginal_pricefields fromget_product_details. - Track discount depth on active promotions by combining
get_campaignscard URLs withget_product_detailspricing data. - Aggregate seller and product sentiment by collecting
isPurchaseVerifiedreviews across categories viaget_product_reviews. - Populate an e-commerce catalog mirror using the
categoryhierarchy fromget_product_detailsand the full tree fromget_category_tree. - Monitor stock availability at scale by polling
stock_statusacross a list of Hepsiburada product IDs. - Conduct brand share analysis by querying
search_productswith category-specific keywords and counting results bybrand. - Build a review monitoring dashboard tracking
rating,createdAt, andmerchantNametrends over time for specific products.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Hepsiburada have an official developer API?+
What does the `filters` parameter in `search_products` accept?+
'fiyat:0-1000', which limits results to products priced between 0 and 1000 TL. Other attribute-based filters follow the same colon-separated key-value pattern used on the Hepsiburada site. Only one filter string is passed per request; combining multiple filter dimensions depends on how Hepsiburada's own filter syntax concatenates them.Can I retrieve seller listings or compare multiple merchant offers for the same product?+
get_product_details returns a single unit_price and original_price without breaking out individual seller offers or a merchant list. It covers product-level pricing and the review summary. You can fork this API on Parse and revise it to add an endpoint that surfaces per-seller offer data for a given product.How deep does pagination go in `get_product_reviews`?+
totalCount alongside the page field, so you can calculate total pages by dividing totalCount by the number of reviews per page. Pagination is controlled by the page integer param. Very high page numbers on products with thousands of reviews may return empty arrays if the source stops serving results beyond a certain depth.Does the API cover Hepsiburada Flash Deals or time-limited daily discounts?+
get_campaigns returns the general campaign page structure with promotional cards, but it does not expose a dedicated flash-deal or countdown-timer feed. It covers campaign titles, images, and URLs. You can fork this API on Parse and revise it to target the flash-deal section specifically.