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: json { "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 javascript // Input { "countryCode": "us" } ### Regional Market Example javascript // Input for German market { "countryCode": "de" } ### Asian Market Example javascript // 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. ---