Hepsiburada Product Scraper - Hepsiburada Product Data Extraction API for Turkey Ecommerce Intelligence

Hepsiburada Product Scraper is a Turkey marketplace data API for researching public Hepsiburada search results, TRY prices, seller signals, and availability. Search Hepsiburada by keyword and country, then receive a normalized 58-field shopping dataset with titles, prices, currency, images, seller context, source URLs, query, rank, and Apify processing metadata. Pay-per-result pricing is $0.01 per Actor start plus $0.005 per product result on the FREE tier.

---

Why Choose This API

Hepsiburada Data for Turkey Marketplace Tracking

🎯 Product Search in One API Call Search Hepsiburada with keyword, country, and max_results to capture Turkey-specific marketplace rankings, product cards, TRY price signals, and public seller context.

💰 Price Intelligence When Sources Disclose It Capture TRY prices, price text, promotion or discount signals, availability text, seller context, and delivery-related snippets when Hepsiburada exposes them publicly.

🌍 Country-Aware Product Coverage Hepsiburada Product Scraper supports 1 country: Turkey. Country routing follows source marketplace behavior instead of applying a fake post-search filter.

🤖 AI-Ready JSON Output Structured records support Turkey ecommerce monitoring, marketplace assortment audits, price dashboards, catalog enrichment, RAG pipelines, and AI shopping data workflows.

⚡ Managed Processing and Platform-Aware Collection Request up to max_results records while preserving Hepsiburada's public ranking and listing behavior. The Actor keeps source URLs, query, and rank for later audit.

📊 58 Data Fields Per Product Extract product intelligence including:

• Product metadata (title, brand, category, description, images)
• Pricing data (price, currency, price text, discount, promotion text)
• Seller and fulfillment data (seller, shipping, delivery, return signals)
• Availability, rating, review, rank, source URL, and processing metadata

---

Quick Start Guide

How to Extract Product Data in 3 Steps

Step 1: Configure Your Search

Open Actor Input

Step 2: Run the Actor

Click Start and the scraper will extract product data from the supported shopping source for your selected country.

Step 3: Download Your Data

Export results in JSON format or access via API. Data includes the 58-field product dataset schema, with optional fields populated only when the source platform exposes them.

---

Input Parameters

Required Inputs

Parameter	Type	Description	Example Values
keyword	string	Product name, model, brand, or search phrase	"Laptop", "wireless earbuds"
country	string	Target country or source market for product search	"Turkey"
max_results	integer	Maximum products to request per selected platform or route	10, 100, 10000

Optional Filters and Output Settings

Parameter	Type	Description	Example Values
platforms	not exposed	Single-platform Actor; the source platform is fixed by the Actor	Not applicable
Source optional fields	mixed	Optional output fields such as seller, rating, discount, shipping, and variants are populated only when the source exposes them	seller, rating, shipping_text

Platform Filter Support Matrix

✅ means the current actor applies the input as a source-side request filter or route selector. ❌ means the input is not exposed for that source.

Platform	keyword	country	max_results	platforms	Detail fields
Hepsiburada	✅	✅	✅	❌	Platform-dependent

platforms Format Options

This single-platform Actor does not expose a platforms input. The source platform is fixed by the Actor, so users should provide only keyword, country, and max_results.

Single-platform behavior:

• Platform selection is not required.
• Passing platforms is not part of the public input schema.
• Use All Shopping Scraper when a multi-platform allowlist is needed.

Search Formatting Best Practices

Product Name or Category:

• "wireless mouse"
• "Smart TV"
• "PlayStation 5"

Brand and Model:

• "Sony WH-1000XM5"
• "iPhone case"
• "Lenovo laptop"

Country Selection:

• Use the separate country parameter for marketplace routing.
• Do not append the country name to keyword unless the source marketplace expects it as part of the product phrase.

Important: Product search ranking is controlled by the source platform. The Actor preserves query, source_url, and rank so users can compare the dataset with the original source behavior.

Supported Countries for Product Scraping

Turkey

Country-Aware Platform Routing

The runtime selects product routes from the Actor input and the selected country. Country-specific platforms are used only when the selected country matches the coverage listed below.

Platform route	Country / market routing
Hepsiburada	Turkey

Example Input Configuration

{
  "keyword": "Laptop",
  "country": "Turkey",
  "max_results": 100
}

---

Output Data Schema

Complete Product Listing Data Structure

Each extracted product record uses the shared AgentX shopping dataset structure with 58 normalized fields. Fields are populated only when the source listing, source API, or detail page exposes them reliably.

Product Metadata Fields

Field	Type	Description
main_image	string/null	Primary product image URL
image_urls	array/null	Deduplicated product image URLs
title	string/null	Product title
brand	string/null	Product brand
category, breadcrumbs	string/array/null	Product category and breadcrumb path
description, features, specifications	string/array/object/null	Product content and detail-page fields

Offer & Availability Details

Field	Type	Description
stock_status, stock_text	string/null	Normalized and original availability text
sales_text, buy_limit	string/integer/null	Demand or purchase-limit signals
rating, review_count	number/integer/null	Public rating and review signals
sponsored	boolean/null	Whether the source marks the result as sponsored

Pricing Information

Field	Type	Description
price	number/null	Current numeric price
was_price	number/null	Original or strikethrough price
currency	string/null	ISO currency code or source currency signal
price_text	string/null	Original price text for verification
discount_pct, discount_text, promo_text, installment_text	mixed/null	Discount, promotion, coupon, and installment signals

Seller Data

Field	Type	Description
seller, seller_url, seller_score	string/number/null	Seller, shop, or marketplace signals
shipping_text, shipping_cost	string/number/null	Shipping text and numeric shipping cost when available
delivery_text, pickup_text, return_text, return_days, warranty_text	mixed/null	Delivery, pickup, return, and warranty signals
platform, site, country, product_url, source_url, query, rank	mixed/null	Source traceability fields for query-to-result audits

Example JSON Output

{
  "main_image": "https://productimages.hepsiburada.net/example.jpg",
  "image_urls": [
    "https://productimages.hepsiburada.net/example.jpg"
  ],
  "title": "Lenovo IdeaPad Laptop 16GB RAM 512GB SSD",
  "brand": "Lenovo",
  "category": "Electronics",
  "description": "Example Hepsiburada product record for README documentation.",
  "features": [
    "Source-linked product row",
    "Normalized AgentX shopping schema"
  ],
  "product_id": "EXAMPLE-001",
  "price": 24999.0,
  "currency": "TRY",
  "price_text": "TRY 24,999.00",
  "stock_status": "in_stock",
  "stock_text": "In stock",
  "rating": 4.6,
  "review_count": 1248,
  "seller": "Hepsiburada",
  "platform": "Hepsiburada",
  "site": "hepsiburada.com",
  "country": "Turkey",
  "product_url": "https://www.hepsiburada.com/example-p-HBCV000000000",
  "source_url": "https://www.hepsiburada.com/ara?q=Laptop",
  "query": "Laptop",
  "rank": 1,
  "sponsored": false,
  "processor": "https://apify.com/agentx/hepsiburada-product-scraper",
  "processed_at": "2026-06-29T00:00:00+00:00"
}

Export Formats

Export results as JSON, JSONL, CSV, Excel, XML, RSS, or access records programmatically through the Apify dataset API.

---

Integration Examples

Actor ID for Platform Integration

• Actor ID: agentx/hepsiburada-product-scraper
• REST API path: agentx~hepsiburada-product-scraper
• Actor URL: https://apify.com/agentx/hepsiburada-product-scraper

Ⓜ️ Make.com Setup:

Use the Apify module, select agentx/hepsiburada-product-scraper, pass the JSON input, then map dataset items into your spreadsheet, pricing database, product feed, or alert workflow.

🎱 N8N.io Setup:

Use the Apify node or HTTP Request node to run the Actor, then fetch defaultDatasetId items for downstream automation.

Python Integration Example

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

# Prepare Actor input
run_input = {"keyword": "Laptop", "country": "Turkey", "max_results": 100}

# Run the Actor and wait for completion
run = client.actor("agentx/hepsiburada-product-scraper").call(run_input=run_input)

# Fetch results from dataset
items = client.dataset(run["defaultDatasetId"]).list_items().items
for item in items:
    print(item.get("title"), item.get("price"), item.get("currency"))

JavaScript/Node.js Integration

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "YOUR_APIFY_TOKEN" });
const run = await client.actor("agentx/hepsiburada-product-scraper").call({"keyword": "Laptop", "country": "Turkey", "max_results": 100});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => console.log(item.title, item.price, item.currency));

JSON-LD Metadata

{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "Hepsiburada Product Scraper",
  "applicationCategory": "BusinessApplication",
  "operatingSystem": "Cloud",
  "url": "https://apify.com/agentx/hepsiburada-product-scraper",
  "provider": {
    "@type": "Organization",
    "name": "AgentX",
    "url": "https://apify.com/agentx"
  },
  "offers": {
    "@type": "Offer",
    "price": 0.005,
    "priceCurrency": "USD",
    "description": "Pay-per-result event pricing"
  }
}

---

Pricing & Cost Calculator

Transparent Pay-Per-Use Model

Hepsiburada Product Scraper uses pay-per-event pricing. apify-actor-start is charged at $0.01 when the Actor starts. The dataset billing event is result: FREE tier $0.005 per delivered product record, and GOLD/PLATINUM/DIAMOND $0.0045 per delivered product record.

Cost Examples

Delivered product records	FREE-tier result cost	Notes
100	$0.50	Small validation run
1,000	$5.00	Standard category or keyword run
10,000	$50.00	Large export before account-tier discounts

Pricing Scope

Pricing applies to delivered dataset records. The final result count can be lower than max_results when the source platform returns fewer public products, reaches a source-side boundary, or omits usable product rows.

---

Use Cases & Applications

Ecommerce & Marketplace Intelligence

Track Hepsiburada product prices, TRY price text, availability, images, seller context, product URLs, and search rank for Turkey ecommerce analysis.

Market Research & Business Intelligence

Compare Turkey-specific assortment, marketplace offer visibility, product-card price bands, seller exposure, and rank movement across repeated keyword runs.

AI & Machine Learning Applications

Feed Hepsiburada product rows into Turkey retail dashboards, local catalog matching, RAG systems, product classification, and AI shopping workflows.

Pricing & Assortment Analytics

Schedule repeated runs for the same Turkish keyword to monitor TRY price movement, stock text, seller changes, promotion text, and source ranking.

Product Feed & Catalog Enrichment

Use Hepsiburada titles, images, URLs, price fields, seller context, availability text, and query/rank metadata to enrich Turkey product catalogs.

---

FAQ

What product platforms does Hepsiburada Product Scraper support?

Hepsiburada Product Scraper supports the Hepsiburada route for Turkey. The country input is fixed to Turkey because this actor targets the Turkish marketplace route.

How many products can Hepsiburada Product Scraper extract per selected platform?

max_results is the requested upper bound for Hepsiburada rows. The final count can be lower when Hepsiburada returns fewer public products, changes pagination, or hides usable product cards.

Which countries are supported?

Supported countries are defined by the Actor input schema: Turkey.

How fresh is the product data?

The Actor reads current public search/listing responses at run time. Marketplace ranking, availability, price, and seller signals can change between runs.

What data format does the scraper output?

The default Apify dataset can be exported as JSON, JSONL, CSV, Excel, XML, RSS, or consumed through the dataset API.

Can I integrate this with my existing tools?

Yes. Use the Apify Client SDK, REST API, Make, n8n, Zapier-style workflows, webhooks, or direct dataset exports.

Is the scraper compatible with AI frameworks?

Yes. The normalized JSON dataset is suitable for LangChain, CrewAI, AutoGPT, RAG pipelines, and custom shopping agents.

How do I handle limited source availability?

Use query, source_url, platform, site, country, rank, and processed_at to verify what the source returned for that run.

Why do some search results seem unrelated to my search terms?

Hepsiburada can rank products by relevance, availability, seller offer, promotion, and category interpretation. The Actor preserves the source ranking instead of rewriting it.

Why are some price fields empty?

Some source listings hide prices, require selection, show unavailable products, or expose price only on detail pages. Optional fields remain empty when the source does not expose them reliably.

What if no products are found?

Try a broader keyword, confirm the selected country is supported, and check whether the same query returns public results on the source marketplace.

Can I get seller or shop information?

Seller and shop fields are populated when Hepsiburada exposes them publicly. Some product cards may provide limited seller context or only listing-level offer text.

How accurate is rating data?

Rating and review fields reflect the public values exposed by the source at run time. They should be treated as marketplace-provided signals.

How are platform-specific failures handled?

The Actor keeps source-specific failures isolated where possible. Use run logs, source_url, and dataset counts to diagnose source-side blocks or empty responses.

Why do different platforms show different product counts?

Hepsiburada product counts depend on keyword breadth, category matching, public pagination, availability, and source-side result limits. The Actor preserves those differences for realistic Turkey marketplace data.

---

SEO Keywords & Search Terms

Primary Keywords

Hepsiburada Product Scraper, Hepsiburada scraper, Hepsiburada product data API, Turkey ecommerce scraper

Long-Tail Keywords

scrape Hepsiburada products by keyword, Hepsiburada TRY price dataset, Hepsiburada seller product data, Hepsiburada Product Scraper Apify API

Industry Terms

Turkey marketplace intelligence, TRY price monitoring, seller offer tracking, product feed enrichment, retail catalog analytics

Location-Based Keywords

Hepsiburada Turkey product data, Turkish ecommerce product data, Turkey marketplace scraper, Hepsiburada price tracking

Use Case Keywords

Turkey competitor price tracking, Hepsiburada seller monitoring, marketplace assortment analytics, local catalog enrichment, AI shopping data

---

Trust & Certifications

Hepsiburada Product Scraper is maintained by AgentX and runs on Apify infrastructure. The output keeps source URLs, query values, platform names, country, rank, and processing timestamps so users can audit the relationship between input and dataset rows.

---

Legal & Compliance

Data Rights & Usage

Use exported product data according to applicable laws, marketplace terms, and your own compliance requirements. The Actor returns public product/search information and does not grant resale or intellectual-property rights.

Privacy Compliance

The Actor is built for product and listing data, not private account data, checkout data, or personal shopper profiles.

Platform Terms of Service

Hepsiburada Product Scraper respects source-platform public responses. Platform ranking, availability, pricing, and result limits can change independently of the Actor.

Enterprise Support

For high-volume usage, dedicated workflows, or compliance review, contact AgentX through the Apify Actor page or publisher profile.

---

Related Tools

Shopping & Ecommerce

• All Shopping Scraper
• AliExpress Product Scraper
• Bol Product Scraper
• Hepsiburada Product Scraper
• Kakaku Product Scraper
• Rakuten Product Scraper

---

Support & Community

• Actor page: https://apify.com/agentx/hepsiburada-product-scraper
• Publisher page: https://apify.com/agentx
• Use Apify run logs and dataset previews to verify query, country, source_url, and rank when diagnosing result differences.

Last updated: 2026-06-29. Maintained by AgentX.