# OrangeShine Listings Scraper (`piotrv1001/orangeshine-listings-scraper`) Actor The OrangeShine Listings Scraper extracts product listings from OrangeShine.com, capturing wholesale prices, pack ratios, sizes, colors, fabric composition, country of origin, brand info, and images โ€” ideal for product sourcing, assortment planning, and competitive pricing research. - **URL**: https://apify.com/piotrv1001/orangeshine-listings-scraper.md - **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 product listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### ๐Ÿ›๏ธ OrangeShine Wholesale Fashion Scraper Extract **wholesale fashion products** from [OrangeShine](https://www.orangeshine.com) โ€” the B2B marketplace for boutique and apparel retailers. The **OrangeShine Wholesale Fashion Scraper** collects structured product data including **wholesale pricing, pack ratios, fabric composition, colors, images, and country of origin** โ€” perfect for product sourcing, assortment planning, and competitive pricing analysis. Pick a category, set how many items you want, and download clean JSON, CSV, or Excel. Run it on demand or schedule it via the Apify platform with API access, integrations, and monitoring built in. ### โœจ Features - ๐Ÿท๏ธ **Wholesale Pricing** โ€” Get real wholesale prices and sale prices, publicly available without any login. - ๐Ÿ“ฆ **Pack & Size Data** โ€” Extract pack ratios, pack size, and available sizes โ€” the core data wholesale buyers need. - ๐Ÿงต **Rich Product Details** โ€” Optionally enrich each product with fabric composition, color options, country of origin, restock/pre-order status, multiple high-resolution images, and full descriptions. - ๐Ÿ—‚๏ธ **Category Coverage** โ€” Scrape Women, Men, Kids, Shoes, Handbags, Accessories & Jewelry, Beauty, and Home & Decor. - ๐Ÿ†• **New Arrivals Mode** โ€” Scrape only the latest arrivals for fast daily incremental runs. - โšก **Fast & Affordable** โ€” Pay only for the results you get, with no per-start fee. ### ๐Ÿ› ๏ธ How to use the OrangeShine Wholesale Fashion Scraper 1. **Choose a category** โ€“ Select which catalog to scrape (e.g. Women, Shoes, Handbags). 2. **Set your limit** โ€“ Enter `maxItems` to control how many products to collect. 3. **(Optional) Enable full details** โ€“ Turn on **Scrape full product details** to enrich each product with packs, fabrics, colors, country of origin, and all images. 4. **Run the scraper** โ€“ Start the run and download your structured product data in JSON, CSV, Excel, or HTML. ### ๐Ÿ“ฅ Input Configure the run from the **Input** tab or via the API. The input is intentionally simple: | Field | Type | Description | | -------------------- | ------- | ------------------------------------------------------------------------- | | `category` | select | Catalog category to scrape. Default: `women`. | | `newArrivalsOnly` | boolean | Scrape only the newest arrivals (great for daily runs). Default: `false`. | | `scrapeDetails` | boolean | Enrich each product with full detail data. Default: `false`. | | `maxItems` | integer | Maximum number of products to scrape. Default: `50`. | | `proxyConfiguration` | object | Proxy settings. The default works out of the box. | Example input: ```json { "category": "women", "newArrivalsOnly": false, "scrapeDetails": true, "maxItems": 50 } ```` ### ๐Ÿ“Š Sample Output Data The scraper provides structured JSON output. With **Scrape full product details** enabled, each item looks like this: ```json { "id": "96300847", "styleNumber": "TP-MS-1367-06_1", "styleName": "DOT SMOCKED HEM FLUTTER TEE", "productUrl": "https://www.orangeshine.com/styles/perseption/dot-smocked-hem-flutter-tee/96300847/", "brandName": "Perseption", "regularPrice": 10, "price": 10, "isSale": false, "salePrice": 0, "category": "TOPS", "subCategory": "CASUAL", "sizes": ["S", "M", "L", "XL"], "pack": [1, 2, 2, 1], "packTotal": 6, "colors": [ { "colorId": "CRU_0113", "name": "IVORY/BLACK", "colorFamily": "Multi", "swatchImage": "https://media.orangeshine.com/OSFile/OS/ColorSwatch/202606/bd5f62d6.jpg", "isPreOrder": false } ], "fabrics": [ { "name": "POLYESTER", "percent": "95" }, { "name": "SPANDEX", "percent": "5" } ], "countryOfOrigin": "VIETNAM", "isBrokenPack": false, "isRestock": false, "images": [ "https://media.orangeshine.com/OSFile/OS/Pictures/202606/Z/b9568450_Z.jpg", "https://media.orangeshine.com/OSFile/OS/Pictures/202606/Z/b9e389c0_Z.jpg" ], "description": "DOT SMOCKED HEM FLUTTER TEE - V neckline - Flutter sheer sleeves ..." } ``` You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. ### ๐Ÿงพ Data fields | Field | Description | | ------------------------------------------- | -------------------------------- | | `id` | Unique style ID | | `styleNumber` | Vendor style number | | `styleName` | Product name | | `productUrl` | Link to the product page | | `brandName` | Vendor / brand name | | `regularPrice` / `price` / `salePrice` | Wholesale pricing | | `isSale` | Whether the product is on sale | | `category` / `subCategory` / `breadcrumbs` | Product categorization | | `sizes` / `pack` / `packTotal` | Available sizes and pack ratios | | `colors` | Color options with swatch images | | `fabrics` | Material composition | | `countryOfOrigin` | Manufacturing country | | `isBrokenPack` / `isRestock` / `isPreOrder` | Availability flags | | `images` | High-resolution product images | | `description` | Full product description | | `colorCount` | Number of available colors | *Detail-only fields (`sizes`, `pack`, `colors`, `fabrics`, `countryOfOrigin`, `images`, `description`, etc.) are populated when **Scrape full product details** is enabled.* ### ๐Ÿ’ฐ How much does it cost to scrape OrangeShine? This Actor uses a **pay-per-result** model โ€” you only pay for the data you receive, with **no per-run start fee**: | Event | What you get | Price | | ------------------- | ----------------------------------------------------------------------------------- | ----------------- | | **Product listing** | A catalog product row (name, brand, wholesale price, image, URL) | **$0.002 / item** | | **Item detail** | A fully enriched product (packs, fabrics, colors, country, all images, description) | **$0.005 / item** | For example, scraping **1,000 catalog listings** costs about **$2**, and **1,000 fully enriched products** costs about **$5**. Use `maxItems` to cap your spend on any run. ### ๐Ÿ’ก Tips - Start with a small `maxItems` (e.g. 10) and `scrapeDetails` off to preview the data cheaply. - Enable `scrapeDetails` only when you need packs, fabrics, colors, or images โ€” it costs more per item. - Use `newArrivalsOnly` for lightweight daily runs that capture just the latest products. - Schedule runs and connect the output to Google Sheets, Make, Zapier, or your own systems via the Apify API. ### โ“ FAQ **Is it legal to scrape OrangeShine?** This Actor collects only publicly available product data. Always ensure your use complies with OrangeShine's Terms of Service and applicable laws. It does not collect personal data. **Do I need an account or login?** No. Wholesale product data and pricing are publicly accessible. **Can I scrape the entire catalog?** Yes, but the catalog is very large (hundreds of thousands of styles). For large jobs, increase `maxItems` and consider running per category or using `newArrivalsOnly` for incremental updates. **Something isn't working โ€” where do I get help?** Report issues via the **Issues** tab on the Actor page. Custom requirements? Reach out for a tailored solution. # Actor input Schema ## `category` (type: `string`): Which OrangeShine catalog category to scrape. ## `newArrivalsOnly` (type: `boolean`): Scrape only the most recent arrivals in the category instead of the full catalog. Ideal for fast daily incremental runs. ## `scrapeDetails` (type: `boolean`): Enrich each product with full details: all images, color options, size/pack ratios, fabric composition, country of origin, restock/pre-order info and description. Slower and produces richer results. ## `maxItems` (type: `integer`): Maximum number of products to scrape. Use a small number for testing. ## `proxyConfiguration` (type: `object`): Proxy settings. The default works out of the box. ## Actor input object example ```json { "category": "women", "newArrivalsOnly": false, "scrapeDetails": false, "maxItems": 50, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "category": "women", "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("piotrv1001/orangeshine-listings-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "category": "women", "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("piotrv1001/orangeshine-listings-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "category": "women", "proxyConfiguration": { "useApifyProxy": true } }' | apify call piotrv1001/orangeshine-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=piotrv1001/orangeshine-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "OrangeShine Listings Scraper", "description": "The OrangeShine Listings Scraper extracts product listings from OrangeShine.com, capturing wholesale prices, pack ratios, sizes, colors, fabric composition, country of origin, brand info, and images โ€” ideal for product sourcing, assortment planning, and competitive pricing research.", "version": "0.0", "x-build-id": "8PmXbdXUSTnyFpYhr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~orangeshine-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-orangeshine-listings-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/piotrv1001~orangeshine-listings-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-orangeshine-listings-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/piotrv1001~orangeshine-listings-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-orangeshine-listings-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": { "category": { "title": "Category", "enum": [ "women", "men", "kids", "shoes", "handbags", "accessoriesjewelry", "beauty", "home-decor" ], "type": "string", "description": "Which OrangeShine catalog category to scrape.", "default": "women" }, "newArrivalsOnly": { "title": "New arrivals only", "type": "boolean", "description": "Scrape only the most recent arrivals in the category instead of the full catalog. Ideal for fast daily incremental runs.", "default": false }, "scrapeDetails": { "title": "Scrape full product details", "type": "boolean", "description": "Enrich each product with full details: all images, color options, size/pack ratios, fabric composition, country of origin, restock/pre-order info and description. Slower and produces richer results.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum number of products to scrape. Use a small number for testing.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. The default works out of the box.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```