SHEIN Search Products Actor Documentation ## Overview The SHEIN Search Products Actor is a powerful web scraping tool deployed on the Apify platform that allows you to search and extract product information from SHEIN's global e-commerce platform. This actor can search for products across different SHEIN regional sites and return comprehensive product data including pricing, images, ratings, and metadata. ## Features - Multi-region Support: Search across 37+ SHEIN regional sites - Flexible Search: Search by keywords with advanced filtering options - Comprehensive Data: Extract detailed product information including prices, images, ratings, and availability - Pagination Support: Navigate through multiple pages of results - Price Filtering: Set minimum and maximum price ranges - Category Filtering: Filter results by specific product categories - Multiple Sort Options: Sort results by popularity, price, ratings, and more ## Input Parameters ### Required Parameters | Parameter | Type | Description | Default | |-----------|------|-------------|---------| | query | string | Search term for products (e.g., 'jacket', 'dress', 'shoes') | "jacket" | ### Optional Parameters | Parameter | Type | Description | Default | Options | |-----------|------|-------------|---------|---------| | page | integer | Page number for pagination (starting from 1) | 1 | Any positive integer | | perPage | string | Number of items to return per page | "120" | "20", "40", "60", "80", "100", "120" | | filter | string | Additional filtering parameters | "" | Custom filter string | | categoryId | string | Specific category ID to filter results | "" | Category-specific ID | | minPrice | string | Minimum price filter (in local currency) | "" | Any positive number | | maxPrice | string | Maximum price filter (in local currency) | "" | Any positive number | | countryCode | string | Two-letter country code for SHEIN regional site | "us" | See supported countries below | | orderBy | string | Sort order for search results | "recommend" | See sort options below | ### Supported 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 | ### Sort Options | Value | Description | |-------|-------------| | recommend | Recommended (default) | | MostPopular | Most Popular | | NewArrivals | New Arrivals | | TopRated | Top Rated | | PriceLowtoHigh | Price: Low to High | | PriceHightoLow | Price: High to Low | ## Output Structure The actor returns a comprehensive JSON structure containing: ### Main Response Structure json { "results": { "pagination": { "page": 1, "perPage": 120, "totalAvailable": 9009, "hasNext": true, "hasPrev": false }, "products": [ // Array of product objects ], "categoryIds": ["1983", "1776", "12312", "1933"] }, "completedAt": "2025-06-04T11:23:39.483Z" } ### Product Object Structure Each product in the products array contains: #### Basic Information - goods_id: Unique product identifier - goods_sn: Product serial number - goods_name: Product title/name - goods_url_name: URL-friendly product name - productUrl: Direct link to product page - spu: Stock keeping unit identifier #### Images - goods_img: Main product image URL - goodsColorImage: Color variant image - detail_image: Array of additional product images - relatedColorNew: Array of color variant images #### Pricing Information - retailPrice: Original retail price with currency formatting - salePrice: Current sale price - discountPrice: Discount amount - retailDiscountPercent: Discount percentage - unit_discount: Unit-level discount percentage #### Category and Classification - cat_id: Category ID - cate_name: Category name (e.g., "Women Lightweight Jackets") - parentIds: Array of parent category IDs #### Availability and Stock - stock: Stock availability status - soldOutStatus: Boolean indicating if sold out - is_on_sale: Sale status indicator #### Brand and Premium Information - premiumFlagNew: Brand information including: - brandName: Brand name - brand_badge_name: Brand display name - brand_logo_url_left: Brand logo URL #### Customer Reviews - comment_num: Total number of reviews - comment_num_show: Formatted review count display - comment_rank_average: Average rating (e.g., "4.77") - percent_overall_fit: Sizing feedback with percentages for true size, large, and small #### Special Features and Labels - trendLabel: Trending information and hashtags - rankInfo: Bestseller rankings and position - salesLabel: Sales volume information - promotionInfo: Active promotions and discounts #### Technical Metadata - store_code: Store identifier - mall_code: Mall/marketplace code - business_model: Business model identifier - quickship: Quick shipping availability ## Usage Examples ### Basic Search json { "query": "summer dress" } ### Advanced Search with Filters json { "query": "running shoes", "page": 2, "perPage": "60", "minPrice": "20", "maxPrice": "100", "countryCode": "us", "orderBy": "PriceLowtoHigh" } ### Category-Specific Search json { "query": "jacket", "categoryId": "12312", "countryCode": "de", "orderBy": "TopRated" } ## Integration Guide ### Using the Actor via Apify API javascript import { ApifyApi } from 'apify-client'; const client = new ApifyApi({ token: 'YOUR_APIFY_TOKEN', }); const input = { query: 'winter coat', page: 1, perPage: '40', countryCode: 'us', orderBy: 'recommend' }; const run = await client.actor('ADD_HERE_THE_ACTOR_ID').call(input); const { items } = await client.dataset(run.defaultDatasetId).listItems(); ### Using with Apify SDK javascript import { Actor } from 'apify'; const input = { query: 'sneakers', minPrice: '30', maxPrice: '150', countryCode: 'uk' }; const run = await Actor.call('ADD_HERE_THE_ACTOR_ID', input); const dataset = await Actor.openDataset(run.defaultDatasetId); const { items } = await dataset.getData(); ## Rate Limits and Best Practices ### Recommended Usage Patterns 1. Batch Processing: Process multiple searches in batches rather than rapid succession 2. Reasonable Pagination: Avoid requesting too many pages in a single run 3. Targeted Searches: Use specific queries and filters to reduce unnecessary data extraction 4. Regional Optimization: Use the appropriate country code for your target market ### Performance Tips - Use smaller perPage values (40-60) for faster response times - Implement delays between consecutive runs - Cache results when possible to avoid redundant requests - Use specific category IDs when searching within known product categories ## Error Handling The actor includes comprehensive error handling for: - Invalid search queries - Network connectivity issues - Rate limiting responses - Invalid country codes or parameters - Product availability changes Common error scenarios and solutions: | Error Type | Cause | Solution | |------------|-------|----------| | Missing Query | Empty or undefined search query | Provide a valid search term | | Invalid Country Code | Unsupported country code | Use one of the supported country codes | | Rate Limited | Too many requests | Implement delays between runs | | No Results | Query returned no products | Try broader search terms or different filters | ## Data Quality and Reliability ### Data Freshness - Product information is extracted in real-time - Prices and availability are current as of the scraping time - Reviews and ratings reflect the most recent data ### Data Accuracy - All pricing information includes proper currency formatting - Image URLs are direct links to SHEIN's CDN - Product URLs are functional links to actual product pages ## Support and Maintenance ### Actor Updates - Regular updates to handle SHEIN website changes - Performance optimizations and bug fixes - New feature additions based on user feedback ### Monitoring - Built-in logging for debugging and monitoring - Success/failure tracking for each search operation - Performance metrics and response time monitoring ## 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. ---