> ## 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 Falabella product search (Chile, Colombia, Peru)

> Searches a Falabella store (`country`: cl, co or pe) for `query` and returns the products as JSON: `productId`, `skuId`, `title`, `brand`, `url`, `price` (and `priceMax` for a price range), `cmrPrice` (price with the Falabella CMR card), `originalPrice` (crossed-out list price), `discountPercent`, `currency`, `rating`, `reviewCount`, `sellerId` / `sellerName`, `sponsored`, `bestSeller`, `freeShipping`, `deliveryLabels`, `badges`, `installmentsWithoutInterest`, `image` / `images`, `topSpecifications` and `variants` (colour / size options). Sort with `sort`, start at `page`, and collect up to `max_results` across pages (48 per page, each page billed as one request, see `pagesFetched`). `url` takes a Falabella search link instead of `query`.



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/falabella-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/falabella-search:
    post:
      tags:
        - Plugins
      summary: Scrape Falabella product search (Chile, Colombia, Peru)
      description: >-
        Searches a Falabella store (`country`: cl, co or pe) for `query` and
        returns the products as JSON: `productId`, `skuId`, `title`, `brand`,
        `url`, `price` (and `priceMax` for a price range), `cmrPrice` (price
        with the Falabella CMR card), `originalPrice` (crossed-out list price),
        `discountPercent`, `currency`, `rating`, `reviewCount`, `sellerId` /
        `sellerName`, `sponsored`, `bestSeller`, `freeShipping`,
        `deliveryLabels`, `badges`, `installmentsWithoutInterest`, `image` /
        `images`, `topSpecifications` and `variants` (colour / size options).
        Sort with `sort`, start at `page`, and collect up to `max_results`
        across pages (48 per page, each page billed as one request, see
        `pagesFetched`). `url` takes a Falabella search link instead of `query`.
      operationId: falabella_search_marketplace_falabella_search_post
      parameters:
        - name: query
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              What to search, e.g. 'zapatillas nike', 'televisor 55' or
              'notebook'.
            title: Query
          description: >-
            What to search, e.g. 'zapatillas nike', 'televisor 55' or
            'notebook'.
        - name: country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Falabella store: 'cl' (www.falabella.com, prices in CLP), 'co'
              (www.falabella.com.co, prices in COP), 'pe' (www.falabella.com.pe,
              prices in PEN). Default 'cl'.
            title: Country
          description: >-
            Falabella store: 'cl' (www.falabella.com, prices in CLP), 'co'
            (www.falabella.com.co, prices in COP), 'pe' (www.falabella.com.pe,
            prices in PEN). Default 'cl'.
        - name: sort
          in: query
          required: false
          schema:
            type: string
            description: 'Order: relevance, price_low, price_high, rating, brand.'
            default: relevance
            title: Sort
          description: 'Order: relevance, price_low, price_high, rating, brand.'
        - name: page
          in: query
          required: false
          schema:
            type: integer
            description: 1-based results page to start from (1-200).
            default: 1
            title: Page
          description: 1-based results page to start from (1-200).
        - name: max_results
          in: query
          required: false
          schema:
            type: integer
            description: >-
              Products to collect across pages (1-480); Falabella serves 48 per
              page and each page fetched is billed as one request.
            default: 48
            title: Max Results
          description: >-
            Products to collect across pages (1-480); Falabella serves 48 per
            page and each page fetched is billed as one request.
        - name: url
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Instead of `query`: a Falabella search link, e.g.
              https://www.falabella.com/falabella-cl/search?Ntt=zapatillas (its
              store, sort and page are used).
            title: Url
          description: >-
            Instead of `query`: a Falabella search link, e.g.
            https://www.falabella.com/falabella-cl/search?Ntt=zapatillas (its
            store, sort and page are used).
      responses:
        '200':
          description: JSON with a `products` array plus paging totals.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '404':
          description: >-
            Falabella found no products for this search, or sends the keyword to
            a landing page without a results list.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked by Falabella on every attempt, no results page returned, or
            the call did not finish 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.