Hepsiburada Scraper

Disclaimer: Unofficial tool — not affiliated with, sponsored by, or endorsed by Hepsiburada (D-Market Elektronik Hizmetler ve Ticaret A.Ş.) or its affiliates. Data is read from publicly accessible search and category pages only. No login. You are responsible for complying with applicable law (including GDPR where personal data appears) and the site’s terms. No warranty on accuracy or availability. Provided for informational and research use.

Hepsiburada Scraper pulls search cards into JSON for Turkey price monitoring. Each row is one product from a search or category page: TRY price, brand, rating, review count, merchant, and SKU. Run it from Python, Node.js, cURL, or an AI assistant over MCP.

Hepsiburada Scraper ◄── you are here

Actor	What it collects
Hepsiburada Scraper ◄── you are here	Hepsiburada search cards: price, brand, rating, merchant
Trendyol Scraper	Trendyol search cards: price, brand, rating, seller
Sahibinden Scraper	Turkey classifieds: real estate, cars, shopping

When to use this Actor

• Track a keyword’s prices, discounts, and ratings.
• See which merchant wins the card and whether the placement is promoted.
• Export a search or category URL you already filtered in the browser.
• Feed a sheet, warehouse, or MCP agent with one JSON row per product.

When not to use this Actor

• You need the full description, every variant, or review text. This Actor reads the search page only.
• You need a seller’s email or phone.
• You need classifieds (homes, cars, second-hand). Use Sahibinden for that.

Key features

• Search pages. Keywords and search or category URLs. The next page is the same document with sayfa.
• Search-card fields. TRY price, original price, brand, rating, review count, merchant, SKU, and a sponsored flag.
• HTTP. No browser. A direct connection is the default.
• Empty searches stay empty. A blocked or zero-result page finishes with no rows.

Input

Field	Type	Default	What it does
searchQueries	string[]	telefon	Keywords. Each one opens search pages.
startUrls	URL[]	—	Search or category URLs. Product pages are skipped.
minPrice / maxPrice	number	—	Drop cards outside this TRY range.
includeSponsored	boolean	true	Keep promoted cards, flagged on the row.
maxItems	integer	50	Cap across all keywords and URLs.
maxPagesPerQuery	integer	2	Search pages per keyword or URL.
proxyConfiguration	object	—	Optional Apify proxy if a direct run returns no rows.

{
  "searchQueries": ["telefon"],
  "maxItems": 30,
  "maxPagesPerQuery": 1,
  "includeSponsored": true
}

A pasted search URL:

{
  "startUrls": [{ "url": "https://www.hepsiburada.com/ara?q=telefon" }],
  "maxItems": 20,
  "maxPagesPerQuery": 1
}

Output

One dataset row per product.

Field	Meaning
productId	Product id
sku	Default variant SKU
title	Card title
brand	Brand name
price	Current amount in TRY
originalPrice	Price before discount
discountPercent	Percent off the original price
currency	TRY
rating / reviewCount	Average rating and review count
merchantName / merchantId	Seller on the card
sponsored	Promoted placement
inStock	Default variant is procurable
url	Product URL
image	Main image
page / position	Where the card sat on the search page
searchQuery	Keyword that produced the row

{
  "productId": "HBC0000835BOA",
  "sku": "HBCV0000835BOB",
  "title": "Magsafe Telefon Tutucu",
  "brand": "M.TK Moveteck",
  "price": 199,
  "originalPrice": 199,
  "currency": "TRY",
  "rating": 4.3,
  "reviewCount": 3684,
  "merchantName": "Casestore",
  "sponsored": false,
  "url": "https://www.hepsiburada.com/m-tk-moveteck-magsafe-telefon-tutucu-pm-HBC0000835BOA",
  "searchQuery": "telefon",
  "page": 1,
  "position": 1
}

Use cases

Job	What you run	What you keep
Price watch	One keyword, a few pages	price, originalPrice, brand, scrapedAt
Seller share	The same keyword	merchantName on each card
Assortment check	A filtered search or category URL	Only the slice you already narrowed
Turkey comps	Catalog prices here, then the other big catalog	Pair with Trendyol for the same keyword

Integration examples

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('crawloop/hepsiburada-scraper').call({
  searchQueries: ['telefon'],
  maxItems: 30,
  maxPagesPerQuery: 1
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.slice(0, 5));

Python

from apify_client import ApifyClient

client = ApifyClient(token)
run = client.actor("crawloop/hepsiburada-scraper").call(
    run_input={
        "searchQueries": ["telefon"],
        "maxItems": 30,
        "maxPagesPerQuery": 1,
    }
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("sku"), item.get("title"), item.get("price"), item.get("brand"))

cURL

curl "https://api.apify.com/v2/acts/crawloop~hepsiburada-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":["telefon"],"maxItems":30,"maxPagesPerQuery":1}'

MCP and AI assistants

Use this Actor from AI tools via Apify MCP. Connect your Apify account, then call this Actor by Store ID crawloop/hepsiburada-scraper.

Example prompts:

• "Run Hepsiburada Scraper for telefon, one page, and return title, brand, price, currency, and merchantName."
• "Scrape Hepsiburada search for iphone 15 and list the 20 cheapest cards with rating and review count."
• "After Hepsiburada catalog prices, run Trendyol Scraper for the same keyword and compare prices."

Next step

For the other large Turkey catalog, run Trendyol Scraper. For classifieds (homes, cars, second-hand), run Sahibinden Scraper.

FAQ

What do I need to start?
A keyword in searchQueries, or a search or category URL in startUrls.

Does a zero-result search fail the run?
No. The run finishes and the dataset stays empty.

Can I paste a product URL?
Product pages are skipped. Use a search URL (/ara?q=) or a category URL.

How many cards are on a page?
About 36. maxItems stops early. maxPagesPerQuery caps how many search pages open.

Related Actors

• Trendyol Scraper — Turkey catalog search
• Sahibinden Scraper — Turkey classifieds