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

{
  "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

{
  "query": "summer dress"
}

Advanced Search with Filters

{
  "query": "running shoes",
  "page": 2,
  "perPage": "60",
  "minPrice": "20",
  "maxPrice": "100",
  "countryCode": "us",
  "orderBy": "PriceLowtoHigh"
}

Category-Specific Search

{
  "query": "jacket",
  "categoryId": "12312",
  "countryCode": "de",
  "orderBy": "TopRated"
}

Integration Guide

Using the Actor via Apify API

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

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.

---