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

> Searches SHEIN (US store) for `query` and returns the products as JSON: `id`, `sku`, `title`, `url`, `price`, `originalPrice`, `currency`, `discountPercent`, `rating`, `reviewCount`, `category`, `image`, `soldOut` and `storeCode`. Order with `sort`, filter with `min_price`/`max_price`. Returns SHEIN's first results page (up to 20 products); SHEIN does not serve deeper pages to automated clients.



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/shein-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/shein-search:
    post:
      tags:
        - Plugins
      summary: Scrape SHEIN product search
      description: >-
        Searches SHEIN (US store) for `query` and returns the products as JSON:
        `id`, `sku`, `title`, `url`, `price`, `originalPrice`, `currency`,
        `discountPercent`, `rating`, `reviewCount`, `category`, `image`,
        `soldOut` and `storeCode`. Order with `sort`, filter with
        `min_price`/`max_price`. Returns SHEIN's first results page (up to 20
        products); SHEIN does not serve deeper pages to automated clients.
      operationId: shein_search_marketplace_shein_search_post
      parameters:
        - name: query
          in: query
          required: true
          schema:
            type: string
            description: What to search, e.g. 'summer dress' or 'phone case'.
            title: Query
          description: What to search, e.g. 'summer dress' or 'phone case'.
        - name: sort
          in: query
          required: false
          schema:
            type: string
            description: 'Ordering: relevance, price_low, price_high.'
            default: relevance
            title: Sort
          description: 'Ordering: relevance, price_low, price_high.'
        - name: min_price
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
            description: Lowest price to include (USD).
            title: Min Price
          description: Lowest price to include (USD).
        - name: max_price
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
            description: Highest price to include (USD).
            title: Max Price
          description: Highest price to include (USD).
        - name: max_results
          in: query
          required: false
          schema:
            type: integer
            maximum: 200
            minimum: 1
            description: >-
              How many products to return (at most 20: SHEIN serves only its
              first results page).
            default: 20
            title: Max Results
          description: >-
            How many products to return (at most 20: SHEIN serves only its first
            results page).
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            description: 'Must be 1: SHEIN challenges every deeper results page.'
            default: 1
            title: Page
          description: 'Must be 1: SHEIN challenges every deeper results page.'
        - name: proxy_country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Exit-IP country (ISO-2). Optional.
            title: Proxy Country
          description: Exit-IP country (ISO-2). Optional.
      responses:
        '200':
          description: JSON with a `products` array plus `totalResults`.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Blocked by SHEIN or no results page returned.
        '504':
          description: Fetch timed out.
      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.