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 detailed product information.

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.
• Country-Specific Search: Supports multiple countries with appropriate currency and language settings (e.g., US, UK, DE, FR, NL, etc.).
• Product Details Extraction: Retrieves product details such as name, price, currency, product image, matching image URL, product URL, stock status, brand, collection, and more.
• Customizable Results: Filter results to include or exclude out-of-stock products, limit the number of returned products, and select specific output fields.

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 (e.g., "US", "UK", "DE", "NL"). 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 (e.g., ["rank", "name", "product_image"]). Leave empty for all fields. Available fields: rank, goods_id, goods_sn, name, category_id, category_name, price, price_with_symbol, original_price, original_price_with_symbol, discount_percent, currency, product_image, matching_image_url, detail_images, detail_url, brand_name, collection_name, stock, is_on_sale, relevance_score, quickship, material_info.

Check the Input Tab for more details.

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 product_image field represents the main product image from Shein, while matching_image_url is the uploaded image used for the visual search.
• 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

{
  "image_source": "https://example.com/image.jpg",
  "country": "NL",
  "max_results": 2,
  "include_out_of_stock": false,
  "use_proxy": false,
  "fields": ["rank", "name", "product_image", "matching_image_url", "price_with_symbol"]
}

Searching with Image Bytes (for Apify file uploads)

{
  "image_source": "<raw_image_bytes>",
  "country": "DE",
  "max_results": 8,
  "include_out_of_stock": false,
  "use_proxy": true
}

Output Example

The search results are returned as a dictionary with metadata and a list of products, stored in the Apify dataset and key-value store (search_metadata).

{
  "search_timestamp": "2025-07-19T03:00:01.123456Z",
  "products": [
    {
      "rank": 1,
      "goods_id": "16477982",
      "goods_sn": "sz2304220335048708",
      "name": "SHEIN Essnce Striped Print Button Front Vest Blazer & Wide Leg Pants",
      "category_id": "2977",
      "category_name": "Women Suit Sets",
      "price": "27.00",
      "price_with_symbol": "€27.00",
      "original_price": "27.00",
      "original_price_with_symbol": "€27.00",
      "discount_percent": "0",
      "currency": "EUR",
      "product_image": "//img.ltwebstatic.com/images3_pi/2023/05/22/16847321004afec99b1bea522074919d2a305adc34_thumbnail_405x552.jpg",
      "matching_image_url": "https://img.ltwebstatic.com/images3_pi/2023/05/22/16847321004afec99b1bea522074919d2a305adc34_thumbnail_720x.jpg",
      "detail_images": ["//img.ltwebstatic.com/images3_pi/2023/05/22/1684732102c9cbfc801d1af41fac23951dcbdecaa4_thumbnail_405x552.jpg"],
      "detail_url": "https://m.shein.com/nl/SHEIN-Essnce-Striped-Print-Button-Front-Vest-Blazer-Wide-Leg-Pants-p-16477982-cat-2977.html?lang=nl",
      "brand_name": "SHEIN",
      "collection_name": "SHEIN Essnce",
      "stock": "999",
      "is_on_sale": true,
      "relevance_score": "0.99687827",
      "quickship": false,
      "material_info": {
        "twoColumnStyle": {
          "contentType": "Polyester"
        }
      }
    }
  ],
  "total_products_found": 101,
  "error": null
}

• Dataset: Contains individual product records (as shown in the products array above).
• Key-Value Store: Stores metadata under search_metadata with fields like search_timestamp, image_source, country, total_products_found, and returned_products_count.

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.