# Hepsiburada Scraper - Products, Prices, Sellers & Reviews (`topapi/hepsiburada-scraper`) Actor

Scrape Hepsiburada (Turkey) products from searches, categories, brands, seller stores, links or SKUs: price, 30-day lowest price, rating, seller, stock. Optional barcode, specs, all sellers' offers, reviews, Q\&A and seller profiles (MERSIS). Monitor mode. $0.67 per 1,000 products.

- **URL**: https://apify.com/topapi/hepsiburada-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** E-commerce, Lead generation, Marketing
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.67 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Hepsiburada Scraper do?

Hepsiburada Scraper reads products from **Hepsiburada**, Turkey's largest online marketplace: the same products Hepsiburada shows for a search, a category, a brand or a seller's store, one row per product, plus each product's own page, its customer reviews, its questions and answers, the sellers' profiles and Hepsiburada's delivery estimate when you ask for them.

- **Seven ways in** - search terms, Hepsiburada search links, category / brand / collection pages, a seller's store (`/magaza/<store>`: every product it sells), a seller's profile page, product links, and product ids (SKU `HBCV...` / `HBV...`, product id `HBC...`).
- **Hepsiburada's own filters and sort** - price range, minimum rating, brands, sellers, authorized / official sellers, fast delivery, coupon products, women entrepreneur products, products with photo reviews, advantage-price products, and its 8 sort orders, all applied by Hepsiburada, so a filter never reads pages it would throw away.
- **Past the 49-page limit** - Hepsiburada shows 49 pages (1,764 products) of any list. When a list holds more and you ask for more, the run splits Hepsiburada's own price filter and reads every part (2,500 laptops in one run).
- **Every price Hepsiburada shows** - price, list price and discount, the basket price ("Sepete özel") and the Premium price when the card has one, and **Hepsiburada's own lowest price of the last 10 and 30 days** on every row, with its "lowest price in 30 days" label.
- **Product details** - barcode(s), description, specifications, full category path, **every seller's offer** (price, seller rating, official seller label, city, free / fast shipping, shipment day), the featured seller's city and rating, the return policy, the rating breakdown per star, Hepsiburada's AI review summary, question count, every variant (size, colour) with its SKU, price and stock, videos.
- **Customer reviews** - stars, text, reviewer (masked as Hepsiburada shows it), verified purchase, date, likes, the seller bought from, the variant reviewed, photos; in 5 orders, and **only the star ratings you pick** (e.g. 1 and 2 stars for complaints).
- **Questions & answers** - every published question with each seller's answer.
- **Seller profiles** - store name, trade name, MERSIS number, tax number (when the seller publishes it), head-office place, rating and rating count, followers, product count, answer time, dispatch time, shipping city, time on Hepsiburada.
- **Delivery estimate** - the date Hepsiburada expects the order to be handed to the courier, its texts ("Yarın kargoda"), the order cut-off time, the courier and every delivery option.
- **Monitor mode** - a scheduled run delivers only new products, price or stock changes (with the previous values), new reviews and new questions, and flags products that disappeared. A run with nothing new costs nothing.
- **Pay per row** - **$0.67 per 1,000 products**, $0.81 per 1,000 product details, $0.54 per 1,000 reviews or questions, $1.30 per 1,000 seller profiles. No start fee.

### What data can I get?

#### Product rows (`type` = `product`)

| Field | What it is |
|---|---|
| `productId`, `sku`, `url` | Hepsiburada's product id (`HBC...`, shared by a product's variants), the variant's SKU (`HBCV...` / `HBV...`, the id in the product link), the product page |
| `title`, `brand`, `categoryId`, `categoryName`, `productType` | As Hepsiburada shows them ("Philips 3000 Serisi Airfryer Çift Hazneli ...", "Philips", "22017", "Fritözler") |
| `price`, `originalPrice`, `discountPercent`, `discountType`, `currency` | Price and list price in Turkish lira (TRY), the discount off the list price |
| `basketPrice`, `premiumPrice`, `campaignPriceLabel`, `campaignDiscountPercent` | The price in the basket ("Sepete özel", what every buyer pays at checkout) or for Premium members ("Premium ile"), when the card shows one |
| `lowestPrice10Days`, `lowestPrice30Days`, `isLowestPrice30Days` | Hepsiburada's own lowest price of this offer in the last 10 and 30 days, and its "30 günün en düşük fiyatı" label |
| `rating`, `reviewCount`, `topReview` | Average rating (0-5), review count, the review Hepsiburada features on the card |
| `seller`, `sellerId`, `listingId`, `isMultiSeller`, `buyboxOrder` | The featured seller (buy-box winner), its listing, whether other sellers offer the product |
| `inStock`, `isPreOrder`, `inStockDate`, `shipmentDay`, `jetDelivery`, `expressDelivery`, `warehouseId`, `warehouseCodes` | Stock, pre-order and its expected date, days until the seller ships (0 = today), jet / express delivery, warehouse and the other warehouses holding stock |
| `taxVatRate`, `installments`, `labels`, `isSponsored` | VAT rate, maximum card installments, the card's labels (campaign, coupon, installment, badge texts), sponsored card |
| `imageUrl`, `images`, `variantProperties`, `hasVariants`, `variantCount`, `colorVariantCount`, `variants` | Images (1,500 px), this variant's properties (`{"Renk": "Siyah"}`), the card's other variants with their SKU, price and stock |
| `searchQuery`, `source`, `sourceUrl`, `page`, `position`, `totalInSource`, `scrapedAt` | Where the row came from, its Hepsiburada page and position, the count Hepsiburada reports for the source, when it was read |

With **Product details** on, and always for product links and ids (`detailsScraped` = true):

| Field | What it is |
|---|---|
| `barcode`, `barcodes`, `brandId`, `stockQuantity` | Barcode (EAN / GTIN), every barcode Hepsiburada holds for the product, brand slug, the quantity Hepsiburada shows as available |
| `description`, `specifications` | Description as text; specifications `{name: value}` ("Güç (W)": "2750 W") |
| `categoryPath`, `categories` | Full path ("Beyaz Eşya Mutfak Ürünleri > Elektrikli Mutfak Aletleri > Airfryer & Fritözler > ...") and the breadcrumb with ids and links |
| `offers`, `offerCount`, `lowestOfferPrice`, `priceRangeText` | Every seller's offer: seller, id, store link, price, list price, discount, 10 / 30-day low, seller rating and count, seller labels ("Resmi Satıcı") and official flag, city, free / fast shipping, shipment day, fulfilled by Hepsiburada, women entrepreneur, buy-box order, in stock |
| `sellerUrl`, `sellerCity`, `sellerCountry`, `sellerRating`, `sellerRatingCount`, `sellerIsOfficial` | The featured seller's store link, city, country, rating (0-10), official / authorized seller label |
| `cutOffHour`, `freeShipping`, `fastShipping` | Order cut-off hour for same-day shipping, free / fast shipping |
| `ratingBreakdown`, `reviewSummary`, `questionCount` | Reviews per star, Hepsiburada's AI summary of the reviews, published questions |
| `variantOptions` | Every variant on the product page: SKU, title, price, stock, properties (`{"Beden": "L", "Renk": "Bordo"}`), link, image |
| `isReturnable`, `returnPolicy` | Returnable flag and the return policy text Hepsiburada shows for the product |
| `videos`, `badges`, `tags`, `isProductLive`, `isBundle` | Product videos, badges, Hepsiburada's campaign / collection tags, live and bundle flags |

With **Delivery estimate** on: `deliveryDate` (the date Hepsiburada expects the order to be handed to the courier, its "kargoda" date), `deliveryText`, `deliveryCheckoutText`, `basketDeliveryText` ("Yarın kargoda"), `deliveryDays`, `deliveryCutOffTime` ("12:00"), `deliveryType`, `cargoFirmId`, `isNextDayDelivery`, `deliveryOptions`.

#### Review rows (`type` = `review`)

`reviewId`, `productId`, `sku`, `productTitle`, `productUrl`, `rating` (1-5), `text`, `author` (masked as Hepsiburada shows it: "E\*\*\*"), `isPurchaseVerified`, `isInfluencer`, `createdAt`, `updatedAt`, `likes`, `dislikes`, `sellerName` and `sellerId` (the seller the reviewer bought from), `reviewedSku` and `reviewedTitle` (the variant reviewed), `images` (the reviewer's photos), `productRating`, `productReviewCount`, `reviewSort`, `position`, `source`.

#### Question rows (`type` = `question`)

`questionId`, `productId`, `sku`, `productTitle`, `productUrl`, `question`, `createdAt`, `lastAnsweredAt`, `answerCount`, `answers` (each: `answer`, `seller`, `sellerId`, `askedAt`, `answeredAt`, `likes`, `dislikes`), `score`, `helpfulScore`, `questionSku`, `productQuestionCount`.

#### Seller rows (`type` = `seller`)

`sellerId`, `sellerSlug`, `sellerUrl`, `name`, `legalName`, `mersisNumber`, `taxNumber`, `address`, `rating` (0-10), `ratingCount`, `followers`, `productCount`, `responseTime`, `shippingCity`, `averageDispatchTime`, `timeOnHepsiburada`, `isWomenEntrepreneur`, `logoUrl`.

#### Example product row (search "airfryer", details and delivery on; a real row from run tMZdkddJIso44glfE, lists and long texts shortened)

```json
{
  "type": "product",
  "productId": "HBC000062ZPFZ",
  "sku": "HBCV000062ZPG0",
  "url": "https://www.hepsiburada.com/3000-serisi-airfryer-cift-hazneli-rapid-air-plus-teknolojisi-8-ayarli-dijital-ekran-homeid-uygulamasi-na350-00-pm-HBC000062ZPFZ",
  "title": "Philips 3000 Serisi Airfryer Çift Hazneli, Rapid Air Plus Teknolojisi, 8 Ayarlı Dijital Ekran, HomeID Uygulaması, NA350/00",
  "brand": "Philips",
  "price": 9814.1,
  "originalPrice": 9814.1,
  "discountPercent": 0,
  "discountType": "NoDiscount",
  "currency": "TRY",
  "lowestPrice10Days": 9826.05,
  "lowestPrice30Days": 9826.05,
  "isLowestPrice30Days": true,
  "rating": 4.7,
  "reviewCount": 729,
  "seller": "BORTAS TEKNOJİ",
  "sellerId": "d2d6083d-f093-48a2-8046-dd6beed77442",
  "listingId": "2c820b8c-6756-4efd-87a2-7aedbb66fb4d",
  "isMultiSeller": true,
  "buyboxOrder": 1,
  "inStock": true,
  "isPreOrder": false,
  "shipmentDay": 0,
  "jetDelivery": false,
  "expressDelivery": false,
  "deliveryDate": "2026-11-16",
  "deliveryText": "Tahmini 16 Kasım Pazartesi günü kargoda",
  "deliveryCheckoutText": "Tahmini 16 Kasım Pazartesi Günü Kargoda",
  "basketDeliveryText": "Yarın kargoda",
  "deliveryDays": 0,
  "deliveryCutOffTime": "12:00",
  "deliveryType": "StandardDelivery",
  "cargoFirmId": "2",
  "isNextDayDelivery": false,
  "deliveryOptions": [
    {
      "name": "Yarın kargoda",
      "type": "StandardDelivery",
      "text": "Tahmini 16 Kasım Pazartesi günü kargoda",
      "cargoFirmId": "2"
    }
  ],
  "warehouseId": "BIRINCIL",
  "warehouseCodes": [],
  "taxVatRate": 20,
  "installments": 9,
  "labels": [
    {
      "type": "campaign",
      "text": "30 günün en düşük fiyatı",
      "tag": "lowestPrice"
    }
  ],
  "isSponsored": false,
  "categoryId": "22017",
  "categoryName": "Fritözler",
  "productType": "Fritözler",
  "imageUrl": "https://productimages.hepsiburada.net/s/777/1500/110000678594910.jpg",
  "images": [
    "https://productimages.hepsiburada.net/s/777/1500/110000678594910.jpg",
    "https://productimages.hepsiburada.net/s/777/1500/110000678594915.jpg",
    "https://productimages.hepsiburada.net/s/777/1500/110000678594911.jpg"
  ],
  "variantProperties": {
    "Renk": "Siyah"
  },
  "hasVariants": false,
  "variantCount": 1,
  "colorVariantCount": 0,
  "topReview": "Önceden daha küçük farklı bir marka airfryer kullanırken neden bu modeli aldım onu anlatacağım. Üç kişilik bir aileyiz ve kızımda besin alerjisi var. Ama biz...",
  "isAdult": false,
  "detailsScraped": true,
  "barcode": "8720389033025",
  "barcodes": [
    "8720389033025",
    "XCZO1-55429325",
    "0688001000512"
  ],
  "brandId": "philips",
  "stockQuantity": 1,
  "description": "Philips 3000 Serisi Airfryer Çift Hazneli, Rapid Air Plus Teknolojisi, 8 Ayarlı Dijital Ekran, HomeID Uygulaması, NA350/00\nPhilips NA350/00, yemek pişirme sü...",
  "specifications": {
    "Kapasite": "6 lt ve Üzeri",
    "Güç (W)": "2750 W",
    "Çıkarılabilir Hazne": "Var",
    "Hazne Sayısı": "Çift"
  },
  "categoryPath": "Beyaz Eşya Mutfak Ürünleri > Elektrikli Mutfak Aletleri > Airfryer & Fritözler > Philips Airfryer & Fritözler",
  "categories": [
    {
      "id": "2147483637",
      "name": "Beyaz Eşya Mutfak Ürünleri",
      "url": "https://www.hepsiburada.com/beyaz-esya-mutfak-urunleri-c-2147483637"
    },
    {
      "id": "22001",
      "name": "Elektrikli Mutfak Aletleri",
      "url": "https://www.hepsiburada.com/elektrikli-mutfak-aletleri-c-22001"
    }
  ],
  "offers": [
    {
      "seller": "BORTAS TEKNOJİ",
      "sellerId": "d2d6083d-f093-48a2-8046-dd6beed77442",
      "sellerUrl": "https://www.hepsiburada.com/magaza/bortas-teknoloji",
      "listingId": "2c820b8c-6756-4efd-87a2-7aedbb66fb4d",
      "price": 9814.1,
      "originalPrice": null,
      "discountPercent": 0,
      "lowestPrice10Days": 9826.05,
      "lowestPrice30Days": 9826.05,
      "sellerRating": 9.7,
      "sellerRatingCount": 1,
      "sellerCity": "SİVAS",
      "freeShipping": false,
      "fastShipping": false,
      "shipmentDay": 0,
      "fulfilledByHepsiburada": false,
      "womenEntrepreneur": false,
      "buyboxOrder": 1,
      "inStock": true,
      "sellerLabels": [],
      "isOfficialSeller": false
    },
    {
      "seller": "EMC&BİLİSİM&TEKN",
      "sellerId": "ed81e61b-1bdc-4f7d-8bdf-73ecae0f7334",
      "sellerUrl": "https://www.hepsiburada.com/magaza/emc-bilisim-tekn",
      "listingId": "f3433a6b-85ad-49e7-95b9-8e5319a93439",
      "price": 9826.9,
      "originalPrice": null,
      "discountPercent": 0,
      "lowestPrice10Days": 5508.9,
      "lowestPrice30Days": 5508.9,
      "sellerRating": 9.4,
      "sellerRatingCount": 49,
      "sellerCity": "İZMİR",
      "freeShipping": false,
      "fastShipping": false,
      "shipmentDay": 0,
      "fulfilledByHepsiburada": false,
      "womenEntrepreneur": false,
      "buyboxOrder": 2,
      "inStock": true,
      "sellerLabels": [],
      "isOfficialSeller": false
    }
  ],
  "offerCount": 11,
  "lowestOfferPrice": 9814.1,
  "priceRangeText": "9.826,90 - 16.043,92 TL",
  "sellerUrl": "https://www.hepsiburada.com/magaza/bortas-teknoloji",
  "sellerCity": "SİVAS",
  "sellerCountry": "TÜRKİYE",
  "sellerRating": 9.7,
  "sellerRatingCount": 1,
  "sellerIsOfficial": false,
  "cutOffHour": 12,
  "freeShipping": false,
  "fastShipping": false,
  "ratingBreakdown": {
    "1": 34,
    "2": 5,
    "3": 11,
    "4": 54,
    "5": 625
  },
  "reviewSummary": "Philips NA350/00 3000 Serisi Çift Hazneli Airfryer, kullanışlılığı ve çift haznesi sayesinde aynı anda iki farklı yemek pişirme imkanı sunarak kullanıcıları ...",
  "questionCount": 119,
  "videos": [
    "https://productvideos.hepsiburada.net/catalog-video-1/6656c8aaf7eff40015b5f437.mp4"
  ],
  "badges": [
    "Ürün güvenliği bilgileri"
  ],
  "tags": [
    "22017-best-seller-5",
    "br-all-products",
    "buyuk-yaz-indirimi-cok-satanlar"
  ],
  "isProductLive": true,
  "isBundle": false,
  "isReturnable": true,
  "returnPolicy": "Kolay iade süreci nasıl başlatılır? İade talebi oluştur Siparişlerim sayfasından iade etmek istediğin ürünü bul ve İade ve diğer talepler 'e tıkla. Kolay İad...",
  "searchQuery": "airfryer",
  "source": "airfryer",
  "page": 1,
  "position": 1,
  "totalInSource": 5652,
  "scrapedAt": "2026-11-14T22:16:50.125Z"
}
```

#### Example review row (a real row, same run)

```json
{
  "type": "review",
  "reviewId": "281c7c83-8c12-4627-bc35-e9244adc0851",
  "productId": "HBC000062ZPFZ",
  "sku": "HBCV000062ZPG0",
  "productTitle": "Philips 3000 Serisi Airfryer Çift Hazneli, Rapid Air Plus Teknolojisi, 8 Ayarlı Dijital Ekran, HomeID Uygulaması, NA350/00",
  "productUrl": "https://www.hepsiburada.com/3000-serisi-airfryer-cift-hazneli-rapid-air-plus-teknolojisi-8-ayarli-dijital-ekran-homeid-uygulamasi-na350-00-pm-HBC000062ZPFZ",
  "rating": 4,
  "text": "Daha tam denemedik, sabah buzluktan simit kızarttık. 6-7 dakika sonra çok güzel oldu. Herşey iyi görünüyor ama iç haznelerini elle çıkartmak gerekiyor. Zor olacağını düşünüyorum. Öbür modellerde tu...",
  "author": "ç*************",
  "isPurchaseVerified": true,
  "isInfluencer": false,
  "createdAt": "2025-08-11T11:40:01.5311292+00:00",
  "updatedAt": "2025-08-12T16:48:23.9629762Z",
  "likes": 14,
  "sellerName": "Hepsiburada",
  "sellerId": "e750130c-d0ff-469f-8767-66a63af8ea0c",
  "reviewedSku": "HBCV000062ZPG0",
  "reviewedTitle": "Philips NA350/00 3000 Serisi Airfryer Çift Hazneli, Rapid Air Plus Teknolojisi, 8 Ayarlı Dijital Ekran, HomeID Uygulaması,",
  "images": [
    "https://images.hepsiburada.net/usercontents/s/0/1500/0022b6ac-a741-4ca5-8af2-0c2798d832f3.jpg"
  ],
  "productRating": 4.7,
  "productReviewCount": 729,
  "reviewSort": "most_helpful",
  "position": 2,
  "source": "Philips 3000 Serisi Airfryer Çift Hazneli, Rapid Air Plus Teknolojisi, 8 Ayarlı Dijital Ekran, HomeID Uygulaması, NA350/00 (reviews)",
  "scrapedAt": "2026-11-14T22:16:50.125Z"
}
```

#### Example question row (a real row, same run)

```json
{
  "type": "question",
  "questionId": "6689fa62-3df0-4448-b2e7-90190172d11d",
  "productId": "HBC000062ZPFZ",
  "sku": "HBCV000062ZPG0",
  "productTitle": "Philips 3000 Serisi Airfryer Çift Hazneli, Rapid Air Plus Teknolojisi, 8 Ayarlı Dijital Ekran, HomeID Uygulaması, NA350/00",
  "productUrl": "https://www.hepsiburada.com/3000-serisi-airfryer-cift-hazneli-rapid-air-plus-teknolojisi-8-ayarli-dijital-ekran-homeid-uygulamasi-na350-00-pm-HBC000062ZPFZ",
  "question": "kahvaltı seti ve ızgara seti ürünle birlikte geliyormu",
  "createdAt": "2026-11-14T03:08:38.6267298+00:00",
  "lastAnsweredAt": "2026-11-13T11:11:14.234Z",
  "answerCount": 1,
  "answers": [
    {
      "answer": "sadece fritöz efendim",
      "seller": "BORTAS TEKNOJİ",
      "sellerId": "d2d6083d-f093-48a2-8046-dd6beed77442",
      "askedAt": "2026-11-13T10:50:49.786Z",
      "answeredAt": "2026-11-13T11:11:14.234Z",
      "likes": 0,
      "dislikes": 0
    }
  ],
  "score": 15,
  "helpfulScore": 0,
  "questionSku": "HBCV000062ZPG0",
  "productQuestionCount": 119,
  "position": 1,
  "source": "Philips 3000 Serisi Airfryer Çift Hazneli, Rapid Air Plus Teknolojisi, 8 Ayarlı Dijital Ekran, HomeID Uygulaması, NA350/00 (questions)",
  "scrapedAt": "2026-11-14T22:16:50.125Z"
}
```

#### Example seller row (a real row, same run)

```json
{
  "type": "seller",
  "sellerId": "3cf31523-a144-4aa9-bcc6-a6b212115f0d",
  "sellerSlug": "sharkninja-turkiye",
  "sellerUrl": "https://www.hepsiburada.com/magaza/sharkninja-turkiye",
  "name": "SharkNinja Türkiye",
  "legalName": "EVTEK KÜÇÜK EV ALETLERİ SANAYİ VE TİCARET ANONİM ŞİRKETİ",
  "taxNumber": "3830958203",
  "mersisNumber": "0383095820300001",
  "address": "İstanbul",
  "rating": 9.4,
  "ratingCount": 55,
  "followers": 16032,
  "productCount": 42,
  "responseTime": "0-12 saat",
  "shippingCity": "İSTANBUL",
  "averageDispatchTime": "2 gün",
  "timeOnHepsiburada": "1 yıl",
  "isWomenEntrepreneur": false,
  "logoUrl": "https://images.hepsiburada.net/assets/marketplace/3cf31523-a144-4aa9-bcc6-a6b212115f0d-76177.png",
  "source": "SharkNinja Türkiye (seller)",
  "scrapedAt": "2026-11-14T22:16:50.125Z"
}
```

#### How full are the fields? (measured on real runs, 2026-11-14)

- **Product rows** (1,350 rows: airfryer, iphone 15, bebek bezi, laptop, kulaklık): productId, sku, url, title, price, originalPrice, discount, lowestPrice10Days, lowestPrice30Days, rating, reviewCount, seller, sellerId, listingId, inStock, shipmentDay, categoryId / categoryName / productType, imageUrl and images 100%; labels 89%; brand 79% (Hepsiburada's laptop and phone cards often carry none; details add it); basketPrice 58%; campaign label 69%; premiumPrice 11%; variantProperties 54%; variants 15% (cards that bundle several variants); warehouseCodes 7%; inStockDate on pre-orders only.
- **Product details** (231 rows: robot süpürge, airfryer): barcode(s), brandId, stockQuantity, specifications, categoryPath, offers (every seller), sellerCity, sellerRating, sellerIsOfficial, cutOffHour, free / fast shipping, tags, isReturnable and returnPolicy 100%; description 98%; ratingBreakdown 69% and questionCount 68% (products with reviews / questions); reviewSummary 55% (Hepsiburada writes one for products with enough reviews); priceRangeText 52% (multi-seller products); variantOptions 48%; badges 39%; videos 25%.
- **Delivery estimate** (230 rows): every delivery field 100%.
- **Reviews** (1,551 rows): rating, author, verified purchase, date, seller bought from, variant reviewed 100%; text 66% (star-only reviews have none; 94% on most-helpful order, 50% on the newest order); photos 19%; likes 16%.
- **Questions** (280 rows): every field 100%.
- **Seller profiles** (44 rows): name, trade name, address, followers, product count, answer / dispatch times, shipping city, time on Hepsiburada 100%; rating 95%; logo 91%; MERSIS number 84%; tax number 75% (what each seller publishes).

### How to use it

1. Add search terms, Hepsiburada links or product ids.
2. Set the filters and sort you want, and the most products to read.
3. Turn on the add-ons you need: Product details, Delivery estimate, Customer reviews, Questions & answers, Seller profiles.
4. Run. Download the rows as JSON, CSV, Excel or through the API; the dataset has views for products, details, prices and sellers, delivery, reviews, questions, seller profiles and monitor changes.

#### Input example

```json
{
  "searchQueries": ["airfryer", "robot süpürge"],
  "startUrls": ["https://www.hepsiburada.com/fritozler-c-22017", "https://www.hepsiburada.com/magaza/sharkninja-turkiye"],
  "productIds": ["HBCV000062ZPG0"],
  "sort": "best_selling",
  "minPrice": 1000,
  "maxPrice": 20000,
  "minRating": "4",
  "brands": ["Philips", "Xiaomi"],
  "maxItems": 200,
  "includeDetails": true,
  "includeDelivery": true,
  "includeReviews": true,
  "maxReviewsPerProduct": 20,
  "reviewSort": "newest",
  "reviewStars": ["1", "2"],
  "includeQuestions": true,
  "includeSellerProfiles": true
}
```

#### Inputs

| Input | What it does |
|---|---|
| `searchQueries` | Search terms, one Hepsiburada search each (Turkish or English) |
| `startUrls` | Hepsiburada search, category, brand, collection, seller store, seller profile and product links; filters and sort already in a link are kept |
| `productIds` | SKUs (`HBCV...`, `HBV...`) or product ids (`HBC...`, `HB0...`); each is read from its product page with details |
| `maxItems` | Most product rows for the run (default 100; 0 = every product) |
| `maxItemsPerSource` | Most products from one search or link |
| `sort` | `relevance`, `price_asc`, `price_desc`, `best_selling`, `most_reviewed`, `top_rated`, `biggest_discount`, `newest` (Hepsiburada's own) |
| `minPrice`, `maxPrice`, `minRating` | Hepsiburada's price (TL) and rating filters |
| `brands`, `sellerNames` | Hepsiburada's brand and seller filters (names as Hepsiburada shows them) |
| `officialSellersOnly`, `fastDeliveryOnly`, `couponProductsOnly`, `womenEntrepreneurOnly`, `withPhotoReviewsOnly`, `advantageProductsOnly` | Hepsiburada's own filters |
| `onlyDiscounted`, `minDiscountPercent`, `minReviews`, `inStockOnly`, `skipSponsored`, `maxShipmentDays` | Checked on each product (Hepsiburada has no such filter); basket discounts count as discounts |
| `includeDetails` | Read each delivered product's page (details fields above) |
| `includeDelivery` | Add Hepsiburada's delivery estimate (one request per 50 products, no extra charge) |
| `includeReviews`, `maxReviewsPerProduct`, `reviewSort`, `reviewStars`, `reviewsWithMediaOnly` | Reviews per product (default 20; 0 = all), in `most_helpful`, `newest`, `oldest`, `highest_rating` or `lowest_rating` order, only some star ratings, only reviews with photos or video |
| `includeQuestions`, `maxQuestionsPerProduct`, `questionSort` | Questions per product (default 20; 0 = all), newest answered or most helpful first |
| `includeSellerProfiles` | One seller row per seller of the delivered products |
| `monitorMode`, `monitorKey`, `trackPriceChanges`, `minPriceChangePercent`, `priceDropsOnly`, `reportRemoved`, `resetMonitor` | See Monitor mode |
| `maxConcurrency` | Requests in flight at once (default 4 at 256 MB) |
| `proxyConfiguration` | Optional; by default the run reads Hepsiburada directly |

The names other Hepsiburada actors use are accepted too (`queries`, `keywords`, `limit`, `maxResults`, `maxProducts`, `min_price`, `max_price`, `min_rating`, `sort_by`, `sortBy`, `enrich_data`, `includeProductDetails`, `get_reviews`, `max_reviews`, `review_sort`, `get_qna`, `max_qna`, `fast_delivery`, `official_distibutor`, `women_entrepreneur_products`, `sellers`, `includeDeliveryInfo`, `changesOnly`, `monitorScope`, ...).

### Monitor mode

Turn on `monitorMode` and schedule the run. Each run remembers what it delivered (per input, or per `monitorKey`) and delivers only:

- products not delivered before (`changeType` = `new`);
- products whose price or stock changed (`changeType` = `changed`, with `previousPrice`, `priceChange`, `priceChangePercent`, `previousInStock`), with `trackPriceChanges` on; `minPriceChangePercent` ignores small moves, `priceDropsOnly` keeps only price drops;
- products delivered earlier without details, once, when a later run asks for details (`changeType` = `details`);
- reviews and questions newer than the last ones delivered, and sellers not delivered before;
- with `reportRemoved` on (default), a free row (`type` = `removed`, `billed` = false, never charged) for a watched product whose page is gone or that is missing from a fully read list two runs in a row, with its last price.

In monitor mode `maxItems` / `maxItemsPerSource` count the products **watched** (the first N of each list): a poll reads the same N products every time and delivers only what is new or changed among them. Unchanged rows are not delivered and not charged; a run that finds nothing new costs nothing. `resetMonitor` starts the memory over.

### How much does it cost?

Pay per row, no start fee:

| Event | Price | When |
|---|---|---|
| `product` | $0.67 per 1,000 | one product row |
| `product-details` | $0.81 per 1,000 | a product row that carries its product page's details (product links and ids always do) |
| `review` | $0.54 per 1,000 | one review row |
| `question` | $0.54 per 1,000 | one question row (with all its answers) |
| `seller` | $1.30 per 1,000 | one seller profile row |

A product with details costs $1.48 per 1,000. The delivery estimate is free. Duplicates, rows a monitor run already delivered, removed-product rows and products that are not on Hepsiburada are never charged. Set a maximum charge on the run and it stops cleanly at it.

### Speed

Measured on the platform at 256 MB (the actor's memory), final build: 50 products in 5-12 s, 150 products in 5 s, 1,000 products in 80-83 s, 2,500 products (price split) in 6-7 minutes, 200 products with details in 4.5-5.5 minutes (~1.3 s a product; at 512 MB, the maximum, about twice as fast at the same cost), 1,000 reviews of one product in 7 s, 30 products with every add-on (885 rows) in 1.5-2 minutes, 200 products with the delivery estimate in 9 s, one product in 2.5-3 s.

### Limits

- Hepsiburada shows 49 pages (1,764 products) of any list; past that the run splits Hepsiburada's price filter. A single price with more than 1,764 products gives its first 49 pages.
- `totalInSource` is the count Hepsiburada reports; it moves by a few products between pages.
- Prices, campaign prices and delivery estimates are what Hepsiburada shows a signed-out visitor with no delivery address.
- A product Hepsiburada no longer sells sends its link to a category page: it is reported as not on sale, not charged.
- Filters Hepsiburada does not apply itself (discounted only, minimum discount, minimum reviews, in stock, shipment days, sponsored) are checked on each product; a list is read further only while the products it keeps pay for the pages read. Hepsiburada's own filters and sorts (e.g. Biggest discount) narrow the list first.
- Not delivered: review feature ratings, review keywords and review videos, and the seller's registered e-mail - Hepsiburada's data returns them empty (0 of 268 reviews and 0 of 33 seller profiles read while building).
- Hepsiburada answers fast bursts from one address with a block for several minutes; the run paces its requests (3 a second) and moves to Apify proxies by itself if it is refused.

### FAQ

**Do I need a Hepsiburada account or a proxy?** No. The run reads the pages any visitor sees, directly; a proxy is optional.

**What is the difference between `price`, `basketPrice` and `lowestPrice30Days`?** `price` is the price on the card; `basketPrice` is the lower price Hepsiburada applies in the basket ("Sepete özel") when the card shows one; `lowestPrice30Days` is Hepsiburada's own lowest price of that offer over the last 30 days.

**Can I track prices every day?** Yes: monitor mode on a schedule delivers only new products and price or stock changes, with the previous price, and flags products that disappeared.

**Where is the SKU?** At the end of every product link (`...-p-HBCV000062ZPG0`). Paste SKUs or product ids into Product ids.

**Can I get every product of one seller?** Yes: paste the seller's store link (`https://www.hepsiburada.com/magaza/<store>`); add its profile link (`...?tab=profile`) for the seller row.

# Actor input Schema

## `searchQueries` (type: `array`):

Words to search on Hepsiburada, one search each, in Turkish or English (e.g. airfryer, iphone 15, bebek bezi). Every search is read in Hepsiburada's own order, page after page.

## `startUrls` (type: `array`):

Any hepsiburada.com link: a search (https://www.hepsiburada.com/ara?q=...), a category (...-c-22017), a brand or collection page (...-xc-22017-b8058, ...-x-s63353), a seller store (https://www.hepsiburada.com/magaza/<store>: all its products), a seller profile (.../magaza/<store>?tab=profile: one seller row) or a product page (...-p-HBCV... or ...-pm-HBC...). Filters and sort already in a link are kept.

## `productIds` (type: `array`):

Hepsiburada SKUs (HBCV..., the id at the end of a product link) or product ids (HBC...). Each one is read from its product page and delivered with its details.

## `maxItems` (type: `integer`):

Stop after this many product rows across all searches and links (reviews, questions and seller rows are not counted here). 0 = no limit. Hepsiburada shows 49 pages (1,764 products) of one listing; above that the run reads further by splitting Hepsiburada's own price filter.

## `maxItemsPerSource` (type: `integer`):

Stop each search or link after this many products. 0 or empty = no limit per source.

## `sort` (type: `string`):

Hepsiburada's own sort for searches and listing pages. A limit keeps the first products in this order.

## `minPrice` (type: `integer`):

Only products at this price or more (Hepsiburada's own price filter).

## `maxPrice` (type: `integer`):

Only products at this price or less (Hepsiburada's own price filter).

## `minRating` (type: `string`):

Only products rated at least this many stars.

## `brands` (type: `array`):

Only these brands (e.g. Philips, Xiaomi). Several brands are combined: a product of any of them matches.

## `sellerNames` (type: `array`):

Only products sold by these stores, written as Hepsiburada shows the store name (e.g. Hepsiburada, Teknosa). For every product of one store, give its store link under Hepsiburada links instead.

## `officialSellersOnly` (type: `boolean`):

Only products sold by authorized dealers or official brand stores (Yetkili / Resmi Satıcılar).

## `fastDeliveryOnly` (type: `boolean`):

Only products with Hepsiburada's fast delivery (Hızlı Teslimat).

## `couponProductsOnly` (type: `boolean`):

Only products that carry a coupon (Kuponlu Ürünler).

## `womenEntrepreneurOnly` (type: `boolean`):

Only products from Hepsiburada's women entrepreneur program (Girişimci Kadınlar).

## `withPhotoReviewsOnly` (type: `boolean`):

Only products with at least one customer review with a photo.

## `advantageProductsOnly` (type: `boolean`):

Only products in Hepsiburada's advantage-price selection (Avantajlı Ürünler).

## `onlyDiscounted` (type: `boolean`):

Keep only products priced below their list price. Combine with the Biggest discount sort to read the deepest discounts first.

## `minDiscountPercent` (type: `integer`):

Keep only products discounted by at least this percentage.

## `minReviews` (type: `integer`):

Keep only products with at least this many customer reviews.

## `inStockOnly` (type: `boolean`):

Leave out products that cannot be added to the basket.

## `skipSponsored` (type: `boolean`):

Leave out sponsored (ad) cards.

## `maxShipmentDays` (type: `integer`):

Keep only products the seller ships within this many days (0 = same day).

## `includeDetails` (type: `boolean`):

Open each product's page: barcode(s), description, specifications, full category path, every seller's offer (price, seller rating, city, shipping), the featured seller's city and rating, the rating breakdown per star, Hepsiburada's AI review summary, question count, videos. Charged per product with details (product links and ids always carry them).

## `includeDelivery` (type: `boolean`):

Add Hepsiburada's own delivery estimate to each product: the date it expects the order to be handed to the courier, the estimate texts, the order cut-off time, the courier, next-day delivery and every delivery option (one extra request per 50 products, no extra charge).

## `includeReviews` (type: `boolean`):

Deliver each product's customer reviews as review rows (text, stars, reviewer, verified purchase, date, likes, seller bought from, photos). Charged per review.

## `maxReviewsPerProduct` (type: `integer`):

Reviews per product. 0 = all of them.

## `reviewSort` (type: `string`):

Order the reviews are read in (the limit keeps the first ones).

## `reviewStars` (type: `array`):

Only reviews with these star ratings (e.g. 1 and 2 for complaints). Empty = every rating.

## `reviewsWithMediaOnly` (type: `boolean`):

Only reviews the reviewer added photos or a video to.

## `includeQuestions` (type: `boolean`):

Deliver each product's published customer questions with the sellers' answers as question rows. Charged per question.

## `maxQuestionsPerProduct` (type: `integer`):

Questions per product. 0 = all of them.

## `questionSort` (type: `string`):

Newest answered first (the product page's own order; monitor mode reads only questions answered since the last run) or Hepsiburada's most helpful first.

## `includeSellerProfiles` (type: `boolean`):

Deliver one seller row for each seller of the delivered products: store name, trade name, MERSIS number, tax number (when published), head-office place, rating, followers, product count, answer and dispatch times, time on Hepsiburada. Charged per seller.

## `monitorMode` (type: `boolean`):

Deliver only products not delivered by an earlier run with the same input, products whose price or stock changed (changeType changed, with the previous price) and new reviews / questions / sellers. The limits then count the products watched (the first N of each listing): a poll with nothing new delivers and charges nothing.

## `monitorKey` (type: `string`):

Runs with the same name and the same input share one memory. Use a different name for each watch.

## `trackPriceChanges` (type: `boolean`):

In monitor mode, deliver a known product again when its price or stock changed. Off = new products only.

## `minPriceChangePercent` (type: `integer`):

In monitor mode, ignore price moves smaller than this percentage.

## `priceDropsOnly` (type: `boolean`):

In monitor mode, deliver a known product again only when its price went down (rises and stock changes are not delivered).

## `reportRemoved` (type: `boolean`):

In monitor mode, add a free row (type removed, billed false) for a watched product whose page is gone or that is missing from a fully read listing two runs in a row.

## `resetMonitor` (type: `boolean`):

Forget what earlier runs delivered (the next run delivers everything again).

## `proxyConfiguration` (type: `object`):

Optional. The run connects directly and moves to Apify datacenter, then Turkish residential proxies by itself if Hepsiburada refuses a connection. Set your own proxy here only if you need to.

## `maxConcurrency` (type: `integer`):

Requests in flight at once (default 4 at 256 MB, 6 at 512 MB).

## Actor input object example

```json
{
  "searchQueries": [
    "airfryer"
  ],
  "maxItems": 50,
  "sort": "relevance",
  "officialSellersOnly": false,
  "fastDeliveryOnly": false,
  "couponProductsOnly": false,
  "womenEntrepreneurOnly": false,
  "withPhotoReviewsOnly": false,
  "advantageProductsOnly": false,
  "onlyDiscounted": false,
  "inStockOnly": false,
  "skipSponsored": false,
  "includeDetails": false,
  "includeDelivery": false,
  "includeReviews": false,
  "maxReviewsPerProduct": 20,
  "reviewSort": "most_helpful",
  "reviewsWithMediaOnly": false,
  "includeQuestions": false,
  "maxQuestionsPerProduct": 20,
  "questionSort": "newest",
  "includeSellerProfiles": false,
  "monitorMode": false,
  "trackPriceChanges": true,
  "minPriceChangePercent": 0,
  "priceDropsOnly": false,
  "reportRemoved": true,
  "resetMonitor": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `products` (type: `string`):

No description

## `details` (type: `string`):

No description

## `reviews` (type: `string`):

No description

## `questions` (type: `string`):

No description

## `sellers` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "airfryer"
    ],
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/hepsiburada-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["airfryer"],
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/hepsiburada-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "airfryer"
  ],
  "maxItems": 50
}' |
apify call topapi/hepsiburada-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/hepsiburada-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/j2iHwGlp3KqTGD44d/builds/Dzu9VCqvDJ0ypIapi/openapi.json
