# Hepsiburada Product Scraper (`agentx/hepsiburada-product-scraper`) Actor

Search Hepsiburada product results in Turkey and export current TRY prices, discounts, promotions, ratings, reviews, seller signals, images, ranks, and source links.

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

## Pricing

from $4.50 / 1,000 results

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## AliExpress Product Scraper — Product Search API for 18 Countries

> **Affiliate disclosure:** Apify links on this page may include referral parameters. If you sign up through them, AgentX may receive a commission at no extra cost to you.

Search AliExpress by keyword and destination country, then export normalized product records with current price signals, discounts, sales text, ratings, shipping or delivery text, images, sponsored status, rank, and source links. Optional fields stay empty when AliExpress does not expose them for a result.

[![Open Actor](https://img.shields.io/badge/Open_AliExpress_Product_Scraper-ffd700?style=for-the-badge)](https://apify.com/agentx/aliexpress-product-scraper?fpr=aiagentapi) [![All APIs](https://img.shields.io/badge/Explore_AgentX_APIs-ffd700?style=for-the-badge)](https://apify.com/agentx?fpr=aiagentapi)

[Run a minimum 10-result test](https://apify.com/agentx/aliexpress-product-scraper?fpr=aiagentapi) with a specific model and one destination country before increasing volume.

***

### Why Choose This API

#### Country-aware AliExpress search

Select one of 18 supported destination countries. Results can reflect localized ranking, currency, availability, and offer signals for that destination instead of using a post-search country label.

#### Source-linked product intelligence

Each publishable record keeps its query, search rank, product URL, and source URL. This makes price, assortment, promotion, and ranking observations easier to verify against the source response for that run.

#### Verifiable records without fabricated values

Delivered records retain source links and leave unavailable optional values empty. This gives downstream users a consistent dataset without inventing seller, price, availability, or identifier data.

#### Predictable normalized output

All records use the shared 58-field AgentX shopping schema. Fields that are not available for a particular AliExpress result remain empty instead of being invented.

***

### Quick Start Guide

1. [Open AliExpress Product Scraper](https://apify.com/agentx/aliexpress-product-scraper?fpr=aiagentapi).
2. Enter a product `keyword`, choose a supported `country`, and set `max_results`.
3. Click **Start**.
4. Review the default dataset and export the records you need.

Example input:

```json
{
  "keyword": "wireless earbuds",
  "country": "United States",
  "max_results": 10
}
```

`max_results` is an upper bound. The delivered count can be lower when AliExpress exposes fewer usable public products for the selected keyword and country.

***

### Input Parameters

| Parameter | Type | Required | Limits | Description |
| --- | --- | --- | --- | --- |
| `keyword` | string | Yes | Non-empty | Product, brand, category, or search phrase to extract AliExpress product data |
| `country` | string | Yes | Supported enum | AliExpress country/site setting to query |
| `max_results` | integer | Yes | 10–10,000 | Maximum number of AliExpress product records to return |

#### Supported countries

Australia, Brazil, Canada, Chile, France, Germany, Italy, Japan, Mexico, Netherlands, Poland, Saudi Arabia, South Korea, Spain, Turkey, United Arab Emirates, United Kingdom, and United States.

This is a single-platform Actor. It does not expose a `platforms` input; use [All Shopping Scraper](https://apify.com/agentx/all-shopping-scraper?fpr=aiagentapi) when you need a multi-platform search.

***

### Output Data Schema

The default dataset contains 58 fields. Source-dependent fields are nullable.

| Group | Fields |
| --- | --- |
| Images and identity | `main_image`, `image_urls`, `title`, `brand`, `badges`, `category`, `breadcrumbs`, `description`, `features`, `product_id`, `sku`, `gtin`, `mpn`, `model` |
| Product details | `specifications`, `manufacturer`, `origin`, `energy_class`, `included`, `condition`, `release_date`, `variant_group`, `variants` |
| Price and promotions | `price`, `was_price`, `unit_price`, `currency`, `price_text`, `discount_pct`, `discount_text`, `promo_text`, `installment_text` |
| Availability and demand | `stock_status`, `stock_text`, `sales_text`, `buy_limit`, `rating`, `review_count` |
| Seller and fulfillment | `seller`, `seller_url`, `seller_score`, `shipping_text`, `shipping_cost`, `delivery_text`, `pickup_text`, `return_text`, `return_days`, `warranty_text` |
| Traceability | `platform`, `site`, `country`, `product_url`, `source_url`, `query`, `rank`, `sponsored`, `processor`, `processed_at` |

Example record:

```json
{
  "main_image": "https://ae01.alicdn.com/kf/example.jpg",
  "title": "Wireless Bluetooth Earbuds",
  "product_id": "1005000000000000",
  "price": 18.99,
  "was_price": 24.99,
  "currency": "USD",
  "price_text": "$18.99",
  "discount_pct": 24,
  "sales_text": "1,000+ sold",
  "rating": 4.6,
  "shipping_text": "Free shipping",
  "platform": "aliexpress",
  "site": "www.aliexpress.com",
  "country": "US",
  "product_url": "https://www.aliexpress.com/item/1005000000000000.html",
  "source_url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds.html",
  "query": "wireless earbuds",
  "rank": 1,
  "sponsored": false,
  "processor": "https://apify.com/agentx/aliexpress-product-scraper",
  "processed_at": "2026-07-20T00:00:00.000Z"
}
```

The example illustrates the schema, not a live product promise. Real rows contain only the values exposed and accepted during that run.

***

### Integration Examples

#### Apify Console and dataset exports

Run the Actor from its Store page, inspect the default dataset, and export data in the formats made available by Apify. The run exposes its dataset reference for downstream automation.

#### Scheduled monitoring workflow

Use a stable keyword, country, and result limit for each scheduled run. Compare `product_id` or `product_url` across datasets, and retain `query`, `rank`, `source_url`, and `processed_at` when evaluating changes.

#### Actor API and MCP

```json
{
  "actorId": "30q96KJJJKp3ruehY",
  "input": {
    "keyword": "wireless earbuds",
    "country": "United States",
    "max_results": 10
  }
}
```

Use the [Actor API tab](https://apify.com/agentx/aliexpress-product-scraper/api?fpr=aiagentapi) for token-aware examples. For AI clients, follow the official [Apify MCP guide](https://docs.apify.com/integrations/mcp) and pass the same explicit input object. The runtime does not manufacture missing required values.

***

### Pricing & Cost Calculator

Each Actor start has an `apify-actor-start` event price of $0.01. Delivered dataset records use the `result` event:

| Account tier | Actor start | Price per delivered result | Total for 10 delivered results |
| --- | ---: | ---: | ---: |
| FREE | $0.01000 | $0.00520 | $0.06200 |
| BRONZE | $0.01000 | $0.00503 | $0.06030 |
| SILVER | $0.01000 | $0.00485 | $0.05850 |
| GOLD | $0.01000 | $0.00468 | $0.05680 |
| PLATINUM | $0.01000 | $0.00468 | $0.05680 |
| DIAMOND | $0.01000 | $0.00468 | $0.05680 |

Charges apply to delivered result events, not the requested `max_results` value. Review the live pricing panel before a large run because Store pricing can change after this README is published.

***

### Compared with alternatives

| Option | Best fit | Important trade-off |
| --- | --- | --- |
| AliExpress Product Scraper | Repeatable keyword snapshots across 18 destination-country contexts | Public observations only; localization and seller data can vary |
| All Shopping Scraper | Compatible multi-platform product research from one workflow | Broader results require more product-matching judgment |
| Manual AliExpress browsing | A few visual checks where a person reviews every seller and variant | Slow to repeat and difficult to audit at scale |
| Authorized merchant tooling | Managing a seller's own catalog, price, and fulfillment | Different credentials, scope, and purpose |

Choose this Actor for structured public search collection. Keep manual listing review for supplier selection, authenticity, delivery, tax, and purchase decisions.

***

### Use Cases & Applications

- Compare localized AliExpress prices, promotions, and ranking for the same keyword.
- Research product assortment and public sales or rating signals.
- Build source-linked product shortlists for manual supplier evaluation.
- Monitor price text, discount, promotion, shipping, and delivery changes over successive runs.
- Enrich internal catalogs with titles, images, identifiers, and traceable product URLs.

The dataset supports research and monitoring; it does not verify seller identity, product authenticity, inventory, delivery performance, or future price availability.

***

### FAQ

#### What does each delivered record represent?

Each record represents a usable public AliExpress result collected during that run. Use `query`, `rank`, `product_url`, `source_url`, and `processed_at` to review its source context.

#### Can a run return fewer records than `max_results`?

Yes. `max_results` is an upper bound, while the delivered count depends on the usable public products available for the selected keyword and country during that run.

#### Why are some fields empty?

AliExpress exposes different fields by result, country, page, and product. Missing values remain empty rather than being inferred.

#### Are prices and rankings historical?

No. Each record represents the public response processed during that run. Save successive datasets if you need history.

#### Does `country` guarantee the same currency or assortment every time?

Results use the selected destination-country context, but AliExpress still controls localization, ranking, availability, currency, and the values returned.

#### Can I request more than 10,000 products?

No. The public input accepts 10 through 10,000. A run may deliver fewer usable products than requested.

#### Can I select another marketplace?

Not in this Actor. Use [All Shopping Scraper](https://apify.com/agentx/all-shopping-scraper?fpr=aiagentapi) for supported multi-platform searches.

***

### Legal & Compliance

Use the Actor and exported data only when permitted by applicable law, the current [AliExpress Terms of Use](https://terms.alicdn.com/legal-agreement/terms/suit_bu1_aliexpress/suit_bu1_aliexpress202204182115_66077.html), and your own compliance requirements. The Actor does not grant intellectual-property, resale, privacy, or marketplace usage rights. Users remain responsible for their inputs, retention, and downstream use.

***

### Related Tools

#### Related product scrapers

- [Bol Product Scraper](https://apify.com/agentx/bol-product-scraper?fpr=aiagentapi)
- [Hepsiburada Product Scraper](https://apify.com/agentx/hepsiburada-product-scraper?fpr=aiagentapi)
- [Rakuten Product Scraper](https://apify.com/agentx/rakuten-product-scraper?fpr=aiagentapi)

#### Enrich with AgentX

- [All Shopping Scraper](https://apify.com/agentx/all-shopping-scraper?fpr=aiagentapi)
- [All Jobs Scraper](https://apify.com/agentx/all-jobs-scraper?fpr=aiagentapi)
- [All Property Scraper](https://apify.com/agentx/all-property-scraper?fpr=aiagentapi)

***

### Support & Community

- [Open the Actor](https://apify.com/agentx/aliexpress-product-scraper?fpr=aiagentapi)
- [Explore AgentX APIs](https://apify.com/agentx?fpr=aiagentapi)
- Telegram community: [@Apify\_Actor](https://t.me/Apify_Actor)
- Direct support: [@AiAgentApi](https://t.me/AiAgentApi)

When reporting a result issue, include the input, run identifier, affected `source_url`, and a small sample of unexpected rows. Do not publish private tokens.

*Last updated: July 21, 2026. Maintained by AgentX.*

# Actor input Schema

## `keyword` (type: `string`):

Product, brand, category, or search phrase to extract AliExpress product data

## `country` (type: `string`):

AliExpress country/site setting to query.

## `max_results` (type: `integer`):

Maximum number of AliExpress product records to return

## Actor input object example

```json
{
  "keyword": "iPhone",
  "country": "United States",
  "max_results": 10
}
```

# Actor output Schema

## `results` (type: `string`):

Product records returned by this actor with normalized fields and source URLs.

# 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 = {
    "keyword": "iPhone",
    "country": "United States",
    "max_results": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("agentx/hepsiburada-product-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 = {
    "keyword": "iPhone",
    "country": "United States",
    "max_results": 10,
}

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

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

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

```

## CLI example

```bash
echo '{
  "keyword": "iPhone",
  "country": "United States",
  "max_results": 10
}' |
apify call agentx/hepsiburada-product-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=agentx/hepsiburada-product-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/vxBn5wJuFm6bfF7qV/builds/5JQ2G3psUH55EFJ34/openapi.json