{ "openapi": "3.0.1", "info": { "title": "Hepsiburada Scraper [$0.75/1K💰] | TR Prices, Sellers, Delivery", "description": "Scrape Hepsiburada.com product listings into structured rows - TRY price, old price, discount, rating, seller, buy-box rank, stock and the real per-product delivery promise and cut-off hour.", "version": "0.4", "x-build-id": "39g4uQGvNjGxdwVit" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~hepsiburada-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-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/ahmed_jasarevic~hepsiburada-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-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/ahmed_jasarevic~hepsiburada-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-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 queries", "type": "array", "description": "Keywords to search on hepsiburada.com (equivalent to https://www.hepsiburada.com/ara?q=...). Leave empty if you only want category URLs.", "items": { "type": "string" } }, "categoryUrls": { "title": "Category / listing URLs", "type": "array", "description": "Any Hepsiburada listing URL. Three forms are understood: (1) category pages, where only the numeric id (the `-c-` part) is used, e.g. https://www.hepsiburada.com/laptop-notebook-dizustu-bilgisayarlar-c-98 -> category 98; (2) SEO search landing pages such as https://www.hepsiburada.com/iphone-18-pro-max-iphone-ios-telefonlar-xc-60005202-t6896, where `-xc-60005202` is the resolved category and the leading slug becomes the `q` filter, so you get exactly the filtered listing; (3) https://www.hepsiburada.com/ara?q=iphone -> keyword search.", "items": { "type": "string" } }, "maxProducts": { "title": "Max products", "type": "integer", "description": "How many products to collect in total, across all queries and categories. The run keeps paging until it reaches this number. Each listing page holds 24 products, so the actor automatically extends past maxPagesPerList when the listings have more to give. Non-paying accounts are limited to 10 products per run.", "default": 100 }, "maxPagesPerList": { "title": "Max pages per search / category", "type": "integer", "description": "Starting number of listing pages per search query or category. This is a starting depth, not a limit: the actor keeps paging beyond it while the listing reports more products and maxProducts is still unmet, up to 50 pages. Raise it only to fetch deeper listings faster.", "default": 3 }, "sort": { "title": "Sort", "enum": [ "", "artanfiyat", "azalanfiyat", "coksatan", "yorumsayisi", "degerlendirmepuani", "indirimurunler", "enyeni" ], "type": "string", "description": "Optional Hepsiburada storefront sort key (search pages only)." }, "includeOutOfStock": { "title": "Include out-of-stock products", "type": "boolean", "description": "When false, products that cannot be added to the cart (sold out) are skipped.", "default": true }, "includeDeliveryInfo": { "title": "Include delivery information", "type": "boolean", "description": "Adds estimated delivery data per product: delivery date, \"Yarin Kargoda\"-style text, the order cut-off hour, per-merchant delivery options and courier id. Adds one extra batched request per listing page, so turning it off roughly halves the request count.", "default": true }, "imageSize": { "title": "Image size", "type": "string", "description": "Size segment for product image URLs, e.g. `500-500` or `424-600`.", "default": "500-500" }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your crawler." } } }, "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 } } } } } } } } } }