{ "openapi": "3.0.1", "info": { "title": "Allegro Product Scraper – Prices, Sellers, EAN & Stock", "description": "NEW 2.0: up to 8Γ— cheaper and faster. Scrape Allegro.pl, .cz and .sk: search, categories, seller shops, offers and EAN codes. Prices, discounts, sellers, popularity, EAN, stock, specs, reviews. All sellers per EAN, hidden discounts, price monitoring.", "version": "1.1", "x-build-id": "jXLfTNtAeyJUnNXmT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/liveclaude~allegro-seller-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-liveclaude-allegro-seller-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/liveclaude~allegro-seller-scraper/runs": { "post": { "operationId": "runs-sync-liveclaude-allegro-seller-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/liveclaude~allegro-seller-scraper/run-sync": { "post": { "operationId": "run-sync-liveclaude-allegro-seller-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": { "marketplace": { "title": "🌍 Marketplace", "enum": [ "pl", "cz", "sk" ], "type": "string", "description": "Which Allegro site to use for search phrases and EAN codes. URLs are detected automatically.", "default": "pl" }, "searchQueries": { "title": "πŸ”Ž Search phrases", "type": "array", "description": "Search Allegro like a buyer, e.g. `iphone 15`, `ekspres do kawy`, `lego technic`.", "items": { "type": "string" } }, "startUrls": { "title": "πŸ”— Allegro URLs", "type": "array", "description": "Any Allegro URL – category (`/kategoria/...`), search (`/listing?string=...`), seller shop (`/uzytkownik/...`), single offer (`/oferta/...`) or product (`/produkt/...` β†’ all sellers). Filters in the URL are kept.", "items": { "type": "string" } }, "eans": { "title": "🏷️ EAN / GTIN codes", "type": "array", "description": "Find a product by barcode and get ALL sellers and their prices, e.g. `5449000000996`.", "items": { "type": "string" } }, "maxItemsPerInput": { "title": "Max. offers per input", "minimum": 1, "type": "integer", "description": "Maximum offers per search phrase, URL or EAN. Allegro shows up to 6,000 results per search.", "default": 100 }, "deepPagination": { "title": "Go beyond 6,000 results", "type": "boolean", "description": "Allegro shows max. 100 pages (6,000 offers) per search. When you ask for more, the scraper automatically splits the search into price ranges to reach the whole category.", "default": true }, "scrapeDetails": { "title": "πŸ“„ Full offer details (EAN, stock, description, all parameters)", "type": "boolean", "description": "Opens every offer page: EAN/GTIN, manufacturer code, brand, stock, units sold in 30 days, condition, full parameter table, description, all photos, warranty, returns, category path. Without it you get the fast listing data (price, seller, delivery, popularity, key parameters).", "default": false }, "includeDescription": { "title": "Include description", "type": "boolean", "description": "With full details: include description text, HTML and description images.", "default": true }, "descriptionFormat": { "title": "Description format", "enum": [ "both", "text", "html" ], "type": "string", "description": "Format of the offer description (with full details).", "default": "both" }, "sellerCompanyDetails": { "title": "Seller company data (name, NIP, KRS, address)", "type": "boolean", "description": "With full details: the business seller's legal name, tax ID (NIP), KRS and registered address as published on Allegro.", "default": false }, "downloadImages": { "title": "Download image files", "type": "boolean", "description": "Save offer photos as files (key-value store) and return their download links in imageFiles. Charged per image.", "default": false }, "maxImages": { "title": "Max. images per offer", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many photos to download per offer.", "default": 5 }, "allSellersForProducts": { "title": "All sellers for products & EANs", "type": "boolean", "description": "For EAN codes and product URLs return every seller's offer for that product (price comparison), ranked.", "default": true }, "maxOffersPerProduct": { "title": "Max. sellers per product", "minimum": 1, "type": "integer", "description": "Limit of seller offers returned per EAN / product.", "default": 50 }, "outputFormat": { "title": "Output format", "enum": [ "offers", "products" ], "type": "string", "description": "For EAN codes and product URLs: flat offer rows, or one record per product with offers[], lowest/highest/average price and hidden-discount totals.", "default": "offers" }, "minPrice": { "title": "πŸ’° Min. price (PLN)", "minimum": 0, "type": "integer", "description": "Only offers from this price." }, "maxPrice": { "title": "Max. price (PLN)", "minimum": 0, "type": "integer", "description": "Only offers up to this price." }, "condition": { "title": "Condition", "enum": [ "all", "new", "used" ], "type": "string", "description": "Item condition.", "default": "all" }, "sortOrder": { "title": "Sort by", "enum": [ "relevance", "price_asc", "price_desc", "price_delivery_asc", "popularity", "newest" ], "type": "string", "description": "Order of results.", "default": "relevance" }, "smartOnly": { "title": "Only Allegro Smart! offers", "type": "boolean", "description": "Skip offers without Smart! delivery.", "default": false }, "includePromoted": { "title": "Include promoted (sponsored) offers", "type": "boolean", "description": "Turn off to keep organic results only.", "default": true }, "detectHiddenDiscounts": { "title": "πŸ† Detect hidden Allegro discounts (Lowest Price Guarantee)", "type": "boolean", "description": "For offers with the 'Gwarancja najniΕΌszej ceny' badge, reveal the price the seller really set and how much Allegro silently discounts (realSellerPrice, hiddenDiscount). Charged per checked offer.", "default": false }, "onlyChanges": { "title": "πŸ”” Only new offers & price changes (monitoring)", "type": "boolean", "description": "Schedule the run – each run returns only new offers and offers whose price changed since the previous run (with previousPrice and priceChange). Unchanged offers are not charged.", "default": false }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Name for this monitor, e.g. `competitors-iphone`. Use different IDs for different watch lists." }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Parallel page requests.", "default": 20 } } }, "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 } } } } } } } } } }