# Hepsiburada Scraper: Ürün Fiyat Takibi, İndirim & Satıcı Verisi (`getascraper/hepsiburada-products-scraper`) Actor

Hepsiburada ürün scraper: collect products by keyword, brand, seller or pasted link with price, list price, discount, rating, seller and delivery. Deal finder, price-drop and new-product monitor, results beyond the 1,760 search cap, optional barcode, specs and all seller offers. JSON, CSV, Excel.

- **URL**: https://apify.com/getascraper/hepsiburada-products-scraper.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.65 / 1,000 product records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## 🛒 Hepsiburada Scraper: Ürün Fiyat Takibi, İndirim & Satıcı Verisi

<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0;margin-bottom:0">
<tr>
<td style="padding:24px 28px;background:#FFF3EB;border:1px solid #FFD7BD;border-top:4px solid #E65100;color:#1C1917;border-radius:10px 10px 0 0">
<span style="font-size:23px;font-weight:800;color:#1C1917;line-height:1.3">Every Hepsiburada price, discount and seller, filtered the way you buy or sell</span><br>
<span style="font-size:15px;color:#57534E;line-height:1.6">Search by keyword or paste any Hepsiburada page. Get list price, discount, rating, seller and delivery in a clean table, or only the products that are new or cheaper since your last run.</span>
</td>
</tr>
</table>
<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0;margin-top:0">
<tr>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #FFD7BD;vertical-align:top;border-top:none;color:#1C1917;border-radius:0 0 0 10px">
<span style="font-size:15px;font-weight:800;color:#BF360C">🎯 Filters that matter</span><br>
<span style="font-size:12px;color:#57534E">Brand, seller, price, rating, official sellers, coupons and more.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #FFD7BD;border-left:none;vertical-align:top;border-top:none;color:#1C1917">
<span style="font-size:15px;font-weight:800;color:#BF360C">💸 Deal finder</span><br>
<span style="font-size:12px;color:#57534E">List price and discount percent on every row, sorted by biggest discount.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #FFD7BD;border-left:none;vertical-align:top;border-top:none;color:#1C1917">
<span style="font-size:15px;font-weight:800;color:#BF360C">🔔 Price-drop monitor</span><br>
<span style="font-size:12px;color:#57534E">Schedule a named watch and get only new products and cheaper prices.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #FFD7BD;border-left:none;vertical-align:top;border-top:none;color:#1C1917;border-radius:0 0 10px 0">
<span style="font-size:15px;font-weight:800;color:#BF360C">📄 Full details on demand</span><br>
<span style="font-size:12px;color:#57534E">Barcode, specifications, stock and every seller's offer.</span>
</td>
</tr>
</table>

**Collect Hepsiburada (Türkiye'nin en büyük online alışveriş sitesi) products by keyword, category or brand page, and download them as JSON, CSV or Excel in minutes.** Each row carries the product name, brand, price, list price, discount percentage, rating, review count, seller, dispatch time and photos. Switch on full details to add the barcode, specifications, stock status and the offers of every seller.

***

### 🔍 What can you do with it?

- **I am an e-commerce seller in Turkey** checking how my competitors price the same products, who sells them and how big their discounts are, so I can adjust before I lose the buy box.
- **I run a price comparison or deals site** and need a steady feed of current Hepsiburada prices, list prices and discounts to publish the best offers first.
- **I am a brand or distributor** tracking which sellers list my products, whether they are authorized, and how far below the list price they sell.
- **I am a market analyst or reseller** looking for the cheapest, best rated or fastest growing products in a category, and for products that just dropped in price.

***

<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0"><tr>
<td style="border:none;padding:12px 18px;background:#FFF3EB;border-left:4px solid #E65100;color:#1C1917">
<span style="font-size:15px;color:#1C1917">&#9889; <b>No login, no account.</b> Ready for the Apify scheduler: name a monitor once and every run reports only what is new or cheaper.</span>
</td>
</tr></table>

### 🚀 How to use it

<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0">
<tr>
<td style="padding:16px 14px;width:33%;background:#FFF3EB;border:1px solid #FFD7BD;border-radius:10px 0 0 10px;vertical-align:top;color:#1C1917">
<span style="font-size:12px;font-weight:800;color:#E65100;letter-spacing:1px">STEP 1</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Say what to collect</span><br>
<span style="font-size:12px;color:#57534E">Type keywords, or paste a search, category, brand or product page from hepsiburada.com.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#FFF3EB;border:1px solid #FFD7BD;border-left:none;vertical-align:top;color:#1C1917">
<span style="font-size:12px;font-weight:800;color:#E65100;letter-spacing:1px">STEP 2</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Filter and sort</span><br>
<span style="font-size:12px;color:#57534E">Set price, rating, brands, sellers, minimum discount and sort order.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#FFF3EB;border:1px solid #FFD7BD;border-left:none;border-radius:0 10px 10px 0;vertical-align:top;color:#1C1917">
<span style="font-size:12px;font-weight:800;color:#E65100;letter-spacing:1px">STEP 3</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Run and download</span><br>
<span style="font-size:12px;color:#57534E">Click Start, then export JSON, CSV or Excel, or schedule the run.</span>
</td>
</tr>
</table>

### ⚙️ Input

All fields are optional. With no changes, the Actor returns 20 products for the keyword kulaklık.

| Field | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| Search keywords | array of text | No | Product keywords in Turkish or English, one per line. Each keyword is collected separately and rows show which keyword found them. |
| Hepsiburada page links | array of URLs | No | Search results, category pages, brand pages or single product pages. Your filters and sort order are applied on top of listing pages. |
| Sort by | enum | No | Recommended, price low to high or high to low, best sellers, most reviewed, top rated, biggest discount or newest. |
| Minimum / maximum price (TRY) | number | No | Price range in Turkish lira. |
| Minimum rating | enum | No | Any, 3, 4 or 4.5 stars and up. |
| Brands | array of text | No | Only these brands, such as JBL or Samsung. |
| Sellers | array of text | No | Only products sold by these stores, written as Hepsiburada shows them. |
| Authorized or official sellers only | boolean | No | Keep products from authorized dealers and official brand stores. |
| Coupon products only | boolean | No | Keep products that carry an extra coupon. |
| Women entrepreneur products only | boolean | No | Keep products from the women entrepreneur program, where offered. |
| Products with photo reviews only | boolean | No | Keep products that have at least one review with a photo. |
| Discounted products only | boolean | No | Keep products that sell below their list price. |
| Minimum discount (%) | integer | No | Keep products discounted by at least this percentage. |
| Minimum number of reviews | integer | No | Skip products with too few reviews. |
| Dispatch time | enum | No | Any, ships the same day, or within 1, 2 or 3 days. |
| Include full product details | boolean | No | Adds barcode, specifications, stock status, every seller's offer, variants and all photos. Slower. Off by default. |
| Maximum products | integer | No | Total products to return, 1 to 50,000. Default 20. |
| Go beyond the per-search limit | boolean | No | Splits very large searches into price ranges to reach past about 1,760 products. |
| Monitor name | text | No | Name a watch to return only new products and price changes since the last run with the same name. |
| What to report | enum | No | New products only, plus price drops, or plus any price change. |
| Smallest price change (%) | number | No | Ignore price moves smaller than this. Default 1. |
| Proxy | object | No | Connection settings. The default works for most runs. |

***

### 📦 Output

Each row is one product. Fields Hepsiburada does not publish are left out instead of being filled with placeholders. This example was collected with full details switched on.

```json
{
  "sku": "HBCV000049D0ZE",
  "productId": "HBC000049D0S4",
  "url": "https://www.hepsiburada.com/anker-soundcore-r50i-kulak-ici-bluetooth-kulaklik-30-saat-calma-suresi-lacivert-a3949-p-HBCV000049D0ZE",
  "title": "Anker Soundcore R50i Kulak İçi Bluetooth Kulaklık, 30 Saat Çalma Süresi, Lacivert - A3949",
  "brand": "Anker",
  "category": "Bluetooth Kulaklıklar",
  "price": 1182.68,
  "currency": "TRY",
  "discountPercent": 0,
  "rating": 4.5,
  "reviewCount": 21157,
  "seller": "Hepsiburada",
  "imageUrl": "https://productimages.hepsiburada.net/s/498/1500/110000549560136.jpg",
  "shipsInDays": 0,
  "barcode": "0194644199548",
  "inStock": true,
  "freeShipping": false,
  "sellerCity": "KOCAELİ",
  "sellerIsOfficial": true,
  "offerCount": 3,
  "lowestOfferPrice": 1182.68,
  "offers": [
    { "seller": "Hepsiburada", "price": 1182.68, "shipsInDays": 0, "isBuyBoxWinner": true },
    { "seller": "TechReyon", "price": 1899, "listPrice": 1899, "shipsInDays": 1, "sellerRating": 9.6, "sellerRatingCount": 18 }
  ],
  "specifications": { "Kulaklık Tipi": "TWS", "Bluetooth Versiyon": "5.3", "Garanti Süresi (Ay)": "24" },
  "categoryPath": ["Telefon", "Cep Telefonu Aksesuarları", "Bluetooth Kulaklıklar"],
  "detailFetched": true
}
```

#### Field reference

| Field | Type | Description |
| :--- | :--- | :--- |
| `sku`, `productId` | string | Hepsiburada product codes. |
| `url`, `title`, `brand` | string | Product link, full name and brand. |
| `category`, `categoryId` | string, number | Main category of the product. |
| `price`, `listPrice`, `discountPercent`, `currency` | number, string | Current price, list price before discount, discount percentage and currency (TRY). |
| `rating`, `reviewCount` | number | Customer rating and number of reviews. Left out when there are no reviews. |
| `seller`, `sellerId` | string | The store currently winning the listing. |
| `imageUrl`, `images` | string, array | Main photo and all photos. |
| `shipsInDays` | number | Days the seller needs to dispatch. 0 means same day. |
| `jetDelivery`, `expressDelivery` | boolean | Fast delivery flags, when present. |
| `couponLabel`, `campaignLabel`, `installment` | string | Coupon, campaign and installment offer text as shown on the site. |
| `options`, `variantCount`, `variants` | object, number, array | Colour or size option and the other variants with their price and link. |
| `isSponsored`, `isPreOrder`, `inStockDate` | boolean, string | Promoted listing, pre-order and expected stock date, when present. |
| `searchQuery`, `sourceUrl`, `page`, `position` | string, number | Which keyword or page found the product and where it ranked. |
| `scrapedAt` | string | When the row was collected. |
| `changeType`, `previousPrice`, `priceChangePercent` | string, number | Monitor runs only: new, price drop or price increase, with the earlier price and the change. |
| `barcode`, `inStock`, `freeShipping` | string, boolean | Full details only. |
| `sellerCity`, `sellerRating`, `sellerRatingCount`, `sellerIsOfficial` | string, number, boolean | Full details only: seller profile. |
| `offerCount`, `lowestOfferPrice`, `offers` | number, array | Full details only: every seller's offer with price, list price, shipping and rating. |
| `specifications`, `categoryPath`, `videoUrl`, `taxVatPercent` | object, array, string, number | Full details only. |
| `detailFetched` | boolean | Whether the full details were added to this row. |

***

### 💰 Pricing

Pricing is pay per event. You pay a Product record event for each product saved to your dataset. If you switch on full details, each product whose details were actually retrieved is charged a second, separate Product details event. Products where details could not be retrieved are not charged for it, and runs with no results cost nothing. Both events follow your Apify plan, so higher plans pay less per event, and the maximum charge you set for a run is always respected. There are no monthly subscriptions or hidden fees. Free-plan runs are limited to 25 products per run, 3 runs per day, and a short wait between runs. Paid plans have no such limits.

***

### ⭐ Enjoying Hepsiburada Products Scraper?

<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0">
<tr>
<td style="padding:20px 24px 14px;background:#FFF3EB;border:1px solid #FFD7BD;border-left:5px solid #E65100;border-radius:10px 10px 0 0;color:#1C1917">
<span style="font-size:20px;letter-spacing:4px">⭐ ⭐ ⭐ ⭐ ⭐</span><br>
<span style="font-size:17px;font-weight:800;color:#1C1917">If this saves you hours of checking Hepsiburada prices by hand, tell us about it.</span><br>
<span style="font-size:14px;color:#57534E">A 5-star rating takes 10 seconds and helps other sellers, deal sites and analysts working with Turkish retail data find it. Your feedback also tells us what to build next.</span>
</td>
</tr>
<tr>
<td style="padding:0;background:#C24400;border:1px solid #C24400;border-left:5px solid #C24400;border-top:none;border-radius:0 0 10px 10px;text-align:center;color:#1C1917">
<a href="https://apify.com/getascraper/hepsiburada-products-scraper/reviews" style="display:block;padding:13px 16px;color:#FFFFFF;text-decoration:none;font-weight:800;font-size:15px;letter-spacing:0.3px">★&nbsp;&nbsp;Rate this Actor on Apify</a>
</td>
</tr>
</table>

***

### ✨ Tips and best practices

- **Find real deals fast.** Sort by biggest discount and set a minimum discount of 30 percent or more. The list price and discount are on every row, so you can check the claim yourself.
- **Track your competitors.** Put their store names in Sellers, add your keyword, and schedule the run. You see how their prices move over time.
- **Build a price-drop alert.** Pick a monitor name, choose New products and price drops, and schedule the Actor daily. Each run returns only what is new or cheaper, with the previous price next to the new one. The first run returns everything up to your limit.
- **Copy a page from the site.** Set the filters on hepsiburada.com, paste the page address into the page links, and get exactly that list.
- **Add details only when you need them.** The default run is quick. Turn on full details for barcodes, specifications and the offers of every seller.
- **Go wider than one search.** A single search covers up to about 1,760 products. For larger pulls, turn on the per-search limit option and raise Maximum products.

***

### ❓ FAQ

##### Hepsiburada ürün fiyatlarını Excel'e nasıl aktarırım?

Run the Actor with your keyword, open the Output tab, and export the dataset as Excel or CSV. Turkish characters are kept as published.

##### Hepsiburada'da fiyat düşüşlerini nasıl takip ederim?

Type a monitor name, choose New products and price drops, and schedule the Actor to run every day. Each run reports only products that are new or cheaper, with the previous price.

##### Does it need a Hepsiburada account?

No. It collects publicly visible product pages and needs no login or account.

##### Does it return list price and discount?

Yes. Every row has the current price, the list price and the discount percentage when a discount applies.

##### Can it find every seller of one product?

Yes. Switch on full product details and each row lists every seller's offer with price, shipping and seller rating.

##### Does it return customer reviews or personal data?

No. It returns product, price and seller information only: no customer reviews, accounts or private contact details.

***

### 🛡️ Disclaimers and support

- **Disclaimer:** This Actor retrieves publicly available product information. It is an independent tool and is not affiliated with or endorsed by Hepsiburada. Make sure your use complies with the site's terms and applicable laws.
- **Support:** Open an issue from the Actor page in the Apify Console for bug reports or feature requests.

### 🔗 Other actors

- [Trendyol Price Monitor: Fiyat Takibi (Türkiye)](https://apify.com/getascraper/trendyol-price-monitor) ↗ - Track Trendyol prices and discounts over time.
- [N11 Scraper: Ürün Fiyat, İndirim & Satıcı | Price Intelligence](https://apify.com/getascraper/n11-product-search-intelligence-scraper) ↗ - N11 prices, discounts and sellers.
- [Epey Turkey Price & Specs Scraper](https://apify.com/getascraper/epey-prices-scraper) ↗ - Turkish price comparison with specifications.
- [Kariyer.net Jobs Scraper: İş İlanları Türkiye with Filters](https://apify.com/getascraper/kariyer-net-jobs-scraper) ↗ - Turkish job postings by city, sector and level.

# Changelog

This Actor's version history is a separate document: https://apify.com/getascraper/hepsiburada-products-scraper/changelog.md

# Actor input Schema

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

Product keywords to search on Hepsiburada, one per line, in Turkish or English (for example kulaklık, laptop, bebek bezi). Each keyword is collected separately and every row says which keyword found it.

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

Paste Hepsiburada search results, category pages (…-c-12345), brand pages or single product pages (…-p-HBCV…). Your filters and sort order below are applied on top of listing pages. Product page links return that product directly.

## `sortBy` (type: `string`):

Order in which Hepsiburada lists the results before the result limit is applied. Choose price low to high to find the cheapest offers, or biggest discount to find deals first.

## `minPrice` (type: `number`):

Only products priced at or above this amount in Turkish lira. Leave empty for no lower limit.

## `maxPrice` (type: `number`):

Only products priced at or below this amount in Turkish lira. Leave empty for no upper limit.

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

Only products whose customer rating is at least this many stars.

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

Only these brands, one per line, for example JBL or Samsung. Several brands are combined, so a product from any of them matches.

## `sellers` (type: `array`):

Only products sold by these stores, one per line. Write the store name exactly as Hepsiburada shows it, for example Hepsiburada or a marketplace seller name. Useful to track what one seller lists or how their prices move.

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

Keep only products sold by authorized dealers or official brand stores. Handy for avoiding grey-market and counterfeit-prone listings.

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

Keep only products that carry an extra coupon offer on Hepsiburada.

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

Keep only products from Hepsiburada's women entrepreneur program. Available in categories where the site offers this filter.

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

Keep only products that have at least one customer review with a photo.

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

Keep only products that currently sell below their list price. Product list price and discount percentage are included in every row.

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

Keep only products discounted by at least this percentage off the list price. 0 means no minimum. Use it with Biggest discount sorting to surface real deals.

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

Keep only products with at least this many customer reviews, which filters out untested listings. 0 means no minimum.

## `maxShipmentDays` (type: `string`):

Keep only products the seller ships within this many days. Same day means the seller dispatches the order on the day it is placed.

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

Open each product page to add the barcode, full specifications, stock status, free shipping flag, every seller's offer with price and rating, color and size variants, all photos and the video. Slower and billed as an extra event per product, so leave it off when you only need prices and ratings.

## `maxResults` (type: `integer`):

Total number of products to collect across all keywords and links. The default keeps a first run fast; raise it for larger collections.

## `splitToExceedLimit` (type: `boolean`):

When a search matches more products than one search can serve (about 1,760), split it into price ranges and collect each range separately so you reach further. Only used when Maximum products is above that limit.

## `monitorScope` (type: `string`):

Give this watch a name (for example laptop-deals) to switch on monitoring. The Actor remembers the products and prices it delivered under this name and, on the next run with the same name, returns only what is new or cheaper. Leave empty to return everything every time. Schedule the run to track a market over time.

## `monitorMode` (type: `string`):

New products only, new products plus price drops, or new products plus any price change up or down. Price changes are measured against the last price this monitor saw.

## `minPriceChangePercent` (type: `number`):

Ignore price moves smaller than this percentage, so rounding noise does not trigger alerts.

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

Hepsiburada answers the Actor without a proxy, which keeps runs cheapest. If the site ever refuses, the Actor switches itself to a datacenter proxy and then to a Turkish residential proxy. Leave as is unless you need a specific proxy.

## Actor input object example

```json
{
  "searchQueries": [
    "kulaklık"
  ],
  "sortBy": "relevance",
  "minRating": "any",
  "officialSellersOnly": false,
  "couponProductsOnly": false,
  "womenEntrepreneurOnly": false,
  "withPhotoReviewsOnly": false,
  "onlyDiscounted": false,
  "minDiscountPercent": 0,
  "minReviews": 0,
  "maxShipmentDays": "any",
  "includeDetails": false,
  "maxResults": 20,
  "splitToExceedLimit": false,
  "monitorScope": "",
  "monitorMode": "new_only",
  "minPriceChangePercent": 1,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (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": [
        "kulaklık"
    ],
    "sortBy": "relevance",
    "minRating": "any",
    "officialSellersOnly": false,
    "couponProductsOnly": false,
    "womenEntrepreneurOnly": false,
    "withPhotoReviewsOnly": false,
    "onlyDiscounted": false,
    "minDiscountPercent": 0,
    "minReviews": 0,
    "maxShipmentDays": "any",
    "includeDetails": false,
    "maxResults": 20,
    "splitToExceedLimit": false,
    "monitorScope": "",
    "monitorMode": "new_only",
    "minPriceChangePercent": 1,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/hepsiburada-products-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": ["kulaklık"],
    "sortBy": "relevance",
    "minRating": "any",
    "officialSellersOnly": False,
    "couponProductsOnly": False,
    "womenEntrepreneurOnly": False,
    "withPhotoReviewsOnly": False,
    "onlyDiscounted": False,
    "minDiscountPercent": 0,
    "minReviews": 0,
    "maxShipmentDays": "any",
    "includeDetails": False,
    "maxResults": 20,
    "splitToExceedLimit": False,
    "monitorScope": "",
    "monitorMode": "new_only",
    "minPriceChangePercent": 1,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/hepsiburada-products-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": [
    "kulaklık"
  ],
  "sortBy": "relevance",
  "minRating": "any",
  "officialSellersOnly": false,
  "couponProductsOnly": false,
  "womenEntrepreneurOnly": false,
  "withPhotoReviewsOnly": false,
  "onlyDiscounted": false,
  "minDiscountPercent": 0,
  "minReviews": 0,
  "maxShipmentDays": "any",
  "includeDetails": false,
  "maxResults": 20,
  "splitToExceedLimit": false,
  "monitorScope": "",
  "monitorMode": "new_only",
  "minPriceChangePercent": 1,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call getascraper/hepsiburada-products-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/hepsiburada-products-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/wBCiMN376js6nDLh9/builds/1ipLvKZOwTSd295tK/openapi.json