SHEIN Store Keywords Actor Documentation

Overview

The SHEIN Store Keywords actor is designed to extract trending keywords and search terms from SHEIN store pages. This actor helps users identify popular product categories and search terms associated with specific SHEIN stores, which can be valuable for market research, SEO optimization, and competitive analysis.

Features

• Extract trending keywords from SHEIN store pages
• Support for multiple languages and country-specific SHEIN sites
• Configurable language and region settings
• Returns structured keyword data with metadata
• Handles international SHEIN domains and localization

Input Configuration

Required Parameters

storeUrl (required)

• Type: String
• Description: The complete URL of the SHEIN store page you want to scrape keywords from
• Example: https://pt.shein.com/store/home?ici=PageGoodsDetail&main_cate_id=12478&main_goods_id=69536888&rule_poskey=DetailShopItemList&src_identifier=on%3Dstore%60cn%3DSHEIN%20LUNE%60hz%3D0%60ps%3D1_1%60jc%3DthirdPartyStoreHome_3276656780&src_module=DetailBrand&src_tab_page_id=page_goods_detail1749203412328&store_code=3276656780&tab=home

Optional Parameters

lang

• Type: String
• Default: "en"
• Description: Language code for the content (ISO format)
• Example: "en", "pt", "de", "fr"

countryCode

• Type: String
• Default: "us"
• Description: Two-letter country code for SHEIN regional site
• Supported Countries:
  • 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

Input Schema Example

{
  "storeUrl": "https://pt.shein.com/store/home?ici=PageGoodsDetail&main_cate_id=12478&main_goods_id=69536888&rule_poskey=DetailShopItemList&src_identifier=on%3Dstore%60cn%3DSHEIN%20LUNE%60hz%3D0%60ps%3D1_1%60jc%3DthirdPartyStoreHome_3276656780&src_module=DetailBrand&src_tab_page_id=page_goods_detail1749203412328&store_code=3276656780&tab=home",
  "lang": "en",
  "countryCode": "us"
}

Output Structure

The actor returns a JSON object containing keyword data and metadata:

{
  "results": {
    "trendLeaderBoardList": null,
    "trendLeaderBoardExtraConfig": null,
    "keywords": [
      {
        "labelType": null,
        "commentNumShow": null,
        "commentRankAverage": null,
        "brand": null,
        "crowdId": null,
        "siteLang": null,
        "terminal": null,
        "weight": null,
        "word": "women blouses",
        "word_id": "35439",
        "imgSrc": "",
        "pageId": null,
        "pageType": null,
        "pageUrl": null,
        "sort": null,
        "type": "shopWord",
        "from": "search",
        "mall_code_list": null,
        "route_url": null,
        "cateIds": null,
        "categoryChannel": null,
        "wordLabel": null,
        "goodsImg": null,
        "goodsId": null,
        "goodsSn": null,
        "mallCode": null,
        "labelLang": null,
        "fontColor": null,
        "backgroundColor": null,
        "magnifyPart": null,
        "local_goods_id": null
      }
    ],
    "multiTrendKeywords": null,
    "searchTrends": null,
    "is_black_list": "0",
    "trace_id": "ff135cc0fb9d0855",
    "req_id": null
  },
  "completedAt": "2025-06-11T07:11:53.156Z"
}

Output Fields Description

Main Results Object

• keywords: Array of keyword objects containing trending search terms
• trendLeaderBoardList: Trending leaderboard data (if available)
• multiTrendKeywords: Multi-trend keyword data (if available)
• searchTrends: Search trend analytics (if available)
• is_black_list: Indicates if the content is blacklisted ("0" = not blacklisted)
• trace_id: Internal tracking identifier
• completedAt: Timestamp when the scraping was completed

Keyword Object Fields

• word: The actual keyword/search term (e.g., "women blouses")
• word_id: Unique identifier for the keyword
• type: Type of keyword (typically "shopWord")
• from: Source of the keyword (typically "search")
• imgSrc: Associated image URL (if available)
• Additional metadata fields: Various optional fields for advanced analysis

Common Use Cases

1. Market Research: Identify trending product categories in specific regions
2. SEO Optimization: Discover popular search terms for content optimization
3. Competitive Analysis: Analyze keyword strategies of successful SHEIN stores
4. Product Development: Understand consumer demand through trending keywords
5. Localization: Compare keywords across different countries and languages

Best Practices

1. URL Format: Ensure the store URL is complete and properly formatted
2. Regional Targeting: Use appropriate country codes for regional analysis
3. Language Consistency: Match the language parameter with the store's primary language
4. Rate Limiting: Be mindful of request frequency to avoid being blocked
5. Data Freshness: Keywords may change frequently, so consider regular scraping schedules

Error Handling

The actor includes robust error handling for common scenarios:

• Invalid or inaccessible store URLs
• Network connectivity issues
• Missing or malformed input parameters
• Regional access restrictions

Example Usage

Basic Usage

{
  "storeUrl": "https://us.shein.com/store/home?store_code=1234567890"
}

Advanced Usage with Localization

{
  "storeUrl": "https://de.shein.com/store/home?store_code=1234567890",
  "lang": "de",
  "countryCode": "de"
}

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.

---