Shein Product Description Actor

Overview

The Shein Product Description Actor is a specialized web scraping tool designed to fetch detailed product information from Shein's product catalog. It retrieves comprehensive product data including pricing, descriptions, images, and other metadata using a product's SKU identifier.

Input Parameters

The actor accepts the following input parameters:

• sku (required): The unique product identifier (SKU/goods_sn) from Shein
  • Example: sc2405235708688996
• countryCode (optional): Two-letter country code for regional pricing and availability
  • Default: US
  • Format: ISO 3166-1 alpha-2

Output Format

The actor returns a structured JSON object containing:

• Product basic information:

  • productRelationID
  • goods_id
  • goods_sn
  • goods_name
  • cat_id

• Pricing information:

  • retailPrice
  • salePrice
  • discountPrice
  • Various price representations (with/without currency symbols)

• Product imagery:

  • goods_img: Thumbnail image URL
  • original_img: Full-resolution image URL

• Additional metadata:

  • Discount information
  • Stock availability
  • Product URL
  • Promotional details

Usage Example

1const input = {
2    sku: 'sc2405235708688996',
3    countryCode: 'US'
4};
5
6// The actor will return detailed product information
7const output = {
8    data: {
9        productRelationID: "c24052357086",
10        retailPrice: {
11            amount: "2.80",
12            amountWithSymbol: "$2.80",
13            // ... additional price details
14        },
15        // ... complete product information
16    }
17};

Error Handling

The actor implements robust error handling:

• Invalid SKU numbers will trigger appropriate error messages
• Network failures are caught and reported
• Input validation ensures proper parameter formatting

Dependencies

• Apify SDK: Core functionality and actor lifecycle management
• Axios: HTTP client for making API requests
• Cheerio: HTML parsing (if needed for future enhancements)

About Shein and Actor Usage Guide for Beginners

What is Shein?

Shein is a global fast-fashion e-commerce platform known for offering trendy clothing, accessories, and home goods at competitive prices. Founded in 2008, it has become one of the world's largest online fashion retailers.

Getting Started with the Actor

For beginners, here's how to use this actor effectively:

1. Finding the SKU

   • Visit any Shein product page
   • The SKU is typically found in the URL or product details section
   • It usually starts with "sc" followed by numbers (e.g., sc2405235708688996)

2. Running the Actor

   • Create an Apify account if you haven't already
   • Navigate to the Shein Product Description actor
   • Input the SKU you found
   • Select your desired country code (default is US)
   • Run the actor

3. Understanding the Results

   • The actor will return detailed product information
   • Pay attention to the pricing section, which includes both retail and sale prices
   • Images can be accessed via the provided URLs
   • Product descriptions contain valuable marketing content

4. Common Use Cases

   • Price monitoring
   • Product catalog building
   • Market analysis
   • Inventory tracking
   • Content aggregation

5. Best Practices

   • Cache results when possible to avoid unnecessary API calls
   • Respect Shein's rate limits
   • Verify SKUs before running the actor
   • Monitor your API usage

Tips for Success

• Start with a small number of SKUs to familiarize yourself with the output format
• Keep track of which country codes you're using for consistent pricing data
• Save your commonly used SKUs for quick reference
• Use the error messages to troubleshoot any issues that arise

Remember to always review Shein's terms of service and ensure your use of the actor complies with their policies and local regulations.