> ## 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 Wish product search

> Searches Wish (wish.com) for `query` and returns `products`: `id`, `name`, `url`, `price`, `originalPrice` (crossed-out price, when discounted), `currency`, `priceText`, `priceUsd` (Wish's USD value, comparable across markets), `shipping`, `rating`, `ratingCount`, `numBought`, `inventory`, `colors`, `sizes`, `merchant` (`id`, `name`, `rating`, `ratingCount`, `feedback`, `country`), `originCountry`, `shipsFrom`, `tileText`, `isWishPick`, `position`, `image` and `thumbnail`, plus `totalResults` and `nextPage`. Wish shows the catalogue and prices of the request's country (`proxy_country`, default US). Collects up to `max_results` from `page` on, billed one unit per page.



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/wish-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/wish-search:
    post:
      tags:
        - Plugins
      summary: Scrape Wish product search
      description: >-
        Searches Wish (wish.com) for `query` and returns `products`: `id`,
        `name`, `url`, `price`, `originalPrice` (crossed-out price, when
        discounted), `currency`, `priceText`, `priceUsd` (Wish's USD value,
        comparable across markets), `shipping`, `rating`, `ratingCount`,
        `numBought`, `inventory`, `colors`, `sizes`, `merchant` (`id`, `name`,
        `rating`, `ratingCount`, `feedback`, `country`), `originCountry`,
        `shipsFrom`, `tileText`, `isWishPick`, `position`, `image` and
        `thumbnail`, plus `totalResults` and `nextPage`. Wish shows the
        catalogue and prices of the request's country (`proxy_country`, default
        US). Collects up to `max_results` from `page` on, billed one unit per
        page.
      operationId: wish_search_marketplace_wish_search_post
      parameters:
        - name: query
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              What to search for, e.g. 'yoga mat' or 'phone case', or a
              wish.com/search/... link.
            title: Query
          description: >-
            What to search for, e.g. 'yoga mat' or 'phone case', or a
            wish.com/search/... link.
        - name: page
          in: query
          required: false
          schema:
            type: integer
            description: >-
              1-based results page to start from (1-300, up to 30 products per
              page).
            default: 1
            title: Page
          description: >-
            1-based results page to start from (1-300, up to 30 products per
            page).
        - name: max_results
          in: query
          required: false
          schema:
            type: integer
            description: >-
              Products to collect across pages, 1-300. Each page fetched is
              billed one unit.
            default: 30
            title: Max Results
          description: >-
            Products to collect across pages, 1-300. Each page fetched is billed
            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. 'US', 'GB',
              'DE'). Wish shows the catalogue, prices and currency of that
              country. Default 'US' (prices in USD).
            title: Proxy Country
          description: >-
            Proxy country the request is sent from (ISO-2, e.g. 'US', 'GB',
            'DE'). Wish shows the catalogue, prices and currency of that
            country. Default 'US' (prices in USD).
      responses:
        '200':
          description: >-
            JSON with a `products` array. A search with no matches answers 200
            with an empty `products` list.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked by Wish 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.