Pricing

Rating

Developer

Actor stats

Categories

Share

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

Supported Country Codes

The actor supports the following country codes:

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

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.