{ "openapi": "3.0.1", "info": { "title": "Prom.ua Product Search Scraper", "description": "Scrape Prom.ua search results without a browser or proxy. Each product returns URL, title, regular and discounted price in UAH, image, seller name, seller store URL, stock status and search rank. Sort by price, filter by price range or review quality. $2.00 per 1,000 products.", "version": "0.0", "x-build-id": "iDQ2QkkntvCJahsnl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xmolodtsov~prom-ua/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xmolodtsov-prom-ua", "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/xmolodtsov~prom-ua/runs": { "post": { "operationId": "runs-sync-xmolodtsov-prom-ua", "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/xmolodtsov~prom-ua/run-sync": { "post": { "operationId": "run-sync-xmolodtsov-prom-ua", "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", "required": [ "search_term" ], "properties": { "search_term": { "title": "Search Term", "minLength": 1, "maxLength": 100, "type": "string", "description": "The keyword to search for on Prom.ua. Ukrainian/Cyrillic or English both work (e.g. 'ноутбуки', 'жіночі сумки', 'laptop', 'smartphone'). One search term per run — start a separate run for each additional keyword.", "default": "ноутбуки" }, "max_items": { "title": "Maximum Items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many products to collect for this search term. Pagination is automatic; 1000 is the maximum per run. You are billed per product returned.", "default": 10 }, "sort_option": { "title": "Sort Option", "enum": [ "default", "price_asc", "price_desc", "relevance" ], "type": "string", "description": "Sort order applied by Prom.ua across the whole result set before products are collected — not a client-side re-sort of one page.", "default": "default" }, "min_price": { "title": "Minimum Price (UAH)", "minimum": 0, "type": "integer", "description": "Minimum price in Ukrainian hryvnia. Applied by Prom.ua as a server-side filter; leave empty for no lower bound." }, "max_price": { "title": "Maximum Price (UAH)", "minimum": 0, "type": "integer", "description": "Maximum price in Ukrainian hryvnia. Applied by Prom.ua as a server-side filter; leave empty for no upper bound." }, "use_apify_proxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Optional and normally unnecessary — Prom.ua is scraped over plain HTTP and is verified working without a proxy. Enable only if you specifically want requests routed through Apify Proxy.", "default": false }, "media_only": { "title": "Products with Media Only", "type": "boolean", "description": "Only return products whose customer reviews include photos or videos. This is a narrow filter — it can legitimately return few or zero products.", "default": false }, "good_ratings_only": { "title": "Good Ratings Only", "type": "boolean", "description": "Only return products rated 4 stars and above. If 'Products with Media Only' is also enabled, that filter takes priority.", "default": false }, "debug_mode": { "title": "Debug Mode", "type": "boolean", "description": "Verbose logging for troubleshooting extraction and position validation. Leave off for normal runs.", "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 } } }, "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 } } } } } } } } } }