E-commerce & Marketplaces

Hepsiburada API

The Hepsiburada API returns product data from a leading Turkish e-commerce marketplace as clean JSON.

6 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary product/detail endpoint returns a product's title, brand, price (TRY), original price, discount rate, images, rating, review count, stock and seller, and you can pull product/reviews, product/offers, run a search, browse a category and pull a seller. It is built for price intelligence, catalog enrichment and Turkish e-commerce analytics that need Hepsiburada data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/hepsiburada/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "laptop"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "hepsiburada",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 5227.4,
    "record_count": 18,
    "bytes": 3282141,
    "cache_hit": false,
    "completeness_pct": 100,
    "render": "ssr",
    "pagination": {
      "page": 1,
      "has_more": true
    }
  },
  "data": {
    "results": [
      {
        "sku": "HBCV00009P0ZN4",
        "title": "Lenovo Ideapad Slim 3 16IRH10 Intel Core I5-13420H 16GB 512GB SSD 16\" WUXGA (1920X1200) IPS Panel Freedos Taşınabilir Dizüstü Bilgisayar 83K20073TR",
        "brand": "Lenovo",
        "url": "https://www.hepsiburada.com/lenovo-ideapad-slim-3-16irh10-intel-core-i5-13420h-16gb-512gb-ssd-16-wuxga-1920x1200-ips-panel-freedos-tasinabilir-dizustu-bilgisayar-83k20073tr-p-HBCV00009P0ZN4",
        "image": "https://productimages.hepsiburada.net/s/777/222-222/[redacted-phone].jpg",
        "price": 27299,
        "original_price": 27299,
        "discount_rate": 0,
        "currency": "TRY",
        "rating": 4.7,
        "rating_count": 100,
        "merchant": null,
        "installment_count": null
      },
      {
        "sku": "HBCV0000A10UR3",
        "title": "Acer Aspire Lite AL16-54P Intel Core i5 1334U 16GB 512GB SSD Freedos 15.6'' FHD Taşınabilir Bilgisayar NX.D76EY.001",
        "brand": "Acer",
        "url": "https://www.hepsiburada.com/acer-aspire-lite-al16-54p-intel-core-i5-1334u-16gb-512gb-ssd-freedos-15-6-fhd-tasinabilir-bilgisayar-nx-d76ey-001-p-HBCV0000A10UR3",
        "image": "https://productimages.hepsiburada.net/s/777/222-222/[redacted-phone].jpg",
        "price": 23999,
        "original_price": 23999,
        "discount_rate": 0,
        "currency": "TRY",
        "rating": 4.2,
        "rating_count": 39,
        "merchant": null,
        "installment_count": null
      },
      {
        "sku": "HBCV0000COLVCS",
        "title": "HP AI 15 Intel Core Ultra 5 225U 16GB 512GB SSD Freedos 15.6\" Taşınabilir Bilgisayar D51E0EA",
        "brand": "HP",
        "url": "https://www.hepsiburada.com/hp-ai-15-intel-core-ultra-5-225u-16gb-512gb-ssd-freedos-15-6-tasinabilir-bilgisayar-d51e0ea-p-HBCV0000COLVCS",
        "image": "https://productimages.hepsiburada.net/s/777/222-222/[redacted-phone].jpg",
        "price": 26999,
        "original_price": 26999,
        "discount_rate": 0,
        "currency": "TRY",
        "rating": 4.4,
        "rating_count": 48,
        "merchant": null,
        "installment_count": null
      }
    ],
    "query": "laptop",
    "page": 1,
    "render": "ssr"
  }
}

Actions

What the Hepsiburada API does

Action	Description	Concrete use case	Key params
product/detail	Full Hepsiburada product details by `url` or HB code (`sku`): title, brand, price, discount, images, rating, stock, seller (merchant), category, specifications, variants, top reviews, coupon/campaign badges, and all other_offers (every merchant selling the same product).	Pricing teams call product/detail to get full Hepsiburada product details by `url` or HB code (`sku`).	url, sku, max_rotations
product/reviews	Paginated customer reviews for a product by `sku` or `url`. Walk every page with `page` to retrieve ALL reviews. Review authors are pre-masked by Hepsiburada (e.g. 'Ahmet K***') — no PII. ~10 reviews per page.	Marketplace operators call product/reviews to get paginated customer reviews for a product by `sku` or `url`.	sku, url, page, max_rotations
product/offers	Every merchant listing (buybox + other sellers) for a product by `sku` or `url`: compare price, seller rating, shipping and stock across all sellers of the same item.	Catalog enrichment teams call product/offers to get every merchant listing (buybox + other sellers) for a product by `sku` or `url`.	sku, url, max_rotations
search	Search Hepsiburada products by keyword with optional sort and price/brand filters — 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.	Retail analysts call search to search Hepsiburada products by keyword with optional sort and price/brand filters.	query, page, sort, price_min, price_max, ...
category	Browse a Hepsiburada category page by its path (`category` = '<slug>-c-<id>', e.g. 'laptop-notebook-dizustu-bilgisayarlar-c-98') with optional sort/price filters and pagination. Use it to list everything in a category, not just a keyword match.	Pricing teams call category to get browse a Hepsiburada category page by its path (`category` = '<slug>-c-<id>', e.g.	category, page, sort, price_min, price_max, ...
seller	Hepsiburada merchant (mağaza) profile + its product catalogue by store slug (`seller`, e.g. 'jollyshop') or full /magaza/<slug> URL. Returns seller info (name, rating, total product count) and a paginated list of the seller's products.	Marketplace operators call seller to get hepsiburada merchant (mağaza) profile + its product catalogue by store slug (`seller`, e.g.	seller, page, sort, price_min, price_max, ...

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/hepsiburada/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"laptop"}'

import requests

r = requests.post(
    "https://api.reefapi.com/hepsiburada/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "laptop"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/hepsiburada/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "laptop"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.hepsiburada.search with {"query":"laptop"}.

Use cases

Who uses this API and why

Pricing teams call search and product/offers to track Hepsiburada prices and seller competition.
Catalog-enrichment tools use product/detail to fill listings with images, specs and stock.
Review-analysis products pull product/reviews to monitor sentiment and ratings for a product.

FAQ

Questions developers ask before integrating

What is the Hepsiburada API?

Hepsiburada API is a ReefAPI endpoint group for turkish marketplace products, prices and reviews. It returns live JSON through POST requests under /hepsiburada/v1.

Is the Hepsiburada API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Hepsiburada calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Hepsiburada login or account?

No login to Hepsiburada is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Hepsiburada data?

The page example is captured from a live product/detail call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Hepsiburada API use?

Hepsiburada actions currently cost 1-2 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call Hepsiburada from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call hepsiburada actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Hepsiburada API a Hepsiburada scraper?

It is the managed alternative to a DIY Hepsiburada scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same turkish marketplace products, prices and reviews back as clean JSON.

Why does my Hepsiburada scraper keep getting blocked?

Most Hepsiburada scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / hepsiburada

Hepsiburada

Turkish marketplace products, prices and reviews.

base /hepsiburada/v16 endpoints

post/hepsiburada/v1/product/detail1 credit

Full Hepsiburada product details by `url` or HB code (`sku`): title, brand, price, discount, images, rating, stock, seller (merchant), category, specifications, variants, top reviews, coupon/campaign badges, and all other_offers (every merchant selling the same product).

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: IP-rotation attempts for difficult requests (1–14, default 8 — leave unchanged for typical use).

Try in playground →

post/hepsiburada/v1/product/reviews1 credit

Paginated customer reviews for a product by `sku` or `url`. Walk every page with `page` to retrieve ALL reviews. Review authors are pre-masked by Hepsiburada (e.g. 'Ahmet K***') — no PII. ~10 reviews per page.

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.
page = 1	optional	1–	Review page — 1-BASED (1, 2, 3…); empty page = past the last.
max_rotations = 8	optional	1–14	Advanced: IP-rotation attempts for difficult requests (1–14, default 8 — leave unchanged for typical use).

Try in playground →

post/hepsiburada/v1/product/offers1 credit

Every merchant listing (buybox + other sellers) for a product by `sku` or `url`: compare price, seller rating, shipping and stock across all sellers of the same item.

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: IP-rotation attempts for difficult requests (1–14, default 8 — leave unchanged for typical use).

Try in playground →

post/hepsiburada/v1/search2 credits

Search Hepsiburada products by keyword with optional sort and price/brand filters — 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.

Parameter		Allowed / range	Description
query	required	—	What to search for (Turkish keywords work best).
page = 1	optional	1–	Page number (1-BASED: 1, 2, 3…).
sort = default	optional	default · price_asc · price_desc · best_seller · most_reviewed · highest_rated · discount · newest	Result ordering. One of: default, price_asc, price_desc, best_seller, most_reviewed, highest_rated, discount, newest.
price_min	optional	0–	Minimum price filter in TRY (optional).
price_max	optional	0–	Maximum price filter in TRY (optional).
brand	optional	—	Brand filter — the brand slug, lowercase (e.g. 'asus', 'apple'). Optional.
max_rotations = 8	optional	1–14	Advanced: IP-rotation attempts for difficult requests (1–14, default 8 — leave unchanged for typical use).

Try in playground →

post/hepsiburada/v1/category1 credit

Browse a Hepsiburada category page by its path (`category` = '<slug>-c-<id>', e.g. 'laptop-notebook-dizustu-bilgisayarlar-c-98') with optional sort/price filters and pagination. Use it to list everything in a category, not just a keyword match.

Parameter		Allowed / range	Description
category	required	—	Category path '<slug>-c-<id>' or a full category URL. Take the …-c-<id> path from a product's breadcrumb / category link.
page = 1	optional	1–	Page number (1-BASED).
sort = default	optional	default · price_asc · price_desc · best_seller · most_reviewed · highest_rated · discount · newest	Result ordering. One of: default, price_asc, price_desc, best_seller, most_reviewed, highest_rated, discount, newest.
price_min	optional	0–	Minimum price filter in TRY (optional).
price_max	optional	0–	Maximum price filter in TRY (optional).
brand	optional	—	Brand filter — the brand slug, lowercase (e.g. 'asus', 'apple'). Optional.
max_rotations = 8	optional	1–14	Advanced: IP-rotation attempts for difficult requests (1–14, default 8 — leave unchanged for typical use).

Try in playground →

post/hepsiburada/v1/seller1 credit

Hepsiburada merchant (mağaza) profile + its product catalogue by store slug (`seller`, e.g. 'jollyshop') or full /magaza/<slug> URL. Returns seller info (name, rating, total product count) and a paginated list of the seller's products.

Parameter		Allowed / range	Description
seller	required	—	Store slug (the part after /magaza/, e.g. 'jollyshop') or a full https://www.hepsiburada.com/magaza/<slug> URL.
page = 1	optional	1–	Product page within the store (1-BASED).
sort = default	optional	default · price_asc · price_desc · best_seller · most_reviewed · highest_rated · discount · newest	Result ordering. One of: default, price_asc, price_desc, best_seller, most_reviewed, highest_rated, discount, newest.
price_min	optional	0–	Minimum price filter in TRY (optional).
price_max	optional	0–	Maximum price filter in TRY (optional).
max_rotations = 8	optional	1–14	Advanced: IP-rotation attempts for difficult requests (1–14, default 8 — leave unchanged for typical use).

Try in playground →

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
}