Logo SearchApi

Shein Search API Documentation

Shein Search API uses /api/v1/search?engine=shein_search API endpoint to scrape real-time results.

The Shein Search API provides developers with access to Shein's product data. You can search for item details, prices, brand information, series information, and other product details.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    The parameter specifies your search query. It accepts any term or phrase you'd typically input in Shein search. Must be at least 2 characters.

Localization

Filters

  • Name
    sort_by
    Required
    Optional
    Description

    Parameter allows sorting search results by different criteria. Below is the list of available sorting options:

    • recommended Default
    • top_rated
    • most_popular
    • new_arrivals
    • price_low_to_high
    • price_high_to_low

  • Name
    category_id
    Required
    Optional
    Description

    Parameter allows to search products by a category id. The value of category id can be found in JSON response, under shopping_results.category. path.

  • Name
    attribute_ids
    Required
    Optional
    Description

    Parameter allows to search and filter products based on attribute IDs. The possible attribute_ids can be found in the subattributes array of each attribute object inside the filters.attributes array. Each sub-attribute object contains an attribute_id field, which is the attribute ID you can use here. The format for attribute_ids is 'int_int', for example: 101_725. If you want to specify multiple attribute IDs, separate them with hyphens, For example: 101_725-102_826.

  • Name
    currency
    Required
    Optional
    Description

    Parameter allows to get product prices for search results in the given currency. Check the full list of supported Shein currencies.

  • Name
    price_min
    Required
    Optional
    Description

    This parameter controls the minimum price of the products returned. For instance - 10 value would return products with a minimum price of 10.

  • Name
    price_max
    Required
    Optional
    Description

    This parameter controls the maximum price of the products returned. For instance - 20.5 value would return products with a maximum price of 20.5.

Pagination

  • Name
    page
    Required
    Optional
    Description

    The parameter determines the results page number. It defaults to 1.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to shein_search.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=shein_search&q=jeans
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "shein_search",
  "q": "jeans"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_rWMBG04LgyPXTb4Ypb6NQzqD",
    "status": "Success",
    "created_at": "2024-09-19T13:01:35Z",
    "request_time_taken": 1.67,
    "parsing_time_taken": 0.04,
    "total_time_taken": 1.71,
    "request_url": "https://us.shein.com/pdsearch/jeans/?ici=s1`EditSearch`jeans`_fb`d0`PageHome&src_identifier=st=2`sc=jeans`sr=0`ps=1",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_rWMBG04LgyPXTb4Ypb6NQzqD.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_rWMBG04LgyPXTb4Ypb6NQzqD"
  },
  "search_parameters": {
    "engine": "shein_search",
    "q": "jeans",
    "shein_domain": "us.shein.com"
  },
  "search_information": {
    "query_displayed": "jeans",
    "total_results": 6550,
    "suggested_total_results": 0,
    "price_min": 0,
    "price_max": 1100,
    "currency": "USD"
  },
  "filters": {
    "categories": [
      {
        "id": "1934",
        "name": "Women Jeans"
      },
      {
        "id": "2055",
        "name": "Plus Size Jeans"
      },
      ...
    ],
    "attributes": [
      {
        "id": "109",
        "name": "Type",
        "subattributes": [
          {
            "id": "109_607",
            "name": "Skinny",
            "parent_id": "109"
          },
          ...
        ]
      },
      ...
    ]
  },
  "organic_results": [
    {
      "position": 1,
      "product_id": 33704388,
      "sku": "sz2402281262532083",
      "title": "SHEIN ICON Women Embroidered Bowknot Washed Denim Jeans",
      "link": "https://us.shein.com/SHEIN-ICON-Women-Embroidered-Bowknot-Washed-Denim-Jeans-p-33704388.html?src_identifier=st%3D2%60sc%3Djeans%60sr%3D0%60ps%3D1&mallCode=1&pageListType=4",
      "series": "SHEIN ICON",
      "variants_count": 10,
      "recent_sales": "10k+ sold recently",
      "extracted_recent_sales": 80098,
      "price": "$20.99",
      "extracted_price": 20.99,
      "price_usd": "$20.99",
      "extracted_price_usd": 20.99,
      "original_price": "$23.49",
      "extracted_original_price": 23.49,
      "original_price_usd": "$23.49",
      "extracted_original_price_usd": 23.49,
      "discount_percentage": 11,
      "discount_amount": "$2.50",
      "extracted_discount_amount": 2.5,
      "shein_club_membership": {
        "price": "$19.94",
        "extracted_price": 19.94,
        "price_usd": "$19.94",
        "extracted_price_usd": 19.94,
        "discount_percentage": 15,
        "discount_amount": "$3.55",
        "extracted_discount_amount": 3.55
      },
      "category_id": "1934",
      "bestsellers_rank": {
        "category": "In Casual Women Denim",
        "rank": 1
      },
      "has_free_shipping": true,
      "has_quick_ship": true,
      "images": [
        "https://img.ltwebstatic.com/images3_pi/2024/04/19/ae/17135182531e360fc58fd48a3ef918f840beebee7d_thumbnail_405x552.jpg",
        "https://img.ltwebstatic.com/images3_pi/2024/04/19/4f/17135182556b6fbff0a7a33e0e509eecdb642002d2_thumbnail_405x552.jpg"
      ],
      "thumbnail": "https://img.ltwebstatic.com/images3_pi/2024/04/19/b9/1713518249b0d7ca4881e8cd6a2e621f4c40bd2e5d_thumbnail_405x552.jpg"
    },
    ...
  ]
}