SHEIN Store Promotion Scraper A web scraping actor for Apify that extracts promotion and discount information from SHEIN store pages across different regional markets. ## Overview This actor scrapes SHEIN store pages to extract comprehensive promotion data including discount tabs, coupons, flash sales, and other promotional offers. It supports multiple regional SHEIN sites and provides structured data about available discounts and promotional campaigns. ## Features - Extracts discount information from SHEIN store pages - Supports 38+ regional SHEIN markets - Retrieves promotion details including discount rates and categories - Captures flash sale information with timing details - Extracts coupon and promotional offer data - Handles region-specific pricing and promotions ## Input Parameters ### Required Parameters - storeUrl (string, required): The complete URL of the SHEIN store page to scrape - Example: 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 ### Optional Parameters - countryCode (string, optional): Two-letter country code for SHEIN regional site - Default: "us" - Supported countries: US, DE, FR, IT, CH, PL, PT, ES, SE, UK, CA, MX, BR, AE, SA, RU, JP, KR, CN, TW, HK, AU, IN, ID, PH, MY, SG, TR, NL, BE, AT, DK, NO, FI, IE, VN, TH, IL ## Supported Regional Markets The actor supports the following SHEIN regional markets: | Code | Market | Code | Market | Code | Market | |------|--------|------|--------|------|--------| | us | United States | de | Germany | fr | France | | it | Italy | ch | Switzerland | pl | Poland | | pt | Portugal | es | Spain | se | Sweden | | uk | United Kingdom | ca | Canada | mx | Mexico | | br | Brazil | ae | UAE | sa | Saudi Arabia | | ru | Russia | jp | Japan | kr | South Korea | | cn | China | tw | Taiwan | hk | Hong Kong | | au | Australia | in | India | id | Indonesia | | ph | Philippines | my | Malaysia | sg | Singapore | | tr | Turkey | nl | Netherlands | be | Belgium | | at | Austria | dk | Denmark | no | Norway | | fi | Finland | ie | Ireland | vn | Vietnam | | th | Thailand | il | Israel | | | ## Output Structure The actor returns a comprehensive JSON object containing promotion data: ### Main Output Fields - results: Main container for all promotion data - cmpCoupons: Array of campaign coupons - couponOrderInfo: Order-specific coupon information - discountTabs: Array of discount categories with rates - discountRecommend: Recommended discount offers - coupons: General coupon information - flashSale: Flash sale details with timing - promotions: Array of active promotions - completedAt: ISO timestamp of scraping completion ### Discount Tabs Structure Each discount tab contains: - id: Unique identifier for the discount category - title: Display name of the discount range - minDiscountRate: Minimum discount rate (decimal format) - maxDiscountRate: Maximum discount rate (decimal format) ### Flash Sale Structure Flash sale information includes: - promotion_id: Unique promotion identifier - start_time: Unix timestamp of sale start - end_time: Unix timestamp of sale end - showCountdown: Flag for countdown display - title: Sale title/name - rules: Sale terms and conditions ## Example Usage ### Basic Usage json { "storeUrl": "https://pt.shein.com/store/home?store_code=3276656780&tab=home" } ### With Country Code json { "storeUrl": "https://de.shein.com/store/home?store_code=1234567890&tab=home", "countryCode": "de" } ## Example Output json { "results": { "cmpCoupons": [], "couponOrderInfo": null, "discountTabs": [ { "id": 1, "title": "From 50% off", "minDiscountRate": "0.51", "maxDiscountRate": "0.99" }, { "id": 2, "title": "Up to 50% off", "minDiscountRate": "0.01", "maxDiscountRate": "0.5" } ], "discountRecommend": null, "coupons": null, "flashSale": { "newLimitPurchaseTips": null, "showCountdown": "0", "type_id": null, "promotion_id": 18183148, "promotion_logo_type": null, "select_id": null, "start_time": 1749603600, "end_time": 1749690000, "title": null, "rules": null }, "promotions": [] }, "completedAt": "2025-06-11T07:49:24.039Z" } ## Data Storage The actor stores results in multiple formats: 1. Dataset: All scraped promotion data is pushed to the default dataset 2. Key-Value Store: Complete results with metadata saved under the 'output' key ## Error Handling The actor includes comprehensive error handling: - Validates required input parameters - Provides detailed error messages for debugging - Gracefully handles network timeouts and connection issues - Logs scraping progress and results count ## Use Cases - E-commerce Analytics: Monitor competitor pricing and promotional strategies - Price Tracking: Track discount trends across different regions - Market Research: Analyze promotional patterns in various markets - Business Intelligence: Gather data for pricing strategy decisions - Promotional Monitoring: Track flash sales and limited-time offers ## Technical Requirements - Runs on Apify platform - Requires valid SHEIN store URLs - Supports concurrent execution for multiple stores - Memory efficient for large-scale scraping operations ## Support and Maintenance This actor is designed to handle SHEIN's dynamic website structure and includes error recovery mechanisms for reliable data extraction. Regular updates may be needed to accommodate website changes. ## 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. ---