{
  "openapi": "3.0.1",
  "info": {
    "title": "Hepsiburada Scraper - Products, Prices, Sellers & Reviews",
    "description": "Scrape Hepsiburada (Turkey) products from searches, categories, brands, seller stores, links or SKUs: price, 30-day lowest price, rating, seller, stock. Optional barcode, specs, all sellers' offers, reviews, Q&A and seller profiles (MERSIS). Monitor mode. $0.67 per 1,000 products.",
    "version": "0.1",
    "x-build-id": "Dzu9VCqvDJ0ypIapi"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~hepsiburada-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-hepsiburada-scraper",
        "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/topapi~hepsiburada-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-hepsiburada-scraper",
        "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/topapi~hepsiburada-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-hepsiburada-scraper",
        "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",
        "properties": {
          "searchQueries": {
            "title": "Search terms",
            "type": "array",
            "description": "Words to search on Hepsiburada, one search each, in Turkish or English (e.g. airfryer, iphone 15, bebek bezi). Every search is read in Hepsiburada's own order, page after page.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Hepsiburada links",
            "type": "array",
            "description": "Any hepsiburada.com link: a search (https://www.hepsiburada.com/ara?q=...), a category (...-c-22017), a brand or collection page (...-xc-22017-b8058, ...-x-s63353), a seller store (https://www.hepsiburada.com/magaza/<store>: all its products), a seller profile (.../magaza/<store>?tab=profile: one seller row) or a product page (...-p-HBCV... or ...-pm-HBC...). Filters and sort already in a link are kept.",
            "items": {
              "type": "string"
            }
          },
          "productIds": {
            "title": "Product ids",
            "type": "array",
            "description": "Hepsiburada SKUs (HBCV..., the id at the end of a product link) or product ids (HBC...). Each one is read from its product page and delivered with its details.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Maximum products (total)",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many product rows across all searches and links (reviews, questions and seller rows are not counted here). 0 = no limit. Hepsiburada shows 49 pages (1,764 products) of one listing; above that the run reads further by splitting Hepsiburada's own price filter.",
            "default": 100
          },
          "maxItemsPerSource": {
            "title": "Maximum products per search or link",
            "minimum": 0,
            "type": "integer",
            "description": "Stop each search or link after this many products. 0 or empty = no limit per source."
          },
          "sort": {
            "title": "Sort",
            "enum": [
              "relevance",
              "price_asc",
              "price_desc",
              "best_selling",
              "most_reviewed",
              "top_rated",
              "biggest_discount",
              "newest"
            ],
            "type": "string",
            "description": "Hepsiburada's own sort for searches and listing pages. A limit keeps the first products in this order.",
            "default": "relevance"
          },
          "minPrice": {
            "title": "Minimum price (TL)",
            "minimum": 0,
            "type": "integer",
            "description": "Only products at this price or more (Hepsiburada's own price filter)."
          },
          "maxPrice": {
            "title": "Maximum price (TL)",
            "minimum": 0,
            "type": "integer",
            "description": "Only products at this price or less (Hepsiburada's own price filter)."
          },
          "minRating": {
            "title": "Minimum rating",
            "enum": [
              "1",
              "2",
              "3",
              "4",
              "4.5"
            ],
            "type": "string",
            "description": "Only products rated at least this many stars."
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Only these brands (e.g. Philips, Xiaomi). Several brands are combined: a product of any of them matches.",
            "items": {
              "type": "string"
            }
          },
          "sellerNames": {
            "title": "Sellers",
            "type": "array",
            "description": "Only products sold by these stores, written as Hepsiburada shows the store name (e.g. Hepsiburada, Teknosa). For every product of one store, give its store link under Hepsiburada links instead.",
            "items": {
              "type": "string"
            }
          },
          "officialSellersOnly": {
            "title": "Authorized / official sellers only",
            "type": "boolean",
            "description": "Only products sold by authorized dealers or official brand stores (Yetkili / Resmi Satıcılar).",
            "default": false
          },
          "fastDeliveryOnly": {
            "title": "Fast delivery only",
            "type": "boolean",
            "description": "Only products with Hepsiburada's fast delivery (Hızlı Teslimat).",
            "default": false
          },
          "couponProductsOnly": {
            "title": "Products with a coupon only",
            "type": "boolean",
            "description": "Only products that carry a coupon (Kuponlu Ürünler).",
            "default": false
          },
          "womenEntrepreneurOnly": {
            "title": "Women entrepreneur products only",
            "type": "boolean",
            "description": "Only products from Hepsiburada's women entrepreneur program (Girişimci Kadınlar).",
            "default": false
          },
          "withPhotoReviewsOnly": {
            "title": "Products with photo reviews only",
            "type": "boolean",
            "description": "Only products with at least one customer review with a photo.",
            "default": false
          },
          "advantageProductsOnly": {
            "title": "Advantage-price products only",
            "type": "boolean",
            "description": "Only products in Hepsiburada's advantage-price selection (Avantajlı Ürünler).",
            "default": false
          },
          "onlyDiscounted": {
            "title": "Discounted products only",
            "type": "boolean",
            "description": "Keep only products priced below their list price. Combine with the Biggest discount sort to read the deepest discounts first.",
            "default": false
          },
          "minDiscountPercent": {
            "title": "Minimum discount (%)",
            "minimum": 0,
            "maximum": 99,
            "type": "integer",
            "description": "Keep only products discounted by at least this percentage."
          },
          "minReviews": {
            "title": "Minimum reviews",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only products with at least this many customer reviews."
          },
          "inStockOnly": {
            "title": "In stock only",
            "type": "boolean",
            "description": "Leave out products that cannot be added to the basket.",
            "default": false
          },
          "skipSponsored": {
            "title": "Leave out sponsored products",
            "type": "boolean",
            "description": "Leave out sponsored (ad) cards.",
            "default": false
          },
          "maxShipmentDays": {
            "title": "Ships within (days)",
            "minimum": 0,
            "maximum": 30,
            "type": "integer",
            "description": "Keep only products the seller ships within this many days (0 = same day)."
          },
          "includeDetails": {
            "title": "Product details",
            "type": "boolean",
            "description": "Open each product's page: barcode(s), description, specifications, full category path, every seller's offer (price, seller rating, city, shipping), the featured seller's city and rating, the rating breakdown per star, Hepsiburada's AI review summary, question count, videos. Charged per product with details (product links and ids always carry them).",
            "default": false
          },
          "includeDelivery": {
            "title": "Delivery estimate",
            "type": "boolean",
            "description": "Add Hepsiburada's own delivery estimate to each product: the date it expects the order to be handed to the courier, the estimate texts, the order cut-off time, the courier, next-day delivery and every delivery option (one extra request per 50 products, no extra charge).",
            "default": false
          },
          "includeReviews": {
            "title": "Customer reviews",
            "type": "boolean",
            "description": "Deliver each product's customer reviews as review rows (text, stars, reviewer, verified purchase, date, likes, seller bought from, photos). Charged per review.",
            "default": false
          },
          "maxReviewsPerProduct": {
            "title": "Maximum reviews per product",
            "minimum": 0,
            "type": "integer",
            "description": "Reviews per product. 0 = all of them.",
            "default": 20
          },
          "reviewSort": {
            "title": "Review order",
            "enum": [
              "most_helpful",
              "newest",
              "oldest",
              "highest_rating",
              "lowest_rating"
            ],
            "type": "string",
            "description": "Order the reviews are read in (the limit keeps the first ones).",
            "default": "most_helpful"
          },
          "reviewStars": {
            "title": "Only reviews with these stars",
            "type": "array",
            "description": "Only reviews with these star ratings (e.g. 1 and 2 for complaints). Empty = every rating.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5"
              ],
              "enumTitles": [
                "1 star",
                "2 stars",
                "3 stars",
                "4 stars",
                "5 stars"
              ]
            }
          },
          "reviewsWithMediaOnly": {
            "title": "Only reviews with photos or video",
            "type": "boolean",
            "description": "Only reviews the reviewer added photos or a video to.",
            "default": false
          },
          "includeQuestions": {
            "title": "Questions & answers",
            "type": "boolean",
            "description": "Deliver each product's published customer questions with the sellers' answers as question rows. Charged per question.",
            "default": false
          },
          "maxQuestionsPerProduct": {
            "title": "Maximum questions per product",
            "minimum": 0,
            "type": "integer",
            "description": "Questions per product. 0 = all of them.",
            "default": 20
          },
          "questionSort": {
            "title": "Question order",
            "enum": [
              "newest",
              "most_helpful"
            ],
            "type": "string",
            "description": "Newest answered first (the product page's own order; monitor mode reads only questions answered since the last run) or Hepsiburada's most helpful first.",
            "default": "newest"
          },
          "includeSellerProfiles": {
            "title": "Seller profiles",
            "type": "boolean",
            "description": "Deliver one seller row for each seller of the delivered products: store name, trade name, MERSIS number, tax number (when published), head-office place, rating, followers, product count, answer and dispatch times, time on Hepsiburada. Charged per seller.",
            "default": false
          },
          "monitorMode": {
            "title": "Monitor mode",
            "type": "boolean",
            "description": "Deliver only products not delivered by an earlier run with the same input, products whose price or stock changed (changeType changed, with the previous price) and new reviews / questions / sellers. The limits then count the products watched (the first N of each listing): a poll with nothing new delivers and charges nothing.",
            "default": false
          },
          "monitorKey": {
            "title": "Monitor name",
            "type": "string",
            "description": "Runs with the same name and the same input share one memory. Use a different name for each watch."
          },
          "trackPriceChanges": {
            "title": "Deliver price and stock changes",
            "type": "boolean",
            "description": "In monitor mode, deliver a known product again when its price or stock changed. Off = new products only.",
            "default": true
          },
          "minPriceChangePercent": {
            "title": "Minimum price change (%)",
            "minimum": 0,
            "type": "integer",
            "description": "In monitor mode, ignore price moves smaller than this percentage.",
            "default": 0
          },
          "priceDropsOnly": {
            "title": "Price drops only",
            "type": "boolean",
            "description": "In monitor mode, deliver a known product again only when its price went down (rises and stock changes are not delivered).",
            "default": false
          },
          "reportRemoved": {
            "title": "Report removed products",
            "type": "boolean",
            "description": "In monitor mode, add a free row (type removed, billed false) for a watched product whose page is gone or that is missing from a fully read listing two runs in a row.",
            "default": true
          },
          "resetMonitor": {
            "title": "Reset the monitor memory",
            "type": "boolean",
            "description": "Forget what earlier runs delivered (the next run delivers everything again).",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. The run connects directly and moves to Apify datacenter, then Turkish residential proxies by itself if Hepsiburada refuses a connection. Set your own proxy here only if you need to.",
            "default": {
              "useApifyProxy": false
            }
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Requests in flight at once (default 4 at 256 MB, 6 at 512 MB)."
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}