{ "openapi": "3.0.1", "info": { "title": "Scraper for Allegro — Product Listings, Prices & Offers", "description": "Scrape Allegro.pl product search results by keyword or listing URL. Extract offer IDs, names, prices in PLN, ratings, sellers, delivery info and images in bulk. No API key, no login.", "version": "1.1", "x-build-id": "GDbmdtimknnRZVneE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~allegro-pl-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-allegro-pl-product-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/logiover~allegro-pl-product-scraper/runs": { "post": { "operationId": "runs-sync-logiover-allegro-pl-product-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/logiover~allegro-pl-product-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-allegro-pl-product-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": { "mode": { "title": "Mode", "enum": [ "search", "category", "sold", "sellerItems", "productDetail" ], "type": "string", "description": "What to scrape.\n\n• **search** — search live listings by keyword (main, highest volume)\n• **category** — browse a category id or a pasted eBay category/search URL\n• **sold** — completed / SOLD listings (best for price & market research)\n• **sellerItems** — every active listing from one seller\n• **productDetail** — deep item-page details (item specifics, brand/MPN/UPC, quantity, returns) for one or many item URLs / ids", "default": "search" }, "query": { "title": "Search keyword", "type": "string", "description": "Free-text search term used by **search** and **sold** (and optionally to filter **category** / **sellerItems**). Leave blank to use the broad default query so empty input still returns data." }, "categoryId": { "title": "Category id", "type": "string", "description": "Numeric eBay category id for **category** mode (the number in `_sacat=` of a category URL). Examples: 177 = PC Laptops & Netbooks, 9355 = Cell Phones & Smartphones, 139973 = Video Games, 11450 = Clothing." }, "categoryUrl": { "title": "Category / search URL", "type": "string", "description": "Paste any eBay category or search results URL (from your browser) and the actor will paginate it directly. Overrides categoryId when set." }, "seller": { "title": "Seller username", "type": "string", "description": "eBay seller username for **sellerItems** mode (e.g. `bestbuy`). You can also paste a `.../usr/` store URL." }, "itemUrl": { "title": "Item URL", "type": "string", "description": "A single eBay item URL (`https://www.ebay.com/itm/...`) for **productDetail** mode." }, "itemUrls": { "title": "Item URLs (batch)", "type": "array", "description": "A list of eBay item URLs for batch **productDetail** lookups.", "items": { "type": "string" }, "default": [] }, "itemIds": { "title": "Item ids (batch)", "type": "array", "description": "A list of numeric eBay item ids for batch **productDetail** (alternative to full URLs).", "items": { "type": "string" }, "default": [] }, "condition": { "title": "Condition", "enum": [ "", "1000", "1500", "2000", "2010", "2020", "2030", "2500", "3000", "4000", "5000", "6000", "7000" ], "type": "string", "description": "Filter listings by item condition (search / category / sold / sellerItems).", "default": "" }, "buyingFormat": { "title": "Buying format", "enum": [ "", "BIN", "AUCTION", "BO" ], "type": "string", "description": "Restrict to a buying format.", "default": "" }, "sort": { "title": "Sort by", "enum": [ "", "12", "10", "1", "15", "16", "2", "3" ], "type": "string", "description": "Ordering of the results page.", "default": "" }, "freeShipping": { "title": "Free shipping only", "type": "boolean", "description": "If enabled, only return listings offering free shipping.", "default": false }, "priceMin": { "title": "Minimum price", "type": "string", "description": "Only listings priced at or above this amount (in the site's currency)." }, "priceMax": { "title": "Maximum price", "type": "string", "description": "Only listings priced at or below this amount (in the site's currency)." }, "domain": { "title": "eBay site", "enum": [ "ebay.com", "ebay.co.uk", "ebay.de", "ebay.com.au", "ebay.fr", "ebay.it", "ebay.es", "ebay.ca", "ebay.nl", "ebay.ie", "ebay.at", "ebay.ch", "ebay.be", "ebay.pl", "ebay.com.hk", "ebay.com.sg" ], "type": "string", "description": "Which eBay marketplace to scrape. Prices and availability are localized to the site.", "default": "ebay.com" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Upper bound on rows returned. For search / category / sold / sellerItems this drives pagination (up to 240 items per page). Default 200.", "default": 200 }, "enrichDetails": { "title": "Enrich each result with seller & full item details (slower)", "type": "boolean", "description": "OFF by default (keeps big search / category / sold / sellerItems runs fast). When ON, the actor opens every result's item page and adds fields the search card can't show: **sellerName**, **sellerPositivePercent**, **sellerFeedbackCount**, precise **itemLocation**, **itemSpecifics**, **brand**, **returnsAccepted**, **quantityAvailable** and **quantitySold**. This roughly doubles the work per item, so use a smaller **maxResults** (e.g. 40–200) when you turn it on. Has no effect on productDetail mode (which already fetches item pages).", "default": false }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "eBay blocks datacenter/origin IPs, so Apify Proxy is used by default (AUTO, escalating to RESIDENTIAL on a challenge). Leave the default unless you know what you're doing.", "default": { "useApifyProxy": 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 } } } } } } } } } }