> ## 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 an Allegro offer

> Returns one Allegro (Poland) offer by `offer_id` or `url`: `offerId`, `productId`, `title`, `productName`, `brand`, `gtin`, `price`, `originalPrice`, `currency`, `sellingMode` (buy_now / auction), `available` (stock), `condition`, `rating`, `ratingCount`, `ratingBreakdown` (1-5 stars), `recentBuyers`, `category`, `breadcrumbs`, `parameters` (group / name / value), `description`, `images`, `variants`, `seller` (id, login, Super Seller, feedback, company name and tax id), `location`, `smart`, `delivery`, `shippingMethods` (name, price, Smart! price), `returnDays`, `warranty`, `endsAt`, `reviews` and `url`. One unit per call.



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/allegro-product
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-product:
    post:
      tags:
        - Plugins
      summary: Scrape an Allegro offer
      description: >-
        Returns one Allegro (Poland) offer by `offer_id` or `url`: `offerId`,
        `productId`, `title`, `productName`, `brand`, `gtin`, `price`,
        `originalPrice`, `currency`, `sellingMode` (buy_now / auction),
        `available` (stock), `condition`, `rating`, `ratingCount`,
        `ratingBreakdown` (1-5 stars), `recentBuyers`, `category`,
        `breadcrumbs`, `parameters` (group / name / value), `description`,
        `images`, `variants`, `seller` (id, login, Super Seller, feedback,
        company name and tax id), `location`, `smart`, `delivery`,
        `shippingMethods` (name, price, Smart! price), `returnDays`, `warranty`,
        `endsAt`, `reviews` and `url`. One unit per call.
      operationId: allegro_product_marketplace_allegro_product_post
      parameters:
        - name: offer_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Allegro offer number, e.g. 16680923539 (the number at the end of
              an /oferta/ link or its offerId).
            title: Offer Id
          description: >-
            Allegro offer number, e.g. 16680923539 (the number at the end of an
            /oferta/ link or its offerId).
        - name: url
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              An Allegro offer or product link, e.g.
              https://allegro.pl/oferta/16680923539 or
              https://allegro.pl/produkt/...?offerId=16680923539. Used instead
              of `offer_id`.
            title: Url
          description: >-
            An Allegro offer or product link, e.g.
            https://allegro.pl/oferta/16680923539 or
            https://allegro.pl/produkt/...?offerId=16680923539. Used instead of
            `offer_id`.
        - 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 the offer.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '404':
          description: Allegro has no offer with this number.
        '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.