SHEIN Store Products Actor Documentation

Overview

The SHEIN Store Products Actor is a powerful web scraping tool deployed on the Apify platform that allows you to extract product information from SHEIN store pages. This actor can scrape product details including names, prices, images, ratings, and other relevant information from any SHEIN store across different countries and regions.

Features

• Multi-Country Support: Scrape from 38+ different SHEIN regional sites
• Advanced Filtering: Filter products by price range, category, and custom criteria
• Pagination Support: Navigate through multiple pages of results
• Multiple Sort Options: Sort products by popularity, price, ratings, and more
• Comprehensive Product Data: Extract detailed product information including pricing, images, ratings, and availability
• Flexible Output: Results available in JSON format with structured data

Input Parameters

Required Parameters

Parameter	Type	Description
storeUrl	string	The SHEIN store URL to scrape products from

Optional Parameters

Parameter	Type	Default	Description
page	integer	1	Page number for pagination (starting from 1)
perPage	string	"5"	Number of items per page (5, 10, 15, or 20)
filter	string	""	Custom filter criteria for products
categoryId	string	""	Product category identifier
maxPrice	integer	-	Maximum price filter for products
minPrice	integer	-	Minimum price filter for products
countryCode	string	"us"	Two-letter country code for SHEIN regional site
orderBy	string	"recommend"	Sort order for results

Supported Country Codes

The actor supports the following country codes:

• North America: us, ca, mx
• Europe: de, fr, it, ch, pl, pt, es, se, uk, nl, be, at, dk, no, fi, ie
• Asia-Pacific: jp, kr, cn, tw, hk, au, in, id, ph, my, sg, th, vn
• Middle East & Africa: ae, sa, tr, il
• South America: br
• Others: ru

Sort Options

Value	Description
recommend	Recommended products (default)
MostPopular	Most popular products
NewArrivals	Newest products
TopRated	Highest rated products
PriceLowtoHigh	Price: Low to High
PriceHightoLow	Price: High to Low

Input Example

{
  "storeUrl": "https://pt.shein.com/store/home?ici=PageGoodsDetail&main_cate_id=12478&main_goods_id=69536888&rule_poskey=DetailShopItemList&src_identifier=on%3Dstore%60cn%3DSHEIN%20LUNE%60hz%3D0%60ps%3D1_1%60jc%3DthirdPartyStoreHome_3276656780&src_module=DetailBrand&src_tab_page_id=page_goods_detail1749203412328&store_code=3276656780&tab=home",
  "page": 1,
  "perPage": "10",
  "countryCode": "us",
  "orderBy": "MostPopular",
  "maxPrice": 50,
  "minPrice": 10
}

Output Structure

The actor returns a comprehensive JSON object containing pagination information and detailed product data.

Pagination Object

{
  "pagination": {
    "page": 1,
    "perPage": 5,
    "totalAvailable": 3000,
    "hasNext": true,
    "hasPrev": false
  }
}

Product Object

Each product in the results contains the following information:

{
  "goods_id": "60797100",
  "goods_sn": "sz25030673779899532",
  "goods_name": "SHEIN LUNE Women's Casual Floral Print Round Neck Cap Sleeve Dress, Vacation",
  "goods_url_name": "SHEIN-LUNE-Women-s-Casual-Floral-Print-Round-Neck-Cap-Sleeve-Dress-Vacation",
  "goods_img": "//img.ltwebstatic.com/images3_pi/2025/03/24/e9/1742810919bd6a1dda5cea7861d16140373e565f39_thumbnail_405x552.jpg",
  "detail_image": ["array of additional product images"],
  "cat_id": "12478",
  "cate_name": "Women Midi Dresses",
  "store_code": "3276656780",
  "stock": "1",
  "is_on_sale": 1,
  "soldOutStatus": false,
  "retailPrice": {
    "amount": "17.19",
    "amountWithSymbol": "$17.19",
    "usdAmount": "17.19",
    "usdAmountWithSymbol": "$17.19"
  },
  "salePrice": {
    "amount": "13.58",
    "amountWithSymbol": "$13.58",
    "usdAmount": "13.58",
    "usdAmountWithSymbol": "$13.58"
  },
  "discountPrice": {
    "amount": "3.61",
    "amountWithSymbol": "$3.61",
    "usdAmount": "3.61",
    "usdAmountWithSymbol": "$3.61"
  },
  "retailDiscountPercent": "21",
  "comment_num": 1001,
  "comment_rank_average": "4.83",
  "comment_num_show": "1000+",
  "percent_overall_fit": {
    "true_size": "92%",
    "large": "5%",
    "small": "3%"
  },
  "relatedColorNew": ["array of related color variants"],
  "promotionInfo": ["array of current promotions"],
  "productUrl": "https://us.shein.com/SHEIN-LUNE-Women-s-Casual-Floral-Print-Round-Neck-Cap-Sleeve-Dress-Vacation-p-60797100.html"
}

Key Data Fields

Product Identification

• goods_id: Unique product identifier
• goods_sn: Product serial number
• spu: Stock keeping unit identifier
• goods_name: Product title/name
• goods_url_name: URL-friendly product name

Pricing Information

• retailPrice: Original retail price
• salePrice: Current sale price
• discountPrice: Discount amount
• retailDiscountPercent: Discount percentage
• promotionInfo: Current promotional offers

Product Details

• goods_img: Main product image URL
• detail_image: Array of additional product images
• cat_id: Category identifier
• cate_name: Category name
• stock: Stock availability
• soldOutStatus: Whether product is sold out

Reviews & Ratings

• comment_num: Total number of reviews
• comment_rank_average: Average rating
• comment_num_show: Display format for review count
• percent_overall_fit: Size fitting information

Store Information

• store_code: Store identifier
• business_model: Business model type
• mall_code: Mall/marketplace code

Usage Examples

Basic Store Scraping

// Scrape first page of a SHEIN store
const input = {
  "storeUrl": "https://us.shein.com/store/home?store_code=1234567890",
  "countryCode": "us",
  "perPage": "20"
};

Advanced Filtering

// Scrape products with specific criteria
const input = {
  "storeUrl": "https://us.shein.com/store/home?store_code=1234567890",
  "countryCode": "us",
  "minPrice": 15,
  "maxPrice": 100,
  "orderBy": "PriceLowtoHigh",
  "perPage": "20",
  "page": 1
};

Multi-Page Scraping

// Scrape multiple pages
const input = {
  "storeUrl": "https://us.shein.com/store/home?store_code=1234567890",
  "page": 2,
  "perPage": "15",
  "orderBy": "NewArrivals"
};

Error Handling

The actor includes comprehensive error handling:

• Missing Store URL: Throws error if storeUrl is not provided
• Invalid Parameters: Validates input parameters
• Network Errors: Handles connection issues gracefully
• Rate Limiting: Implements delays to respect SHEIN's rate limits

Best Practices

1. Respect Rate Limits: Don't run multiple instances simultaneously
2. Use Appropriate Delays: Allow time between requests
3. Handle Pagination: Use the hasNext field to determine if more pages exist
4. Monitor Results: Check the totalAvailable count for planning
5. Country-Specific Scraping: Use appropriate country codes for regional data

Support

If you have any questions or encounter any issues, please consult the Apify documentation or reach out to us through one of the following channels:

• Telegram: @pintoflow
• Email: pintoflowpt@gmail.com
• Apify Platform: You can also contact us directly through this platform.

---