{ "openapi": "3.0.1", "info": { "title": "SSENSE Product Scraper – Designer Prices, Sizes & Stock", "description": "Scrape SSENSE designer fashion products by keyword or by any of ~190 categories, for men or women. One row per product: brand, name, category, regular and sale price, discount %, SKU, full-res images and URL. Add details for description, composition, country of origin and per-size stock.", "version": "0.0", "x-build-id": "nTWdFhpxPIV2oTtpQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rl1987~ssense-api-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rl1987-ssense-api-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/rl1987~ssense-api-scraper/runs": { "post": { "operationId": "runs-sync-rl1987-ssense-api-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/rl1987~ssense-api-scraper/run-sync": { "post": { "operationId": "run-sync-rl1987-ssense-api-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": { "mode": { "title": "What to scrape", "enum": [ "search", "details", "sizes" ], "type": "string", "description": "Pick one slice and the run fetches only that, for the products the search finds. \"Search\" returns listing rows with no product-page request at all. The slice modes narrow the request itself, not just the output, so asking for sizes does not download descriptions you are not keeping.", "default": "search" }, "q": { "title": "Search keyword", "type": "string", "description": "Search products by keyword (e.g., 'shirt', 'dress')" }, "category": { "title": "Category", "enum": [ "ACCESSORIES", "ACCESSORIES > Bag Accessories", "ACCESSORIES > Belts & Suspenders", "ACCESSORIES > Blankets", "ACCESSORIES > Cosmetic Cases", "ACCESSORIES > Dog Accessories", "ACCESSORIES > Eyewear", "ACCESSORIES > Eyewear > Glasses", "ACCESSORIES > Eyewear > Sunglasses", "ACCESSORIES > Face Masks", "ACCESSORIES > Fine Jewelry", "ACCESSORIES > Fine Jewelry > Bracelets", "ACCESSORIES > Fine Jewelry > Brooches", "ACCESSORIES > Fine Jewelry > Earrings", "ACCESSORIES > Fine Jewelry > Necklaces", "ACCESSORIES > Fine Jewelry > Rings", "ACCESSORIES > Gift Items", "ACCESSORIES > Gloves", "ACCESSORIES > Hats", "ACCESSORIES > Hats > Aviator", "ACCESSORIES > Hats > Beach Hats", "ACCESSORIES > Hats > Beanies", "ACCESSORIES > Hats > Caps", "ACCESSORIES > Hats > Fedoras & Panama Hats", "ACCESSORIES > Hats > Headbands & Hair Accessories", "ACCESSORIES > Hats > Structured Hats", "ACCESSORIES > Jewelry", "ACCESSORIES > Jewelry > Bracelets", "ACCESSORIES > Jewelry > Brooches", "ACCESSORIES > Jewelry > Cufflinks", "ACCESSORIES > Jewelry > Earrings", "ACCESSORIES > Jewelry > Necklaces", "ACCESSORIES > Jewelry > Pins", "ACCESSORIES > Jewelry > Rings", "ACCESSORIES > Keychains", "ACCESSORIES > Pocket Squares & Tie Bars", "ACCESSORIES > Scarves", "ACCESSORIES > Scarves > Fur & Shearling", "ACCESSORIES > Scarves > Knits", "ACCESSORIES > Scarves > Silks & Cashmeres", "ACCESSORIES > Socks", "ACCESSORIES > Souvenirs", "ACCESSORIES > Souvenirs > Books", "ACCESSORIES > Souvenirs > Magazines", "ACCESSORIES > Souvenirs > Markers", "ACCESSORIES > Souvenirs > Notes & Sketches", "ACCESSORIES > Souvenirs > Posters", "ACCESSORIES > Souvenirs > Soccer Balls", "ACCESSORIES > Tech", "ACCESSORIES > Tech > Headphones", "ACCESSORIES > Tech > Ipad Cases", "ACCESSORIES > Tech > Iphone Cases", "ACCESSORIES > Tech > Laptop Cases", "ACCESSORIES > Ties", "ACCESSORIES > Ties > Bow Ties", "ACCESSORIES > Ties > Neck Ties", "ACCESSORIES > Towels", "ACCESSORIES > Umbrellas", "ACCESSORIES > Wallets & Card Holders", "ACCESSORIES > Wallets & Card Holders > Card Holders", "ACCESSORIES > Wallets & Card Holders > Coin Pouches", "ACCESSORIES > Wallets & Card Holders > Money Clips", "ACCESSORIES > Wallets & Card Holders > Passport Holders", "ACCESSORIES > Wallets & Card Holders > Wallets", "ACCESSORIES > Watches", "BAGS", "BAGS > Backpacks", "BAGS > Briefcases", "BAGS > Clutches & Pouches", "BAGS > Clutches & Pouches > Clutches", "BAGS > Clutches & Pouches > Pouches", "BAGS > Duffle & Top Handle Bags", "BAGS > Messenger Bags & Satchels", "BAGS > Pouches & Document Holders", "BAGS > Shoulder Bags", "BAGS > Tote Bags", "BAGS > Travel Bags", "CLOTHING", "CLOTHING > Activewear", "CLOTHING > Activewear > Dresses", "CLOTHING > Activewear > Hoodies and Zip-Ups", "CLOTHING > Activewear > Leggings", "CLOTHING > Activewear > Outerwear", "CLOTHING > Activewear > Pants", "CLOTHING > Activewear > Sport Bras", "CLOTHING > Activewear > Sport Shorts & Skirts", "CLOTHING > Activewear > Tops", "CLOTHING > Dresses", "CLOTHING > Dresses > Long Dresses", "CLOTHING > Dresses > Mid Length Dresses", "CLOTHING > Dresses > Short Dresses", "CLOTHING > Jackets & Coats", "CLOTHING > Jackets & Coats > Blazers", "CLOTHING > Jackets & Coats > Bombers", "CLOTHING > Jackets & Coats > Coats", "CLOTHING > Jackets & Coats > Denim Jackets", "CLOTHING > Jackets & Coats > Down", "CLOTHING > Jackets & Coats > Fur & Shearling", "CLOTHING > Jackets & Coats > Jackets", "CLOTHING > Jackets & Coats > Leather Jackets", "CLOTHING > Jackets & Coats > Peacoats", "CLOTHING > Jackets & Coats > Trench Coats", "CLOTHING > Jackets & Coats > Vests", "CLOTHING > Jeans", "CLOTHING > Jumpsuits", "CLOTHING > Lingerie", "CLOTHING > Lingerie > Boy Shorts", "CLOTHING > Lingerie > Bras", "CLOTHING > Lingerie > Briefs", "CLOTHING > Lingerie > Corsets", "CLOTHING > Lingerie > Corsets & Bodysuits", "CLOTHING > Lingerie > Robes", "CLOTHING > Lingerie > Shapewear", "CLOTHING > Lingerie > Sleepwear", "CLOTHING > Lingerie > Tanks", "CLOTHING > Lingerie > Thongs", "CLOTHING > Pants", "CLOTHING > Pants > Cargo Pants", "CLOTHING > Pants > Leather Pants", "CLOTHING > Pants > Leggings", "CLOTHING > Pants > Lounge Pants", "CLOTHING > Pants > Sweatpants", "CLOTHING > Pants > Trousers", "CLOTHING > Shirts", "CLOTHING > Shorts", "CLOTHING > Skirts", "CLOTHING > Skirts > Long Skirts", "CLOTHING > Skirts > Mid Length Skirts", "CLOTHING > Skirts > Short Skirts", "CLOTHING > Suits & Blazers", "CLOTHING > Suits & Blazers > Blazers", "CLOTHING > Suits & Blazers > Suits", "CLOTHING > Suits & Blazers > Tuxedos", "CLOTHING > Suits & Blazers > Waistcoats", "CLOTHING > Sweaters", "CLOTHING > Sweaters > Cardigans", "CLOTHING > Sweaters > Crewnecks", "CLOTHING > Sweaters > Hoodies & Zipups", "CLOTHING > Sweaters > Shawlnecks", "CLOTHING > Sweaters > Sweatshirts", "CLOTHING > Sweaters > Turtlenecks", "CLOTHING > Sweaters > V-Necks", "CLOTHING > Swimwear", "CLOTHING > Swimwear > Bikinis", "CLOTHING > Swimwear > Cover Ups", "CLOTHING > Swimwear > One-Piece", "CLOTHING > Swimwear > Swimsuits", "CLOTHING > Tops", "CLOTHING > Tops > Blouses", "CLOTHING > Tops > Bodysuits", "CLOTHING > Tops > Henleys", "CLOTHING > Tops > Polos", "CLOTHING > Tops > Shirts", "CLOTHING > Tops > T-Shirts", "CLOTHING > Tops > Tank Tops", "CLOTHING > Tops > Tank Tops & Camisoles", "CLOTHING > Underwear & Loungewear", "CLOTHING > Underwear & Loungewear > Boxers", "CLOTHING > Underwear & Loungewear > Briefs", "CLOTHING > Underwear & Loungewear > Pyjamas & Loungewear", "CLOTHING > Underwear & Loungewear > Robes", "SHOES", "SHOES > Boat Shoes & Moccasins", "SHOES > Boots", "SHOES > Boots > Ankle Boots", "SHOES > Boots > Biker & Combat Boots", "SHOES > Boots > Chelsea Boots", "SHOES > Boots > Desert Boots", "SHOES > Boots > Lace-Up Boots", "SHOES > Boots > Mid-Calf Boots", "SHOES > Boots > Over the Knee Boots", "SHOES > Boots > Tall Boots", "SHOES > Boots > Wingtip Boots", "SHOES > Boots > Zip Up & Buckled Boots", "SHOES > Espadrilles", "SHOES > Flats", "SHOES > Flats > Ballerina Flats", "SHOES > Flats > Espadrilles", "SHOES > Flats > Lace Ups & Oxfords", "SHOES > Flats > Slippers & Loafers", "SHOES > Heels", "SHOES > Lace Ups & Oxfords", "SHOES > Monkstraps", "SHOES > Sandals", "SHOES > Sandals > Flat Sandals", "SHOES > Sandals > Flip Flops", "SHOES > Sandals > Heeled Sandals", "SHOES > Sandals > Sandals", "SHOES > Shoe Accessories", "SHOES > Slippers & Loafers", "SHOES > Sneakers", "SHOES > Sneakers > High Top Sneakers", "SHOES > Sneakers > Low Top Sneakers", "SHOES > Sneakers > Wedge Sneakers" ], "type": "string", "description": "Browse a category (leave blank to search). Category ids are gender-specific and resolved from the selected gender at runtime." }, "sort": { "title": "Sort order", "enum": [ "LATEST_ARRIVALS", "PRICE_LOW_TO_HIGH", "PRICE_HIGH_TO_LOW", "DISCOUNT_HIGH_TO_LOW", "DISCOUNT_LOW_TO_HIGH" ], "type": "string", "description": "How to sort results", "default": "LATEST_ARRIVALS" }, "gender": { "title": "Gender", "enum": [ "women", "men" ], "type": "string", "description": "Product gender department", "default": "women" }, "productUrls": { "title": "Specific products", "type": "array", "description": "Scrape these products directly instead of searching: a numeric product id, or the product page URL, which ends in that id. One per line. When set, the search inputs are not used - this is the way to monitor a product you already know, rather than whatever a search happens to surface. This path always reads the product page, so it bills the listing row plus whichever of the two slices below are on.", "items": { "type": "string" } }, "includeDetails": { "title": "Include product details", "type": "boolean", "description": "Fetch each product's detail page, which is what fills `description`, `composition`, `countryOfOrigin` and `sizes`. One extra request per product, and each slice you leave on bills its own event on top of the listing row. This switch governs a SEARCH or CATEGORY run only: a run that names products in \"Specific products\" always fetches the product page, because a product id can only be read from there — on that path use \"Include per-size stock\" and \"Include description and composition\" to choose what is fetched and billed.", "default": false }, "includeSizes": { "title": "Include per-size stock", "type": "boolean", "description": "Every size SSENSE lists for the product, with the units left or `out-of-stock`, as one semicolon-separated string in the `sizes` column — e.g. `IT 36: 2 left; IT 37: out-of-stock`. On by default. Billed as its own `sizes-row` event, so switch it off for a description-only run and you are not charged for it.", "default": true }, "includeDescription": { "title": "Include description and composition", "type": "boolean", "description": "Description, composition and country of origin, billed as its own `detail-row` event. On by default. Switch it off for a sizes-only request, which is what a restock monitor wants.", "default": true }, "countryCode": { "title": "Country", "enum": [ "US", "CA", "AU", "AT", "BH", "BE", "CN", "CY", "CZ", "DK", "EE", "FI", "FR", "DE", "GR", "HK", "HU", "IE", "IT", "JP", "LV", "LT", "LU", "MO", "MY", "MT", "NL", "NZ", "NO", "PL", "PT", "QA", "RU", "SG", "SK", "SI", "KR", "ES", "SE", "CH", "TW", "AE", "GB" ], "type": "string", "description": "Country for pricing and availability", "default": "US" }, "languageCode": { "title": "Language", "enum": [ "en", "fr", "ja", "zh", "ko" ], "type": "string", "description": "Language for product names/descriptions", "default": "en" }, "maxItems": { "title": "Max items", "type": "integer", "description": "Maximum number of products to fetch. 0 = unlimited (can be tens of thousands of rows for a broad gender/category browse).", "default": 100 }, "detailConcurrency": { "title": "Detail requests in parallel", "minimum": 1, "maximum": 24, "type": "integer", "description": "How many product-detail requests to have in flight at once. Leave empty and it is picked from the run's memory, which is what actually bounds it. Raising it past what the memory allows gets the run killed with no traceback." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Route requests through a proxy (Apify Proxy by default).", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }