{ "openapi": "3.0.1", "info": { "title": "Allegro Scraper — Prices, Sellers, Specs & Reviews", "description": "Scrape Allegro.pl, .cz and .sk: keyword search, categories, seller catalogs and offer URLs. Prices, Smart!, stock, EAN, specs and reviews. HTTP Allegro API alternative — JSON via Python, Node.js, MCP.", "version": "0.1", "x-build-id": "ueE1Xj3POMYFNTCG3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawloop~allegro-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawloop-allegro-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/crawloop~allegro-scraper/runs": { "post": { "operationId": "runs-sync-crawloop-allegro-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/crawloop~allegro-scraper/run-sync": { "post": { "operationId": "run-sync-crawloop-allegro-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 keywords", "type": "array", "description": "Keywords or EAN/GTIN barcodes to search on Allegro (e.g. iphone 15, lego technic, 5901234123457).", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Allegro offer pages (/oferta/), search (/listing?string=), categories (/kategoria/), seller storefronts (/uzytkownik/), plus Czech/Slovak equivalents.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "eans": { "title": "EAN / GTIN barcodes", "type": "array", "description": "8–14 digit barcodes. Each code is searched and matched offers are saved (gtin filled automatically).", "items": { "type": "string" } }, "offerIds": { "title": "Offer IDs", "type": "array", "description": "Numeric Allegro offer IDs from /oferta/…-{id}.", "items": { "type": "string" } }, "sellerLogins": { "title": "Seller logins", "type": "array", "description": "Public seller storefront logins (the slug after /uzytkownik/).", "items": { "type": "string" } }, "marketplace": { "title": "Marketplace", "enum": [ "pl", "cz", "sk" ], "type": "string", "description": "Regional Allegro storefront. Start URLs override this when they already include a host.", "default": "pl" }, "sortBy": { "title": "Sort", "enum": [ "relevance", "price-asc", "price-desc", "newest", "popularity" ], "type": "string", "description": "Search / category sort order.", "default": "relevance" }, "minPrice": { "title": "Min price", "type": "number", "description": "Minimum price in the marketplace currency (PLN / CZK / EUR). Maps to Allegro price_from." }, "maxPrice": { "title": "Max price", "type": "number", "description": "Maximum price in the marketplace currency. Maps to Allegro price_to." }, "condition": { "title": "Condition", "enum": [ "all", "new", "used" ], "type": "string", "description": "Filter by item condition (stan).", "default": "all" }, "scrapeProductDetails": { "title": "Product details (deep mode)", "type": "boolean", "description": "Open each offer page for description, full spec table, stock, GTIN/EAN, warranty, return policy, rating and full-resolution images. One extra request per offer.", "default": false }, "scrapeReviews": { "title": "Customer reviews", "type": "boolean", "description": "Collect highlighted public reviews from the offer page (author, stars, text, date).", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per offer", "minimum": 1, "maximum": 200, "type": "integer", "description": "Cap on reviews when Customer reviews is on.", "default": 30 }, "includePromoted": { "title": "Include promoted / sponsored cards", "type": "boolean", "description": "Keep PROMOTED and sponsored listing cards (flagged on the row). Turn off to keep organic order only.", "default": true }, "scrapeAllSellers": { "title": "All sellers (product page)", "type": "boolean", "description": "When a catalog productId is found, also crawl /produkt/{id} (Wszystkie oferty) so every seller of that SKU is saved. Paste /produkt/ URLs to do this directly.", "default": false }, "barcodeQuickLookup": { "title": "EAN quick lookup", "type": "boolean", "description": "For pure EAN/GTIN searches, take the first matching offer and skip the detail page unless Product details is on.", "default": true }, "maxItems": { "title": "Max offers", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum offer rows across all queries and URLs.", "default": 50 }, "maxPagesPerQuery": { "title": "Max pages per query", "minimum": 0, "maximum": 100, "type": "integer", "description": "Allegro returns ~60 offers per page and caps around 100 pages. 0 = paginate until empty or Max offers.", "default": 20 }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Politeness delay between HTTP requests.", "default": 400 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy in the marketplace country is required. DataDome blocks most datacenter IPs." } } }, "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 } } } } } } } } } }