> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt > Use this file to discover all available pages before exploring further. # Scrape Allegro search > Searches Allegro (Poland) for `query` and returns `products` (offers), each with `position`, `offerId`, `productId`, `title`, `price`, `currency` (PLN), `priceWithDelivery`, `deliveryFrom`, `freeDelivery`, `smart` (Allegro Smart!), `deliveryLabel`, `rating`, `ratingCount`, `recentBuyers` (bought in the last 30 days), `offersOfProduct`, `quantity`, `sponsored`, `promoted`, `superSeller`, `seller` (id, login, company, positive feedback %), `parameters`, `image`, `images` and `url`. Also `total` (all matches), `available` (offers Allegro lets you page through), `lastPage`, `category` and `nextPage`. Filter with `min_price` / `max_price`, `condition`, `shipping_from`, `delivery_time`, `offer_type`, `store_city` and `store_region`; `sort` orders the results; `page` and `max_results` page through them. One unit per Allegro page read. ## OpenAPI ````yaml /api-reference/openapi.json post /marketplace/allegro-search openapi: 3.1.0 info: title: ScrapeUnblocker API description: >- Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate every request with the `x-scrapeunblocker-key` header. Documented here: page-source extraction, Google SERP scraping, image fetch, and the dedicated plugin endpoints (search engines, marketplaces, reviews, travel, social and more). All other paths exist for internal operations and are intentionally hidden from this spec. version: 3.0.0 servers: - url: https://api.scrapeunblocker.com description: Production security: [] paths: /marketplace/allegro-search: post: tags: - Plugins summary: Scrape Allegro search description: >- Searches Allegro (Poland) for `query` and returns `products` (offers), each with `position`, `offerId`, `productId`, `title`, `price`, `currency` (PLN), `priceWithDelivery`, `deliveryFrom`, `freeDelivery`, `smart` (Allegro Smart!), `deliveryLabel`, `rating`, `ratingCount`, `recentBuyers` (bought in the last 30 days), `offersOfProduct`, `quantity`, `sponsored`, `promoted`, `superSeller`, `seller` (id, login, company, positive feedback %), `parameters`, `image`, `images` and `url`. Also `total` (all matches), `available` (offers Allegro lets you page through), `lastPage`, `category` and `nextPage`. Filter with `min_price` / `max_price`, `condition`, `shipping_from`, `delivery_time`, `offer_type`, `store_city` and `store_region`; `sort` orders the results; `page` and `max_results` page through them. One unit per Allegro page read. operationId: allegro_search_marketplace_allegro_search_post parameters: - name: query in: query required: true schema: type: string description: What to search for, e.g. 'iphone 15' or 'lego'. title: Query description: What to search for, e.g. 'iphone 15' or 'lego'. - name: sort in: query required: false schema: type: string description: >- Result order: relevance, price_asc, price_desc, price_with_delivery_asc, price_with_delivery_desc, popularity, ending_soon, newest, rating. default: relevance title: Sort description: >- Result order: relevance, price_asc, price_desc, price_with_delivery_asc, price_with_delivery_desc, popularity, ending_soon, newest, rating. - name: page in: query required: false schema: type: integer description: First Allegro results page to read (1-100). default: 1 title: Page description: First Allegro results page to read (1-100). - name: min_price in: query required: false schema: anyOf: - type: number - type: 'null' description: Lowest price in zloty (PLN). title: Min Price description: Lowest price in zloty (PLN). - name: max_price in: query required: false schema: anyOf: - type: number - type: 'null' description: Highest price in zloty (PLN). title: Max Price description: Highest price in zloty (PLN). - name: condition in: query required: false schema: anyOf: - type: string - type: 'null' description: 'Item condition: new, like_new, refurbished, used, damaged.' title: Condition description: 'Item condition: new, like_new, refurbished, used, damaged.' - name: shipping_from in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Where the item ships from: pl, cz, sk, hu, cn, eu, allegro_warehouse. title: Shipping From description: >- Where the item ships from: pl, cz, sk, hu, cn, eu, allegro_warehouse. - name: delivery_time in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Delivery speed: one_day, two_days, three_days (one_day = tomorrow). title: Delivery Time description: 'Delivery speed: one_day, two_days, three_days (one_day = tomorrow).' - name: offer_type in: query required: false schema: anyOf: - type: string - type: 'null' description: 'Offer type: buy_now, auction (buy_now = fixed price).' title: Offer Type description: 'Offer type: buy_now, auction (buy_now = fixed price).' - name: store_city in: query required: false schema: anyOf: - type: string - type: 'null' description: The seller's town, e.g. 'Kraków'. title: Store City description: The seller's town, e.g. 'Kraków'. - name: store_region in: query required: false schema: anyOf: - type: string - type: 'null' description: >- The seller's voivodeship, e.g. 'mazowieckie' or 'slaskie' (or its number 1-16). title: Store Region description: >- The seller's voivodeship, e.g. 'mazowieckie' or 'slaskie' (or its number 1-16). - name: max_results in: query required: false schema: type: integer description: >- Offers to collect across pages, 1-300. A page holds about 60 offers; each page is one unit. default: 60 title: Max Results description: >- Offers to collect across pages, 1-300. A page holds about 60 offers; each page is one unit. - name: proxy_country in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Proxy country the request is sent from (ISO-2, e.g. 'DE', 'CZ'). Leave blank to let the API pick (recommended: Allegro refuses some countries' exits). title: Proxy Country description: >- Proxy country the request is sent from (ISO-2, e.g. 'DE', 'CZ'). Leave blank to let the API pick (recommended: Allegro refuses some countries' exits). responses: '200': description: JSON with a `products` array. content: application/json: schema: {} '400': description: Invalid parameters. '404': description: Allegro found no offers for this search. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '502': description: >- Blocked by Allegro on every attempt, an unusable answer, or no answer in time. security: - ScrapeUnblockerKey: [] components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ScrapeUnblockerKey: type: apiKey in: header name: x-scrapeunblocker-key description: Your ScrapeUnblocker API key. Apply on every request. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.