Hepsiburada Product Search & Category Price Scraper: MCP config, n8n workflow and API

{
  "mode": "search",
  "searchQueries": [
    "laptop"
  ],
  "sortBy": "recommended",
  "discountedOnly": false,
  "fastDeliveryOnly": false,
  "officialSellersOnly": false,
  "includeProductDetails": false,
  "maximizeCoverage": false,
  "maxItems": 3
}

---
name: hepsiburada-product-search-and-category-price
description: "One record per Hepsiburada product with price, list price, discount, rating, seller, stock, shipping, installments, variants, specifications, images, and category path. Runs the Apify Actor dataspryva/hepsiburada-product-search-and-category-price. Use when the user needs Hepsiburada data and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "dataspryva/hepsiburada-product-search-and-category-price"
  store-url: "https://apify.com/dataspryva/hepsiburada-product-search-and-category-price"
---

# Hepsiburada Product Search & Category Price Scraper

Use this skill to fetch Hepsiburada data with the Apify Actor `dataspryva/hepsiburada-product-search-and-category-price` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `mode` | string, required | Choose keyword search, category browsing, or product lookup. |
| `searchQueries` | array | One or more product searches (mode=search). Each query is collected separately. |
| `sortBy` | string | Result order for search and category modes. |
| `minRating` | one of `3`, `4`, `4.5` | Only include products rated at or above this many stars. |
| `discountedOnly` | boolean | Keep only products Hepsiburada marks as advantageous or discounted. |
| `fastDeliveryOnly` | boolean | Keep only products with Hepsiburada's fast-delivery signal. |
| `officialSellersOnly` | boolean | Keep only products from authorized or official sellers. |
| `includeProductDetails` | boolean | Open each product page to add description, specifications, variants, stock count, seller rating, shipping cost, and return policy. One extra request per record. |
| `maximizeCoverage` | boolean | Split broad searches into price bands to go beyond the site's single-query result limit. |
| `maxItems` | integer | Maximum records per search query or category (1-2000). For product lookup it is the total across all URLs. |

Example `input.json` (the Actor's published prefill):

```json
{
  "mode": "search",
  "searchQueries": [
    "laptop"
  ],
  "sortBy": "recommended",
  "discountedOnly": false,
  "fastDeliveryOnly": false,
  "officialSellersOnly": false,
  "includeProductDetails": false,
  "maximizeCoverage": false,
  "maxItems": 3
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/dataspryva~hepsiburada-product-search-and-category-price/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/dataspryva~hepsiburada-product-search-and-category-price/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. The Actor does not publish an output schema, so inspect the first item before mapping fields.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.