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

{
  "storeUrl": "https://pt.shein.com/store/home?store_code=3276656780&tab=home"
}

With Country Code

{
  "storeUrl": "https://de.shein.com/store/home?store_code=1234567890&tab=home",
  "countryCode": "de"
}

Example Output

{
  "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.

---