Shein Product Image Search

What does Shein Product Image Search do?

Shein Product Image Search is a specialized web scraper that enables visual product search on the Shein website by uploading an image. It finds similar products based on the visual characteristics of the provided image, returning comprehensive product information with all available data from Shein's API.

This actor supports the following features:

• Visual Search by Image: Upload an image (via file path, URL, or raw bytes) to find visually similar products on Shein.
• Comprehensive Country Support: Supports 23 countries with appropriate currency and language settings (US, UK, DE, FR, ES, IT, EUR, ROE, CA, AU, NL, AT, CH, SE, PL, PT, JP, ZA, KR, MX, SG, IL, TR).
• Complete Product Data Extraction: Retrieves all available product information including detailed pricing, brand information, promotions, material specifications, stock data, and technical metadata.
• Structured Output Format: All raw API data is organized into logical sections (pricing, images, brand_info, availability, etc.) for easy data consumption.
• Customizable Results: Filter results to include or exclude out-of-stock products, limit the number of returned products, and select specific output fields.
• Multiple Data Views: Access data through overview, detailed, or complete views depending on your needs.

Supported Countries

The actor supports 23 countries with localized pricing and currency conversion:

• 🇺🇸 US - United States (USD)
• 🇬🇧 UK - United Kingdom (GBP)
• 🇩🇪 DE - Germany (EUR)
• 🇫🇷 FR - France (EUR)
• 🇪🇸 ES - Spain (EUR)
• 🇮🇹 IT - Italy (EUR)
• 🇪🇺 EUR - Europe General (EUR)
• 🇪🇺 ROE - Rest of Europe (EUR)
• 🇨🇦 CA - Canada (CAD)
• 🇦🇺 AU - Australia (AUD)
• 🇳🇱 NL - Netherlands (EUR)
• 🇦🇹 AT - Austria (EUR)
• 🇨🇭 CH - Switzerland (CHF)
• 🇸🇪 SE - Sweden (SEK)
• 🇵🇱 PL - Poland (PLN)
• 🇵🇹 PT - Portugal (EUR)
• 🇯🇵 JP - Japan (JPY)
• 🇿🇦 ZA - South Africa (ZAR)
• 🇰🇷 KR - South Korea (KRW)
• 🇲🇽 MX - Mexico (MXN)
• 🇸🇬 SG - Singapore (SGD)
• 🇮🇱 IL - Israel (ILS)
• 🇹🇷 TR - Turkey (TRY)

Input Parameters

Field	Type	Description
image_source	string or bytes	(required) The image to use for visual search. Can be a local file path (e.g., "sample.jpg"), an image URL (e.g., "https://example.com/image.jpg"), or raw image bytes (for Apify file uploads).
country	string	(optional) Country code for pricing and currency. Supported countries: US (United States), UK (United Kingdom), DE (Germany), FR (France), ES (Spain), IT (Italy), EUR (Europe General), ROE (Rest of Europe), CA (Canada), AU (Australia), NL (Netherlands), AT (Austria), CH (Switzerland), SE (Sweden), PL (Poland), PT (Portugal), JP (Japan), ZA (South Africa), KR (South Korea), MX (Mexico), SG (Singapore), IL (Israel), TR (Turkey). Default is "US".
max_results	integer	(required) Maximum number of products to return (1-50). Default is 5.
include_out_of_stock	boolean	(optional) If true, includes out-of-stock products in the results. Default is false.
use_proxy	boolean	(optional) If true, uses Apify proxy for requests. Default is false.
fields	array of strings	(optional) Specific fields to include in the output. Leave empty for all fields. Due to the comprehensive nature of the new output structure, you can specify nested field paths like pricing.sale_price.amount_with_symbol or top-level sections like pricing, images, brand_info, availability, etc.

Check the Input Tab for more details.

Output Structure

The actor now returns comprehensive product data organized into logical sections:

• Core Identification: rank, goods_id, goods_sn, product_relation_id, spu, from_sku_code
• Product Information: name, goods_url_name, detail_url, category_id, category_name, parent_ids
• Pricing: Complete pricing structure with sale prices, retail prices, discount information, and currency details
• Images: Product images, color variants, detail images, and matching search image
• Brand Information: Brand name, ID, collection details, and series information
• Availability: Stock status, sale status, sold out information
• Store Information: Store codes, mall codes, business model data
• Product Labels: Common labels, feature subscripts, and product information labels
• Services: Quick shipping, clearance status, plus size availability
• Promotions: Detailed promotion information, coupons, and discount data
• Product Material: Material specifications, positioning info, styling details
• Display Information: Price display styles, ordering information
• Media: Video URLs and additional media content
• Tags: Relevance scoring, recommendation data, and technical metadata

Available Data Views

The actor provides three data views in the Apify dataset:

1. Overview: Most important fields for quick product assessment
2. Detailed: Essential business fields with structured nested data
3. Complete: All available raw data in formatted structure

Tips

• Ensure the image provided is clear and relevant to the product type you want to search for to get accurate results.
• Supported image formats include JPEG, JPG, PNG, WEBP, BMP, and GIF, with a maximum size of 10MB.
• For best results, use high-quality images with dimensions of at least 50x50 pixels.
• The actor now returns comprehensive product data - use the different dataset views (Overview, Detailed, Complete) based on your needs.
• Access nested data using dot notation in field selection (e.g., pricing.sale_price.amount_with_symbol).
• You can watch Apify Tutorials on how to use actors for more guidance.

Input Examples

Searching with a Local Image File

{
  "image_source": "/path/to/sample.jpg",
  "country": "US", 
  "max_results": 10,
  "include_out_of_stock": false,
  "use_proxy": false
}

Searching with an Image URL (European Market)

{
  "image_source": "https://example.com/image.jpg",
  "country": "DE",
  "max_results": 5,
  "include_out_of_stock": false,
  "use_proxy": false,
  "fields": ["rank", "name", "images", "pricing", "brand_info"]
}

Searching with Specific Field Selection

{
  "image_source": "https://example.com/image.jpg",
  "country": "AU",
  "max_results": 3,
  "include_out_of_stock": true,
  "use_proxy": true,
  "fields": [
    "rank", 
    "name", 
    "pricing.sale_price.amount_with_symbol",
    "images.product_image",
    "brand_info.brand_name",
    "availability.stock"
  ]
}

Output Example

The search results are returned with comprehensive product data organized into logical sections. Here's an example of the new structured output:

{
  "search_timestamp": "2025-08-21T14:32:19.456539Z",
  "products": [
    {
      "rank": 1,
      "goods_id": "16477982",
      "goods_sn": "sz2304220335048708",
      "product_relation_id": "z23042203350",
      "spu": "z23042203350",
      "from_sku_code": "I32awn2ly9cy",
      "name": "SHEIN Essnce Striped Print Button Front Vest Blazer & Wide Leg Trousers",
      "goods_url_name": "SHEIN-Essnce-Striped-Print-Button-Front-Vest-Blazer-Wide-Leg-Trousers",
      "detail_url": "https://m.shein.com/us/SHEIN-Essnce-Striped-Print-Button-Front-Vest-Blazer-Wide-Leg-Trousers-p-16477982-cat-2977.html?lang=en",
      "category_id": "2977",
      "category_name": "Women Suit Sets",
      "parent_ids": ["4436", "2030", "2036"],
      "pricing": {
        "currency": "USD",
        "sale_price": {
          "amount": "21.40",
          "amount_with_symbol": "$21.40",
          "usd_amount": "21.40",
          "usd_amount_with_symbol": "$21.40",
          "price_show_style": "21"
        },
        "retail_price": {
          "amount": "32.92",
          "amount_with_symbol": "$32.92",
          "usd_amount": "32.92",
          "usd_amount_with_symbol": "$32.92",
          "price_show_style": "32"
        },
        "discount_info": {
          "retail_discount_percent": "35",
          "unit_discount": "35",
          "original_discount": "6",
          "is_inversion": "1"
        }
      },
      "images": {
        "product_image": "//img.ltwebstatic.com/images3_pi/2023/05/22/16847321004afec99b1bea522074919d2a305adc34_thumbnail_405x552.jpg",
        "goods_color_image": "//img.ltwebstatic.com/images3_pi/2023/05/22/16847321147d470cefa1b79d6087a369b1926273ad.jpg",
        "detail_images": [
          "//img.ltwebstatic.com/images3_pi/2023/05/22/1684732102c9cbfc801d1af41fac23951dcbdecaa4_thumbnail_405x552.jpg",
          "//img.ltwebstatic.com/images3_pi/2023/05/22/16847321052326a2a423bffe1b2887ea9487baa594_thumbnail_405x552.jpg"
        ],
        "matching_image_url": "https://uploaded-search-image-url.jpg"
      },
      "brand_info": {
        "brand_name": "SHEIN",
        "brand_id": "1",
        "brand_code": "10001", 
        "brand_badge_name": "SHEIN",
        "collection_name": "SHEIN Essnce",
        "series_id": "4501",
        "series_logo_url": "https://img.ltwebstatic.com/series-logo.png"
      },
      "availability": {
        "stock": "999",
        "is_on_sale": true,
        "sold_out_status": false,
        "product_stock_check_log": "goodsId| 16477982, stock| 999"
      },
      "store_info": {
        "store_code": "8425465598",
        "mall_code": "1",
        "business_model": "0"
      },
      "services": {
        "quickship": false,
        "is_clearance": "0",
        "is_show_plus_size": "0"
      },
      "promotions": {
        "promotion_info": [
          {
            "typeId": "31",
            "endTime": "2025-08-03 23:59:59",
            "rules": [...]
          }
        ],
        "is_new_coupon": "0",
        "coupon_prices": []
      },
      "tags": {
        "relevance_score": "0.99643326",
        "ext": {
          "rec_mark": "recall_mark_1_0.99643326",
          "fine_mark": "0_fs_0.7191_2873"
        }
      }
    }
  ],
  "total_products_found": 101,
  "error": null
}

Data Organization

• Dataset: Contains individual product records with the comprehensive structure shown above
• Key-Value Store: Stores search metadata including search_timestamp, image_source, country, total_products_found, and returned_products_count
• Multiple Views: Access the same data through different organizational views (Overview, Detailed, Complete) in the Apify platform

Integrations and Shein Product Image Search

Shein Product Image Search can be connected with almost any cloud service or web app thanks to integrations on the Apify platform. You can integrate with Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive, and more. Alternatively, use webhooks to trigger actions when events occur, such as receiving a notification when the actor successfully completes a run.

Using Shein Product Image Search with the Apify API

The Apify API provides programmatic access to the Apify platform, allowing you to manage, schedule, and run actors, access datasets, monitor performance, fetch results, and more. Use the apify-client NPM package for Node.js or the apify-client PyPI package for Python.

Check out the Apify API reference docs for full details.

Giving Feedback

If you have any feature requests or bug reports, please create an issue on the Issues page.

Custom Pricing & Contact Details

If you want custom price for enterprise/corporate level or you want to suggest any changes, Please contact me via my apify's profile contact details. If you need urgent help you can also ping me at my Website.