docs / hepsiburada
Hepsiburada
Turkish marketplace products, prices and reviews.
base /hepsiburada/v12 endpoints
post
/hepsiburada/v1/product/detail1 creditFull Hepsiburada product details by URL or HB code (SKU): title, brand, price, discount, images, rating, stock status, seller (merchant), category, specifications, variants and top reviews.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sku | optional | — | Hepsiburada product code (HB code) — the HBCV… token in the product URL (…-p-<code>). Take it from search results. Provide sku OR url. |
| url | optional | — | Full Hepsiburada product URL — alternative to sku. |
| max_rotations = 8 | optional | 1–14 | Advanced: number of IP rotation attempts for difficult requests (1–14, default 8 — leave unchanged for typical use). |
post
/hepsiburada/v1/search2 creditsSearch Hepsiburada products by keyword — returns results with SKU, title, brand, price, list price, rating, image and merchant. Results may be empty for very niche queries; try a broader keyword in that case.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | What to search for (Turkish keywords work best). |
| page = 1 | optional | 1– | Page number (1, 2, 3…). |
| max_rotations = 8 | optional | 1–14 | Advanced: number of IP rotation attempts for difficult requests (1–14, default 8 — leave unchanged for typical use). |
Example request · product/detail
curl -X POST https://api.reefapi.com/hepsiburada/v1/product/detail \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"url":"https://www.hepsiburada.com/-p-HBCV00004X9ZCK"}'Response shape
{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}