> ## 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 MediaMarkt search

> Searches a MediaMarkt shop (`country` de, at, ch, nl, be, es, it = MediaWorld, pl, hu, tr; `banner=saturn` for Saturn Germany) for `query` and returns `products`, each with `position`, `productId`, `offerId` (marketplace offers), `title`, `brand`, `ean`, `url`, `image`, `breadcrumbs`, `price`, `strikePrice` and `strikePriceType` (RRP = manufacturer's recommended price, LOP = lowest price of the last 30 days), `discountPercent`, `currency`, `installment`, `marketplace`, `seller` (marketplace seller with rating), `rating`, `reviewCount`, `availability` (online status, deliverable, store pickup, delivery window and shipping cost), `energyEfficiency`, `highlights` (key features), `badges`, `refurbishedFrom` and `sponsored`. Also `total`, `lastPage`, `nextPage` and `listingUrl` (the category or brand listing MediaMarkt sends this query to, when it does). `sort` orders the results; `page` and `max_results` page through them (MediaMarkt shows 12 per page and 30 pages at most). One unit per results page used.



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/mediamarkt-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/mediamarkt-search:
    post:
      tags:
        - Plugins
      summary: Scrape MediaMarkt search
      description: >-
        Searches a MediaMarkt shop (`country` de, at, ch, nl, be, es, it =
        MediaWorld, pl, hu, tr; `banner=saturn` for Saturn Germany) for `query`
        and returns `products`, each with `position`, `productId`, `offerId`
        (marketplace offers), `title`, `brand`, `ean`, `url`, `image`,
        `breadcrumbs`, `price`, `strikePrice` and `strikePriceType` (RRP =
        manufacturer's recommended price, LOP = lowest price of the last 30
        days), `discountPercent`, `currency`, `installment`, `marketplace`,
        `seller` (marketplace seller with rating), `rating`, `reviewCount`,
        `availability` (online status, deliverable, store pickup, delivery
        window and shipping cost), `energyEfficiency`, `highlights` (key
        features), `badges`, `refurbishedFrom` and `sponsored`. Also `total`,
        `lastPage`, `nextPage` and `listingUrl` (the category or brand listing
        MediaMarkt sends this query to, when it does). `sort` orders the
        results; `page` and `max_results` page through them (MediaMarkt shows 12
        per page and 30 pages at most). One unit per results page used.
      operationId: mediamarkt_search_marketplace_mediamarkt_search_post
      parameters:
        - name: query
          in: query
          required: true
          schema:
            type: string
            description: What to search for, e.g. 'iphone 17' or 'waschmaschine'.
            title: Query
          description: What to search for, e.g. 'iphone 17' or 'waschmaschine'.
        - name: country
          in: query
          required: false
          schema:
            type: string
            description: >-
              MediaMarkt shop: de, at, ch, nl, be, es, it, pl, hu, tr (default
              de; it = MediaWorld).
            default: de
            title: Country
          description: >-
            MediaMarkt shop: de, at, ch, nl, be, es, it, pl, hu, tr (default de;
            it = MediaWorld).
        - name: banner
          in: query
          required: false
          schema:
            type: string
            description: mediamarkt (default) or saturn (Saturn Germany, with country=de).
            default: mediamarkt
            title: Banner
          description: mediamarkt (default) or saturn (Saturn Germany, with country=de).
        - name: language
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Site language where the shop has several: be = nl or fr, ch = de,
              fr or it. Default: the shop's first.
            title: Language
          description: >-
            Site language where the shop has several: be = nl or fr, ch = de, fr
            or it. Default: the shop's first.
        - name: sort
          in: query
          required: false
          schema:
            type: string
            description: >-
              Result order: relevance, price_asc, price_desc, rating,
              bestseller, newest.
            default: relevance
            title: Sort
          description: >-
            Result order: relevance, price_asc, price_desc, rating, bestseller,
            newest.
        - name: page
          in: query
          required: false
          schema:
            type: integer
            description: First results page to read (1-30).
            default: 1
            title: Page
          description: First results page to read (1-30).
        - name: max_results
          in: query
          required: false
          schema:
            type: integer
            description: >-
              Products to collect across pages, 1-120. A page holds 12 products;
              each page is one unit.
            default: 12
            title: Max Results
          description: >-
            Products to collect across pages, 1-120. A page holds 12 products;
            each page is one unit.
      responses:
        '200':
          description: JSON with a `products` array.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '404':
          description: MediaMarkt found nothing for this search.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked by MediaMarkt 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.