{ "openapi": "3.0.1", "info": { "title": "Allegro Deals Scraper: Discounts, Price Drops & 30-Day Lows", "description": "Scrape Allegro.pl deals zone (Strefa Okazji) by department, deal list or keyword. Get price, discount %, the lowest price of the last 30 days, Smart! and best-price-guarantee flags. Monitor mode saves only new deals and price drops. No login.", "version": "0.0", "x-build-id": "pATTTWI8ZE7Zf4Trw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/epicscrapers~allegro-deals-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-epicscrapers-allegro-deals-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/epicscrapers~allegro-deals-scraper/runs": { "post": { "operationId": "runs-sync-epicscrapers-allegro-deals-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/epicscrapers~allegro-deals-scraper/run-sync": { "post": { "operationId": "run-sync-epicscrapers-allegro-deals-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": { "departments": { "title": "Departments", "type": "array", "description": "Deals-zone (Strefa Okazji) departments to scrape, by alias. Leave empty for all deals. Current aliases (October 2026): elektronika, moda, dziecko, motoryzacja, dom-i-ogrod, supermarket, kultura-i-rozrywka, sport-i-turystyka, zdrowie, uroda, kolekcje-i-sztuka, firma-i-uslugi. A URL such as https://allegro.pl/strefa-okazji/elektronika also works.", "items": { "type": "string" } }, "tags": { "title": "Deal lists (tags)", "type": "array", "description": "Themed deal lists, by alias. Leave empty for the default list. Tags change with Allegro's campaigns; in October 2026 they were: bestsellers, smart-deals (Tylko w Smart!), best-price-guarantee (Gwarancja najniższej ceny), get-cashback-with-klik, autumn-discounts, ready-for-fall, app-only (Tylko w apce, some departments), and in motoryzacja tires-at-low-prices plus tire sizes such as tires-205-55-r16. A tag that doesn't exist in a department is skipped with a warning.", "items": { "type": "string" } }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "Search inside the deals zone, one keyword per entry (e.g. iphone, lego). Combined with every department and tag above. Leave empty to browse deals without a keyword.", "items": { "type": "string" } }, "maxItems": { "title": "Max offers per source", "minimum": 0, "type": "integer", "description": "Maximum offers saved for each combination of department, tag, keyword and category. In monitoring mode this is the number of offers checked per source (only new or changed ones are saved). Set to 0 for no limit. The all-deals feed ends after about 500 to 1,000 offers; department and keyword feeds go past 1,600.", "default": 100 }, "minPrice": { "title": "Min price (PLN)", "minimum": 0, "type": "integer", "description": "Only offers at or above this price in Polish złoty. Allegro filters on the PLN price even when you choose another currency." }, "maxPrice": { "title": "Max price (PLN)", "minimum": 0, "type": "integer", "description": "Only offers at or below this price in Polish złoty. Allegro filters on the PLN price even when you choose another currency." }, "minDiscountPercent": { "title": "Min discount %", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only save offers with at least this discount against the lowest price of the last 30 days. Most deals-zone offers have no discount badge, so a value above 0 scans more pages to fill the limit. 0 keeps all offers.", "default": 0 }, "categoryIds": { "title": "Category IDs", "type": "array", "description": "Only offers in these Allegro category IDs (the number at the end of a category URL, e.g. 165 for smartphones in https://allegro.pl/kategoria/smartfony-i-telefony-komorkowe-165).", "items": { "type": "string" } }, "deliveryTime": { "title": "Delivery time", "enum": [ "", "delivery_today", "delivery_tomorrow", "delivery_day_after_tomorrow", "delivery_in_three_working_days" ], "type": "string", "description": "Only offers delivered within this time.", "default": "" }, "deliveryOptions": { "title": "Delivery options", "type": "array", "description": "Only offers with these delivery benefits: Allegro Smart!, free delivery, free returns.", "items": { "type": "string", "enum": [ "allegro-smart-standard", "freeShipping", "freeReturn" ], "enumTitles": [ "Allegro Smart!", "Free delivery", "Free returns" ] } }, "shippingFrom": { "title": "Ships from", "type": "array", "description": "Only offers shipped from these places.", "items": { "type": "string", "enum": [ "pl", "cz", "sk", "hu", "us", "cn", "other-in-eu", "allegro-warehouse" ], "enumTitles": [ "Poland", "Czechia", "Slovakia", "Hungary", "USA", "China", "Other EU countries", "Allegro warehouse" ] } }, "marketplace": { "title": "Marketplace", "enum": [ "allegro-pl", "allegro-cz", "allegro-sk", "allegro-hu" ], "type": "string", "description": "Allegro marketplace. The deals are the same; titles and labels come in the marketplace's language (Allegro's own translations) and prices in its currency unless you choose one below.", "default": "allegro-pl" }, "currency": { "title": "Currency", "enum": [ "", "PLN", "EUR", "CZK", "HUF" ], "type": "string", "description": "Currency of all prices. Leave empty for the marketplace's currency.", "default": "" }, "shippingCountry": { "title": "Delivery country", "pattern": "^([A-Za-z]{2})?$", "type": "string", "description": "2-letter country code used for delivery estimates (e.g. DE). Leave empty for the marketplace's country." }, "onlyNewOrChanged": { "title": "Only new or changed offers", "type": "boolean", "description": "Save only offers that are new since the last run with the same monitor key, or whose price changed. Rows get changeType (new, price_drop, price_increase), previousPrice and priceChange. Schedule the actor to get a feed of fresh deals and price drops; you pay only for those rows.", "default": false }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Name of the saved price history (stored in your key-value store \"allegro-deals-monitor\"). Use a different key for each monitored setup. Setting a key without the option above adds changeType, previousPrice and priceChange to every row." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Allegro blocks datacenter IPs. Residential proxies in Poland work best and are the default.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PL" } } } }, "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 } } } } } } } } } }