{ "openapi": "3.0.1", "info": { "title": "SSENSE API Scraper", "description": "Search and browse luxury fashion products from SSENSE via its private GraphQL API. Extract product listings with brand, price, images and category data.", "version": "0.0", "x-build-id": "zUCHdhBalsRzOQfcF" }, "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": { "q": { "title": "Search keyword", "type": "string", "description": "Search products by keyword (e.g., 'shirt', 'dress')" }, "gender": { "title": "Gender", "enum": [ "women", "men" ], "type": "string", "description": "Product gender department", "default": "women" }, "languageCode": { "title": "Language", "enum": [ "en", "fr" ], "type": "string", "description": "Language for product names/descriptions", "default": "en" }, "countryCode": { "title": "Country", "enum": [ "US", "CA" ], "type": "string", "description": "Country for pricing and availability", "default": "US" }, "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" }, "includeDetails": { "title": "Include product details", "type": "boolean", "description": "Fetch full product detail for each item (adds description, composition, sizes, etc.). Increases request count by 1 per product.", "default": false }, "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 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Route requests through a proxy (Apify Proxy by default).", "default": { "useApifyProxy": true } }, "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." } } }, "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 } } } } } } } } } }