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 json { "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) json { "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 json { "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: json { "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.