> ## 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 idealo offers of a product

> Returns one idealo price comparison by `product_id` or `url` (`country` de, at, uk, fr, it or es): the product (`productId`, `title`, `brand`, `url`, `images`, `lowestPrice`, `highestPrice`, `currency`, `offerCount`, `rating`, `reviewCount`, `pros`, `cons`, `variants` with their own price range and offer count) and `offers`, cheapest first, each with `position`, `offerKey`, `title` (the shop's own product title), `price`, `shippingCost`, `totalPrice`, `delivery` (the shop's delivery estimate as idealo prints it), `carriers`, `freeReturns`, `paymentMethods`, `shop` (id, name, rating, rating count, marketplace and the marketplace seller), `variantId`, `variantName` and `url` (idealo's click-out link). Offers are the new-item offers idealo lists by default; `max_results` collects more than the first 20. One unit for the product and its first 20 offers, plus one per further block of 20.



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/idealo-offers
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/idealo-offers:
    post:
      tags:
        - Plugins
      summary: Scrape idealo offers of a product
      description: >-
        Returns one idealo price comparison by `product_id` or `url` (`country`
        de, at, uk, fr, it or es): the product (`productId`, `title`, `brand`,
        `url`, `images`, `lowestPrice`, `highestPrice`, `currency`,
        `offerCount`, `rating`, `reviewCount`, `pros`, `cons`, `variants` with
        their own price range and offer count) and `offers`, cheapest first,
        each with `position`, `offerKey`, `title` (the shop's own product
        title), `price`, `shippingCost`, `totalPrice`, `delivery` (the shop's
        delivery estimate as idealo prints it), `carriers`, `freeReturns`,
        `paymentMethods`, `shop` (id, name, rating, rating count, marketplace
        and the marketplace seller), `variantId`, `variantName` and `url`
        (idealo's click-out link). Offers are the new-item offers idealo lists
        by default; `max_results` collects more than the first 20. One unit for
        the product and its first 20 offers, plus one per further block of 20.
      operationId: idealo_offers_marketplace_idealo_offers_post
      parameters:
        - name: product_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              idealo product id, e.g. 207643424 (the number in a price
              comparison link, or `productId` from the search results).
            title: Product Id
          description: >-
            idealo product id, e.g. 207643424 (the number in a price comparison
            link, or `productId` from the search results).
        - name: url
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              An idealo price comparison link, e.g.
              https://www.idealo.de/preisvergleich/OffersOfProduct/207643424_-iphone-17-apple.html.
              Used instead of `product_id`; its site sets the country.
            title: Url
          description: >-
            An idealo price comparison link, e.g.
            https://www.idealo.de/preisvergleich/OffersOfProduct/207643424_-iphone-17-apple.html.
            Used instead of `product_id`; its site sets the country.
        - name: country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              idealo site: de, at, uk, fr, it, es (default de; uk =
              idealo.co.uk).
            title: Country
          description: 'idealo site: de, at, uk, fr, it, es (default de; uk = idealo.co.uk).'
        - name: max_results
          in: query
          required: false
          schema:
            type: integer
            description: >-
              Offers to collect, 1-200. The first 20 come with the product; each
              further block of 20 is one more unit.
            default: 20
            title: Max Results
          description: >-
            Offers to collect, 1-200. The first 20 come with the product; each
            further block of 20 is one more unit.
      responses:
        '200':
          description: JSON with the product and an `offers` array.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '404':
          description: idealo has no product with this id.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked by idealo 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.