{ "openapi": "3.0.1", "info": { "title": "🛍️ SHEIN Product Scraper — Prices, Ratings & Reviews", "description": "Search SHEIN by keyword or paste product links and export one clean row per product — title, sale price, original price, discount, rating, review count, image and product URL. Download as JSON, CSV or Excel.", "version": "1.0", "x-build-id": "XW2t5wA6ZcEj8KcOC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hipersoft~shein-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hipersoft-shein-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/hipersoft~shein-scraper/runs": { "post": { "operationId": "runs-sync-hipersoft-shein-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/hipersoft~shein-scraper/run-sync": { "post": { "operationId": "run-sync-hipersoft-shein-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "One or more keywords or phrases to search on SHEIN (e.g. \"dress\", \"men hoodie\", \"summer sandals\"). Each query is paged through and returns matching products with title, price, rating and more.", "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Optional list of SHEIN product page URLs (or bare product ids) to pull full details for — price, original price, stock, variants and images. Paste links straight from your browser.", "items": { "type": "string" } }, "country": { "title": "Storefront country", "enum": [ "US", "GB", "IE", "FR", "DE", "ES", "IT", "NL", "BE", "AT", "PT", "FI", "GR", "SE", "DK", "NO", "CH", "PL", "CZ", "RO", "HU" ], "type": "string", "description": "Which SHEIN storefront to read. Prices, currency, discounts and availability all follow this country.", "default": "US" }, "sortBy": { "title": "Sort results by", "enum": [ "recommended", "most_popular", "newest", "price_low_to_high", "price_high_to_low" ], "type": "string", "description": "Order the search results. 'Recommended' is the storefront default.", "default": "recommended" }, "minPrice": { "title": "Min price", "type": "string", "description": "Only return products at or above this price, in the storefront's own currency (e.g. 20). Leave empty for no minimum." }, "maxPrice": { "title": "Max price", "type": "string", "description": "Only return products at or below this price, in the storefront's own currency (e.g. 100). Leave empty for no maximum." }, "categoryId": { "title": "Category ID", "type": "string", "description": "Only return products in one category. Every scraped row includes its own catId, so run a search first and copy the ID you want. Leave empty for all categories." }, "maxItemsPerQuery": { "title": "Max items per query", "minimum": 1, "type": "integer", "description": "Maximum number of products to collect for each search query.", "default": 100 }, "maxItems": { "title": "Max items (overall)", "minimum": 0, "type": "integer", "description": "Maximum number of products to collect across everything (0 = no overall limit).", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Required. A residential proxy is needed for this Actor to reach SHEIN reliably. The default (Apify residential, US) works out of the box — leave it as is unless you have a specific proxy setup.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }