SHEIN Categories Actor Documentation

Overview

The SHEIN Categories Actor is a web scraping tool deployed on the Apify platform that extracts category hierarchies from SHEIN's e-commerce website across different regional markets. The actor retrieves structured category data including category IDs, names, parent-child relationships, and hierarchy levels for women's apparel and related categories.

Features

• Scrapes complete category hierarchies from SHEIN
• Supports 38+ regional markets with different country codes
• Returns structured JSON data with category relationships
• Handles nested subcategories with parent-child mapping
• Provides comprehensive coverage of women's fashion categories

Input Parameters

Required Parameters

Parameter	Type	Description	Default	Required
countryCode	String	Two-letter country code for SHEIN regional site	"us"	Yes

Supported Country Codes

The actor supports the following country codes:

Code	Country	Code	Country	Code	Country
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 Data Structure

The actor returns a structured JSON object containing category hierarchies:

{
  "results": [
    {
      "children": [
        {
          "children": [
            {
              "children": [
                {
                  "children": null,
                  "cat_id": "1727",
                  "cat_name": "Women Short Dresses",
                  "url_cat_id": null,
                  "cat_url_name": null,
                  "goods_type_id": null,
                  "parent_id": "12472",
                  "is_leaf": "1",
                  "cateCorrelation": "0"
                }
              ],
              "cat_id": "12472",
              "cat_name": "Women Dresses",
              "parent_id": "2030",
              "is_leaf": "0"
            }
          ],
          "cat_id": "2030",
          "cat_name": "Women Clothing",
          "parent_id": "4436",
          "is_leaf": "0"
        }
      ],
      "cat_id": "4436",
      "cat_name": "Women Apparel",
      "parent_id": "0"
    }
  ],
  "completedAt": "2025-06-04T12:04:51.531Z"
}

Data Fields Explanation

Field	Type	Description
cat_id	String	Unique category identifier
cat_name	String	Display name of the category
parent_id	String	ID of the parent category ("0" for root)
is_leaf	String	"1" if leaf category, "0" if has children
children	Array/null	Array of child categories or null if leaf
url_cat_id	String/null	URL-specific category ID
cat_url_name	String/null	URL-friendly category name
goods_type_id	String/null	Product type identifier
cateCorrelation	String	Category correlation value

Category Hierarchy Examples

The actor captures comprehensive category structures including:

Main Categories

• Women Apparel (Root category)
  • Women Clothing
  • Women Plus Clothing
  • Weddings & Events

Women Clothing Subcategories

• Women Dresses

  • Women Short Dresses
  • Women Mini Dresses
  • Women Long Dresses
  • Women Midi Dresses

• Women Tops, Blouses & Tee

  • Women Blouses
  • Women T-Shirts
  • Women Tank Tops & Camis
  • Women Tops

• Women Bottoms

  • Women Skirts
  • Women Pants
  • Women Shorts

• Women Outerwear

  • Women Coats
  • Women Jackets
  • Women Winter Coats
  • Women Faux Fur Coats

• Women Beachwear

  • Women Bikini Sets
  • Women One-Pieces
  • Women Cover Ups
  • Women Swimming & Diving Suit

Usage Examples

Basic Usage

// Input
{
  "countryCode": "us"
}

Regional Market Example

// Input for German market
{
  "countryCode": "de"
}

Asian Market Example

// Input for Japanese market
{
  "countryCode": "jp"
}

Error Handling

The actor includes comprehensive error handling:

• Missing Country Code: Throws error if countryCode is not provided
• Network Errors: Handles connection issues and API failures
• Invalid Country Code: Validates against supported country list
• Empty Results: Gracefully handles cases with no categories found

Best Practices

1. Country Code Selection: Choose the appropriate country code for your target market
2. Data Processing: The hierarchical structure allows for easy tree traversal
3. Caching: Consider caching results as category structures change infrequently
4. Error Handling: Always check for successful completion before processing results

Use Cases

• E-commerce Analysis: Understanding SHEIN's category structure
• Competitive Research: Analyzing product categorization strategies
• Market Research: Comparing category availability across regions
• Data Integration: Feeding category data into business intelligence systems
• Automation: Building automated product categorization tools

Technical Requirements

• Platform: Apify Cloud Platform
• Runtime: Node.js environment
• Dependencies: Built-in Apify SDK
• Execution: Serverless container execution

Monitoring and Logging

The actor provides comprehensive logging:

• Input parameter validation
• Scraping progress updates
• Success/failure notifications
• Performance metrics
• Error details and stack traces

Data Export Options

Results can be exported in multiple formats:

• JSON (default)
• CSV (flattened structure)
• Excel
• XML
• RSS

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.

---