{ "openapi": "3.0.1", "info": { "title": "Skroutz Scraper - Greek Price Comparison & Product Prices", "description": "Search Skroutz or paste a category URL and get one row per Greek product: title, the lowest price across every shop Skroutz compares, currency, rating, review count, image and a stable SKU id. Up to 600 products per run. For price monitoring, assortment research and Greek market analysis.", "version": "0.3", "x-build-id": "nmnTTbEvwSvHKQBbm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~skroutz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-skroutz-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/s-r~skroutz-scraper/runs": { "post": { "operationId": "runs-sync-s-r-skroutz-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/s-r~skroutz-scraper/run-sync": { "post": { "operationId": "run-sync-s-r-skroutz-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": { "query": { "title": "Query", "type": "string", "description": "What to search for on skroutz.gr. Greek and English terms both work. A search returns one page of about 52 products; use a category URL to go deeper." }, "url": { "title": "Url", "type": "string", "description": "A Skroutz category URL such as https://www.skroutz.gr/c/40/laptop.html, or any absolute/partial URL resolved against https://www.skroutz.gr. When set it wins over query. Only /c// URLs paginate." }, "sort": { "title": "Sort", "enum": [ "relevance", "popularity", "newest" ], "type": "string", "description": "Skroutz's own ordering: relevance (default), popularity or newest. Accepts any JSON value like the original actor (str(x or \"relevance\")): falsy and unknown values fall back to relevance. Sorting by price is deliberately not offered: that ordering makes the site return a payload with the prices stripped out.", "default": "relevance" }, "limit": { "title": "Limit", "minimum": 1, "maximum": 600, "type": "integer", "description": "How many products to return. Accepts integers, numbers and numeric strings like the original actor (int(x or 52), clamped 1-600); 0 or empty falls back to 52. A page carries about 48-52. A search caps at one page; a category URL pages further.", "default": 52 }, "use_proxy": { "title": "Use proxy", "type": "boolean", "description": "Off by default: Skroutz is reachable from the platform's own egress with the right request shape. Turn it on only if runs start getting blocked. Accepts any JSON value like the original actor (bool(x)): 0, empty string, false, [] and {} stay off; 1, \"true\" and \"false\" turn it on because Python treats non-empty strings as true.", "default": false }, "retries": { "title": "Retries", "minimum": 2, "maximum": 12, "type": "integer", "description": "Attempts per page. Accepts integers, numbers and numeric strings like the original actor (int(x or 6), clamped 2-12); 0 or empty falls back to 6. Each attempt climbs to the next header combination. Success is scored on the product list arriving, never on HTTP 200 alone. Budgeted in wall-clock inside one request; leftover attempts resume via the cursor.", "default": 6 }, "cursor": { "title": "Cursor", "type": "string", "description": "Opaque continuation returned as next_cursor; keep the same query/url and sort. Omit for the first request." } } }, "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 } } } } } } } } } }