{ "openapi": "3.0.1", "info": { "title": "Empik Scraper — Polish Books, Prices & Sellers", "description": "Scrape empik.com products by keyword, category, bestseller list or URL. Price, discount, 30-day lowest price, seller, stock, delivery, rating, categories, plus descriptions, images, publisher and release date. Price-change tracking.", "version": "0.0", "x-build-id": "9R358X6o3A6Y2IXmb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~empik-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-empik-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/unfenced-group~empik-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-empik-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/unfenced-group~empik-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-empik-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 empik.com for, exactly as in the site's search box. One search per line, for example \"harry potter\", \"lego\" or \"remigiusz mróz\". Barcode (ISBN/EAN) searches are blocked by empik.com and skipped. Leave empty when you only use Start URLs.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Empik.com pages to scrape: search results (https://www.empik.com/szukaj/produkt?q=wiedzmin), category pages (https://www.empik.com/ksiazki/fantastyka,3179,s), bestseller lists (https://www.empik.com/bestsellery/ksiazki) or product pages (one full record each). Sorting and filter parameters in a URL are ignored.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Maximum number of products to return across all queries, URLs and codes, for example 500. Set to 0 for no limit.", "default": 100 }, "fetchDetails": { "title": "Fetch product details", "type": "boolean", "description": "Open every product page to add the full description, all gallery images and videos, the full category tree with IDs, rating count, series, publisher, producer, director, performer, release date and product type. Slower and billed at the detailed rate. Product page URLs in Start URLs are always fetched in full.", "default": false }, "sellerType": { "title": "Seller", "enum": [ "all", "empik", "marketplace" ], "type": "string", "description": "Which offers to return: all (default), empik (only products sold by Empik itself) or marketplace (only products sold by third-party marketplace sellers).", "default": "all" }, "minPrice": { "title": "Minimum price (PLN)", "minimum": 0, "type": "integer", "description": "Only return products priced at or above this amount in złoty, for example 20. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum price (PLN)", "minimum": 0, "type": "integer", "description": "Only return products priced at or below this amount in złoty, for example 100. Leave empty for no maximum." }, "onlyDiscounted": { "title": "Only discounted products", "type": "boolean", "description": "Only return products currently priced below their regular or publisher's suggested price.", "default": false }, "inStockOnly": { "title": "Only products available to order", "type": "boolean", "description": "Skip products that are sold out or waiting for a restock. Pre-orders are kept.", "default": false }, "skipSponsored": { "title": "Skip sponsored products", "type": "boolean", "description": "Leave out paid advertisement tiles that empik.com mixes into search and category results. Turn off to keep them; they are flagged with isSponsored.", "default": true }, "splitLargeCategories": { "title": "Split large categories", "type": "boolean", "description": "empik.com lists at most 4,800 products per page sequence. When a category is larger, crawl its subcategories instead so you can reach the full assortment.", "default": true }, "onlyChanges": { "title": "Only new products and price changes", "type": "boolean", "description": "Return only products that are new since your previous run or whose price changed. Use it for a daily price-monitoring feed; every row also carries previousPrice and changeStatus.", "default": 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 } } } } } } } } } }