Hepsiburada Product Reviews API

An Apify actor that scrapes product reviews and metadata from Hepsiburada.com, a major Turkish e-commerce platform. Provide a product ID to retrieve structured review data, including customer details, ratings, and merchant information.

Key Features

• Scrape Reviews: Fetches all reviews for a given Hepsiburada product ID.
• Structured Data: Returns clean JSON with pagination info, review content, star ratings, customer data, and product details.
• Efficient: Can crawl 100 items per request using only 128MB of memory.
• Automation Ready: Supports API access and scheduled runs for automated data collection.
• Multiple Export Formats: Data can be exported as JSON, CSV, Excel, XML, or RSS.
• Integration: Easily connect with other apps and workflows via webhooks or the Apify API.

How to Use

Run the actor with a JSON input containing the Hepsiburada product identifier. Use the cursor parameter for pagination to retrieve all reviews.

Input

Configure the actor run with an input object like this:

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

• productId (required): The unique product code from the Hepsiburada product page URL (e.g., p-HBCV00004UJY76).
• cursor: The starting index for pagination (default is 0).
• size: Number of reviews to fetch per page (default is 100).

Output

The actor outputs a structured JSON object. The main data is contained within the data.approvedUserContent.approvedUserContentList array. Each item in the list represents a single review.

Example Output Structure:

{
  "itemsPerPage": 100,
  "currentItemCount": 100,
  "totalItemCount": 907,
  "data": {
    "approvedUserContent": {
      "approvedUserContentList": [
        {
          "id": "ee96d7da-2788-4060-93ac-3058927f6b6d",
          "customer": {
            "name": "R****",
            "surname": "İ******",
            "displayName": "R************"
          },
          "product": {
            "sku": "HBCV00004UJY76",
            "name": "Dyson V15 Detect™ Kablosuz Süpürge",
            "brand": "Dyson",
            "url": "https://www.hepsiburada.com/dyson-v15-detect-kablosuz-supurge-p-HBCV00004UJY76"
          },
          "order": {
            "merchantName": "Dyson Türkiye"
          },
          "review": {
            "content": "Review text here..."
          },
          "star": 4,
          "createdAt": "2024-02-15T07:03:56.8611761+00:00",
          "isPurchaseVerified": true,
          "reactions": {
            "clap": 280,
            "thumbsdown": 17
          }
        }
      ],
      "listCount": 907
    },
    "filterData": {
      "merchants": [{"name": "Dyson Türkiye", "count": 568}],
      "starCounts": {
        "1": {"star": 1, "starCount": 65},
        "5": {"star": 5, "starCount": 739}
      }
    }
  }
}

Key Output Fields:
* Pagination: itemsPerPage, currentItemCount, totalItemCount.
* Review Data: Each review contains id, review.content, star rating, createdAt timestamp, and verification status (isPurchaseVerified).
* Customer: Anonymized customer info (customer.displayName).
* Product: Basic product details (product.name, brand, sku, url).
* Merchant: Seller name from order.merchantName.
* Aggregations: filterData provides summary counts per merchant and star rating.

Notes

This scraper is under active development. For bug reports or feature requests, you can create an issue on the actor's page.