{ "openapi": "3.0.1", "info": { "title": "Hepsiburada Scraper: Ürün Fiyat Takibi, İndirim & Satıcı Verisi", "description": "Hepsiburada ürün scraper: collect products by keyword, brand, seller or pasted link with price, list price, discount, rating, seller and delivery. Deal finder, price-drop and new-product monitor, results beyond the 1,760 search cap, optional barcode, specs and all seller offers. JSON, CSV, Excel.", "version": "0.1", "x-build-id": "1ipLvKZOwTSd295tK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~hepsiburada-products-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-hepsiburada-products-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/getascraper~hepsiburada-products-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-hepsiburada-products-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/getascraper~hepsiburada-products-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-hepsiburada-products-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 keywords", "type": "array", "description": "Product keywords to search on Hepsiburada, one per line, in Turkish or English (for example kulaklık, laptop, bebek bezi). Each keyword is collected separately and every row says which keyword found it.", "default": [ "kulaklık" ], "items": { "type": "string" } }, "startUrls": { "title": "Hepsiburada page links", "type": "array", "description": "Paste Hepsiburada search results, category pages (…-c-12345), brand pages or single product pages (…-p-HBCV…). Your filters and sort order below are applied on top of listing pages. Product page links return that product directly.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "price_asc", "price_desc", "best_selling", "most_reviewed", "top_rated", "biggest_discount", "newest" ], "type": "string", "description": "Order in which Hepsiburada lists the results before the result limit is applied. Choose price low to high to find the cheapest offers, or biggest discount to find deals first.", "default": "relevance" }, "minPrice": { "title": "Minimum price (TRY)", "minimum": 0, "maximum": 10000000, "type": "number", "description": "Only products priced at or above this amount in Turkish lira. Leave empty for no lower limit." }, "maxPrice": { "title": "Maximum price (TRY)", "minimum": 0, "maximum": 10000000, "type": "number", "description": "Only products priced at or below this amount in Turkish lira. Leave empty for no upper limit." }, "minRating": { "title": "Minimum rating", "enum": [ "any", "3", "4", "4.5" ], "type": "string", "description": "Only products whose customer rating is at least this many stars.", "default": "any" }, "brands": { "title": "Brands", "type": "array", "description": "Only these brands, one per line, for example JBL or Samsung. Several brands are combined, so a product from any of them matches.", "items": { "type": "string" } }, "sellers": { "title": "Sellers", "type": "array", "description": "Only products sold by these stores, one per line. Write the store name exactly as Hepsiburada shows it, for example Hepsiburada or a marketplace seller name. Useful to track what one seller lists or how their prices move.", "items": { "type": "string" } }, "officialSellersOnly": { "title": "Authorized or official sellers only", "type": "boolean", "description": "Keep only products sold by authorized dealers or official brand stores. Handy for avoiding grey-market and counterfeit-prone listings.", "default": false }, "couponProductsOnly": { "title": "Coupon products only", "type": "boolean", "description": "Keep only products that carry an extra coupon offer on Hepsiburada.", "default": false }, "womenEntrepreneurOnly": { "title": "Women entrepreneur products only", "type": "boolean", "description": "Keep only products from Hepsiburada's women entrepreneur program. Available in categories where the site offers this filter.", "default": false }, "withPhotoReviewsOnly": { "title": "Products with photo reviews only", "type": "boolean", "description": "Keep only products that have at least one customer review with a photo.", "default": false }, "onlyDiscounted": { "title": "Discounted products only", "type": "boolean", "description": "Keep only products that currently sell below their list price. Product list price and discount percentage are included in every row.", "default": false }, "minDiscountPercent": { "title": "Minimum discount (%)", "minimum": 0, "maximum": 95, "type": "integer", "description": "Keep only products discounted by at least this percentage off the list price. 0 means no minimum. Use it with Biggest discount sorting to surface real deals.", "default": 0 }, "minReviews": { "title": "Minimum number of reviews", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Keep only products with at least this many customer reviews, which filters out untested listings. 0 means no minimum.", "default": 0 }, "maxShipmentDays": { "title": "Dispatch time", "enum": [ "any", "0", "1", "2", "3" ], "type": "string", "description": "Keep only products the seller ships within this many days. Same day means the seller dispatches the order on the day it is placed.", "default": "any" }, "includeDetails": { "title": "Include full product details", "type": "boolean", "description": "Open each product page to add the barcode, full specifications, stock status, free shipping flag, every seller's offer with price and rating, color and size variants, all photos and the video. Slower and billed as an extra event per product, so leave it off when you only need prices and ratings.", "default": false }, "maxResults": { "title": "Maximum products", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Total number of products to collect across all keywords and links. The default keeps a first run fast; raise it for larger collections.", "default": 20 }, "splitToExceedLimit": { "title": "Go beyond the per-search limit", "type": "boolean", "description": "When a search matches more products than one search can serve (about 1,760), split it into price ranges and collect each range separately so you reach further. Only used when Maximum products is above that limit.", "default": false }, "monitorScope": { "title": "Monitor name", "type": "string", "description": "Give this watch a name (for example laptop-deals) to switch on monitoring. The Actor remembers the products and prices it delivered under this name and, on the next run with the same name, returns only what is new or cheaper. Leave empty to return everything every time. Schedule the run to track a market over time.", "default": "" }, "monitorMode": { "title": "What to report", "enum": [ "new_only", "price_drops", "any_price_change" ], "type": "string", "description": "New products only, new products plus price drops, or new products plus any price change up or down. Price changes are measured against the last price this monitor saw.", "default": "new_only" }, "minPriceChangePercent": { "title": "Smallest price change (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Ignore price moves smaller than this percentage, so rounding noise does not trigger alerts.", "default": 1 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Hepsiburada answers the Actor without a proxy, which keeps runs cheapest. If the site ever refuses, the Actor switches itself to a datacenter proxy and then to a Turkish residential proxy. Leave as is unless you need a specific proxy.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }