{ "openapi": "3.0.1", "info": { "title": "Allegro.pl Scraper - products, prices, sellers", "description": "Search allegro.pl by keyword and get every offer as a row: title, PLN price, price with delivery, seller login and rating, Super Seller, Smart! and lowest-price badges, parameters and offer link. Price, condition, delivery and sort filters run on the site itself and are checked against the page.", "version": "0.1", "x-build-id": "uZzITFPTLsVgUw8xA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reventadata~allegro-pl-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reventadata-allegro-pl-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/reventadata~allegro-pl-scraper/runs": { "post": { "operationId": "runs-sync-reventadata-allegro-pl-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/reventadata~allegro-pl-scraper/run-sync": { "post": { "operationId": "run-sync-reventadata-allegro-pl-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", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Search terms to look up on allegro.pl, one search per term. Any category, any language the site understands (Polish or English product names work).", "items": { "type": "string" } }, "maxItems": { "title": "Maximum items", "minimum": 1, "type": "integer", "description": "Maximum number of products to save across all search terms. A page holds about 60-70 distinct products and the site serves at most 100 pages per search.", "default": 100 }, "minPrice": { "title": "Minimum price (PLN)", "minimum": 0, "type": "integer", "description": "Only products priced at or above this amount in Polish zloty. Leave empty for no lower limit. 0 is a real value." }, "maxPrice": { "title": "Maximum price (PLN)", "minimum": 0, "type": "integer", "description": "Only products priced at or below this amount in Polish zloty. Leave empty for no upper limit." }, "condition": { "title": "Condition", "enum": [ "any", "new", "used" ], "type": "string", "description": "Filter by the condition the site records for the offer: new (nowe) or used (używane). 'any' sends no condition filter.", "default": "any" }, "freeDelivery": { "title": "Free delivery only", "type": "boolean", "description": "Only offers on the site's own 'darmowa dostawa' (free delivery) filter.", "default": false }, "smartOnly": { "title": "Allegro Smart! only", "type": "boolean", "description": "Only offers on the site's own 'Allegro Smart!' delivery-programme filter.", "default": false }, "superSellerOnly": { "title": "Super Seller only", "type": "boolean", "description": "Only offers from sellers carrying Allegro's Super Sprzedawca badge (its own filter).", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "price-asc", "price-desc" ], "type": "string", "description": "Order of the results: the site's relevance order, price from low to high, or price from high to low.", "default": "relevance" }, "includeKeywords": { "title": "Title must contain", "type": "array", "description": "Keep only products whose title (or seller name) contains every one of these words, ignoring case and accents. Allegro's search is fuzzy and can return products that do not contain your term; this removes them.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Title must not contain", "type": "array", "description": "Drop products whose title (or seller name) contains any of these words, ignoring case and accents. Useful to remove cases, glass and accessories from a phone search.", "items": { "type": "string" } }, "includeSponsored": { "title": "Include sponsored listings", "type": "boolean", "description": "Allegro mixes paid 'Sponsorowane' placements into the results. Turn off to drop them; an offer that appears both sponsored and organic is saved once either way.", "default": true } } }, "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 } } } } } } } } } }