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 json { "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 json { "pagination": { "page": 1, "perPage": 5, "totalAvailable": 3000, "hasNext": true, "hasPrev": false } } ### Product Object Each product in the results contains the following information: json { "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 javascript // 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 javascript // 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 javascript // 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. ---