# Hepsiburada Product Reviews Api (`caa_software/hepsiburada-product-reviews-api`)

The Hepsiburada Product Details Page Scraper extracts detailed product data from all including reviews, ratings, merchants, image URLs, etc., by providing product sku id.

- **URL**: https://beta-securitybyobscurity.apify.com/caa\_software/hepsiburada-product-reviews-api.md
- **Developed by:** [CAA Software](https://beta-securitybyobscurity.apify.com/caa_software) (community)
- **Categories:** E-commerce, Automation, AI
- **Stats:** 3 total users, 3 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$20.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.
You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

# README

### Hepsiburada Product Reviews API

Retrieve valuable Hepsiburada data with ease. Input a Hepsiburada Product Id and instantly access reviews and metadata.

Automate your data collection through API access and scheduled runs. Export your data in various formats and monitor scraping progress. Integrate with other applications for a streamlined workflow.

### Bugs, fixes, updates and changelog

This scraper is under active development. If you have any feature requests you can create an issue from here. Enhanced to crawling 100 items with only 128MB memory.

### Hepsiburada Product Reviews API Input example

```
{
    "cursor": 0,
    "productId": "HBCV00004UJY76",
    "size": 100
}
```

### Hepsiburada Product Reviews API Output example

```
{
    "itemsPerPage": 100,
    "currentItemCount": 100,
    "totalItemCount": 907,
    "data": {
        "approvedUserContent": {
            "approvedUserContentList": [
                {
                    "id": "ee96d7da-2788-4060-93ac-3058927f6b6d",
                    "customer": {
                        "name": "R****",
                        "surname": "İ******",
                        "gender": "",
                        "birthDate": null,
                        "isInfluencer": false,
                        "profilePrivacy": 0,
                        "profilePictureUrl": null,
                        "displayName": "R************"
                    },
                    "product": {
                        "sku": "HBCV00004UJY76",
                        "name": "Dyson V15 Detect™ Kablosuz Süpürge",
                        "brand": "Dyson",
                        "imageUrl": "https://productimages.hepsiburada.net/s/503/{size}/110000557161947.jpg",
                        "url": "https://www.hepsiburada.com/dyson-v15-detect-kablosuz-supurge-p-HBCV00004UJY76",
                        "variantProperties": null
                    },
                    "order": {
                        "merchantId": "75c3c271-ba3c-40ef-bfc5-8e66418a7f10",
                        "merchantName": "Dyson Türkiye",
                        "merchantUrl": "dyson-turkiye",
                        "cargoFirm": "",
                        "shippingAddressCounty": "",
                        "shippingAddressCity": "",
                        "purchasedListInformation": null
                    },
                    "review": {
                        "content": "Bir puan kırma sebebim kutunun içinden çıkardıkları 2 parça aparatın olmaması. Güzel bir alet ama bu kadar pahalı olup birde aparatı içinden çıkarmaları anlaşılır gibi değil. Çıkardıkları aparatların boş kutuları bile içinde. Demekki paket halinde gelen kutunun içini açıp aparatları alıp geri kapatıyorlar. Bu hiç etik bir davranış değil."
                    },
                    "star": 4,
                    "mould": null,
                    "media": null,
                    "createdAt": "2024-02-15T07:03:56.8611761+00:00",
                    "isPurchaseVerified": true,
                    "displayCustomerName": false,
                    "reportCount": 3,
                    "platform": 3,
                    "reactions": {
                        "clap": 280,
                        "thumbsdown": 17
                    },
                    "firm": null,
                    "contentType": 1,
                    "featureStars": [],
                    "expertStatus": null,
                    "keywords": [],
                    "explanation": null,
                    "video": null,
                    "contentUpdatedAt": null
                },
                ...
            ],
            "listCount": 907
        },
        "filterData": {
            "merchants": [
                {
                    "name": "Dyson Türkiye",
                    "count": 568
                },
                {
                    "name": "Hepsiburada",
                    "count": 145
                },
                {
                    "name": "SATÜRN",
                    "count": 66
                },
                {
                    "name": "SLGELEKTRONİK",
                    "count": 43
                },
                {
                    "name": "Zitek Bilişim",
                    "count": 14
                },
                {
                    "name": "smartport",
                    "count": 9
                },
                {
                    "name": "İnce hesap",
                    "count": 8
                },
                {
                    "name": "AKDEMİR TEKNOLOJİ",
                    "count": 6
                },
                {
                    "name": "Şallı",
                    "count": 6
                },
                {
                    "name": "Erpa-Holding",
                    "count": 5
                },
                {
                    "name": "elektrobutik.com Laptopfırsatı",
                    "count": 4
                },
                {
                    "name": "HAN-TECH",
                    "count": 4
                },
                {
                    "name": "ATLAS AVM",
                    "count": 3
                },
                {
                    "name": "Cloudyy",
                    "count": 3
                },
                {
                    "name": "NÖTRON",
                    "count": 2
                },
                {
                    "name": "TECHNICS",
                    "count": 2
                },
                {
                    "name": "MER-TEL İLETİŞİM",
                    "count": 2
                },
                {
                    "name": "REDTEK BİLİŞİM",
                    "count": 2
                },
                {
                    "name": "KVD Market-Butik",
                    "count": 2
                },
                {
                    "name": "AR-AS",
                    "count": 2
                },
                {
                    "name": "Cellvı Tech",
                    "count": 1
                },
                {
                    "name": "toprakhometech",
                    "count": 1
                },
                {
                    "name": "ERCELL İLETİŞİM",
                    "count": 1
                },
                {
                    "name": "Alsambunu",
                    "count": 1
                },
                {
                    "name": "Güven Al Tedarik",
                    "count": 1
                },
                {
                    "name": "TRENDBULL",
                    "count": 1
                },
                {
                    "name": "Durutek",
                    "count": 1
                },
                {
                    "name": "btbilisim",
                    "count": 1
                },
                {
                    "name": "Teknosa",
                    "count": 1
                },
                {
                    "name": "Buy It",
                    "count": 1
                },
                {
                    "name": "Kapında Teknoloji",
                    "count": 1
                }
            ],
            "starCounts": {
                "1": {
                    "star": 1,
                    "starCount": 65
                },
                "2": {
                    "star": 2,
                    "starCount": 13
                },
                "3": {
                    "star": 3,
                    "starCount": 36
                },
                "4": {
                    "star": 4,
                    "starCount": 54
                },
                "5": {
                    "star": 5,
                    "starCount": 739
                }
            },
            "keywords": []
        }
    },
    "summary": "Dyson V15 Detect™ Kablosuz Süpürge, güçlü çekim gücü ve lazer ışıklı başlığıyla tozları etkili bir şekilde temizliyor. Kullanıcılar, ürünün pratik ve kullanışlı olduğunu, evcil hayvan sahipleri için ideal bir seçim olduğunu belirtiyor. Ayrıca, geniş toz haznesi sayesinde uzun süreli kullanım imkanı sağlıyor. Ancak, bazı kullanıcılar ürünün ağırlığından şikayetçi ve mini başlık gibi bazı aksesuarların eksikliğini hissediyor. Yine de, fiyatının hakkını veren bu süpürge, temizlik kalitesiyle dikkat çekiyor ve kullanıcılar tarafından tavsiye ediliyor.",
}
```

# Actor input Schema

## `productId` (type: `string`):

The sku id of product you want to get the data from.

## `cursor` (type: `integer`):

The from value for the pagination

## `size` (type: `integer`):

The size value for the pagination

## Actor input object example

```json
{
  "productId": "446949530",
  "cursor": 0,
  "size": 0
}
```

# 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 = {
    "productId": "446949530"
};

// Run the Actor and wait for it to finish
const run = await client.actor("caa_software/hepsiburada-product-reviews-api").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 = { "productId": "446949530" }

# Run the Actor and wait for it to finish
run = client.actor("caa_software/hepsiburada-product-reviews-api").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 '{
  "productId": "446949530"
}' |
apify call caa_software/hepsiburada-product-reviews-api --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Hepsiburada Product Reviews Api",
        "description": "The Hepsiburada Product Details Page Scraper extracts detailed product data from all including reviews, ratings, merchants, image URLs, etc., by providing product sku id.",
        "version": "0.0",
        "x-build-id": "SegEQR4ACa3pDbpeJ"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/caa_software~hepsiburada-product-reviews-api/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-caa_software-hepsiburada-product-reviews-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/caa_software~hepsiburada-product-reviews-api/runs": {
            "post": {
                "operationId": "runs-sync-caa_software-hepsiburada-product-reviews-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/caa_software~hepsiburada-product-reviews-api/run-sync": {
            "post": {
                "operationId": "run-sync-caa_software-hepsiburada-product-reviews-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "productId",
                    "cursor",
                    "size"
                ],
                "properties": {
                    "productId": {
                        "title": "Sku Id of Product",
                        "type": "string",
                        "description": "The sku id of product you want to get the data from."
                    },
                    "cursor": {
                        "title": "From",
                        "type": "integer",
                        "description": "The from value for the pagination",
                        "default": 0
                    },
                    "size": {
                        "title": "Size",
                        "type": "integer",
                        "description": "The size value for the pagination",
                        "default": 0
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
