{ "openapi": "3.0.1", "info": { "title": "Quince.com Product Scraper - Prices, Discounts, Reviews & More", "description": "Search products and walk away with selling prices, retail prices, discounts, hero images, and the latest customer reviews for every product, ready to drop into your spreadsheet, dashboard, or BI tool. The Quince.com Product Scraper turns catalog into clean, structured product data in minutes.", "version": "0.1", "x-build-id": "NAR9ovxBaRLHMgr3F" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/techforce.global~quince-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-techforce.global-quince-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/techforce.global~quince-scraper/runs": { "post": { "operationId": "runs-sync-techforce.global-quince-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/techforce.global~quince-scraper/run-sync": { "post": { "operationId": "run-sync-techforce.global-quince-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", "required": [ "mode" ], "properties": { "mode": { "title": "Input Mode", "enum": [ "fuzzy_search", "category", "product_urls" ], "type": "string", "description": "How you want to tell the actor what to scrape.", "default": "fuzzy_search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text query, e.g. \"mongolian cashmere crewneck\". Used only when mode = fuzzy_search.", "default": "" }, "searchLimit": { "title": "Max products from fuzzy search", "minimum": 1, "maximum": 500, "type": "integer", "description": "Cap on products returned by the fuzzy search. Used only when mode = fuzzy_search.", "default": 50 }, "category": { "title": "Category", "enum": [ "/all/new-arrivals", "/women/new-arrivals", "/men/new-arrivals", "/home/new-arrivals", "/baby-&-kids/new-arrivals", "/bags-&-accessories/new-arrivals", "/jewelry/new-arrivals", "/beauty-&-wellness/new-arrivals", "/style-gone-viral", "/linen", "/lookbooks/styled-by-erin-walsh", "/the-spring-edit", "/the-vacation-shop", "/the-workwear-edit", "/all/best-sellers", "/women/best-sellers", "/men/best-sellers", "/home/best-sellers", "/baby-&-kids/best-sellers", "/bags-&-accessories/best-sellers", "/jewelry/best-sellers", "/beauty-&-wellness/best-sellers", "/women", "/women/back-in-stock", "/women/bundle-&-save", "/women/linen", "/styled-by-erin-walsh", "/women/spring-edit", "/women/the-vacation-shop", "/women/the-pattern-edit", "/women/cashmere", "/women/silk", "/women/apparel", "/women/dresses", "/women/shirts-&-blouses", "/women/sweaters", "/women/tees", "/women/pants", "/women/jeans", "/women/jackets", "/women/skirts", "/women/shorts", "/women/blazers", "/women/loungewear", "/women/activewear", "/women/sweatshirts", "/women/intimates-&-shapewear", "/women/swim", "/shop/women/petites", "/womens-plus-sizes", "/women/shop-all-maternity", "/women/jewelry", "/women/jewelry/earrings-all", "/women/jewelry/necklaces-all", "/women/jewelry/rings-all", "/women/jewelry/bracelets-all", "/women/bags-&-leather-goods", "/women/belts", "/women/sunglasses", "/women/socks", "/women/hats-&-scarves", "/home/travel", "/tech-accessories", "/women/shoes", "/women/shoes/flats", "/women/shoes/loafers", "/women/shoes/sandals", "/women/shoes/boots", "/women/shoes/heels", "/women/shoes/sneakers", "/beauty-&-wellness", "/beauty-&-wellness/vitamins-&-supplements", "/beauty-&-wellness/fragrance", "/beauty-&-wellness/haircare", "/beauty-&-wellness/skincare", "/beauty-&-wellness/beauty-&-wellness-tools", "/home/candles", "/men", "/men/back-in-stock", "/men/bundle-&-save", "/men/linen", "/men/the-vacation-shop", "/men/spring-edit", "/men/the-workwear-edit", "/men/cashmere", "/men/apparel", "/men/shirts", "/men/tees", "/men/pants", "/men/shorts", "/men/sweaters", "/men/polos", "/men/jackets", "/men/jeans", "/men/activewear", "/men/sweatshirts-and-sweatpants", "/men/loungewear", "/men/suiting", "/men/underwear", "/men/swimwear", "/men/leather-goods", "/men/fine-jewelry", "/men/belts", "/men/sunglasses", "/men/socks", "/men/hats-scarves-&-gloves", "/men-tech-accessories", "/men/shoes", "/men/shoes/sneakers", "/men/shoes/dress-shoes", "/men/shoes/loafers", "/men/shoes/boots", "/home", "/home/the-outdoor-shop", "/home/limited-edition-colors", "/bedding-style-guide", "/home/premium-brands", "/home/back-in-stock", "/baby/home", "/baby-&-kids/nursery", "/home/luxe-sheets-&-bedding", "/home/sheets-and-pillowcases", "/home/duvet-covers-and-shams/lifestyle", "/home/quilts-and-coverlets", "/home/down-comforters-duvet-&-pillow-inserts", "/home/throws-&-blankets/lifestyle", "/home/bedding-by-fabric/linen?filter=subcollections%3DLinen", "/cotton-bedding", "/home/bedding-by-fabric/bamboo?filter=subcollections%3DBamboo", "/bedding-101", "/home/all-bath", "/home/bath-mats", "/home/shower-curtains", "/home/bathroom-accessories", "/home/robes", "/home/furniture", "/home/living-room-furniture", "/home/bedroom-furniture", "/home/dining-room-furniture", "/home/outdoor-furniture", "/home/lighting", "/home/rugs", "/home/wool-rugs", "/home/performance-rugs", "/home/vintage-rugs", "/home/indoor-outdoor-rugs", "/home/natural-fiber-rugs", "/home/checkerboard-&-grid-rugs", "/home/patterned-rugs", "/home/solid-rugs", "/home/sheepskin-&-hide", "/home/rug-pads", "/home/curtains", "/home/curtains/blackout", "/home/curtains/room-darkening?filter=subcollections%3DRoom%2520Darkening", "/home/curtains/light-filtering?filter=subcollections%3DLight%2520Filtering", "/home/curtains/sheer?filter=subcollections%3DSheer", "/home/curtains/linen-curtains?filter=subcollections%3DLinen%2520Curtains", "/home/all-decor", "/home/pillows-&-decor/lifestyle", "/wall-art", "/home/planters", "/home/decorative-objects", "/home/boxes-and-storage", "/home/mirrors", "/home/coffee-table-books", "/home/kitchen-&-table-linens", "/home/cookware", "/home/table-linens", "/home/glassware", "/home/flatware", "/home/dinnerware", "/home/kitchen-tools-and-cutlery", "/home/kitchen-electrics-home", "/food-and-wine", "/home/candles/candles", "/home/candles/diffusers", "/pets", "/baby-&-kids", "/kids-&-baby/bundle-&-save", "/kids/the-vacation-shop", "/baby-&-kids/linen", "/kid-cashmere", "/baby-&-kids/back-in-stock", "/baby-&-kids/baby-girl", "/baby-girl/swim", "/baby-girl/sleepwear", "/baby-girl/sleep-bags", "/baby-girl/dresses", "/baby-girl/tops-and-bodysuits", "/baby-girl/bottoms", "/baby-girl/sweaters", "/baby-girl/cashmere", "/baby-girl/jackets-and-outerwear", "/baby-girl/rompers", "/baby-girl/sweatshirts-and-sweatpants", "/baby-girl/accessories", "/baby-&-kids/baby-boy", "/baby-boy/swim", "/baby-boy/sleepwear", "/baby-boy/sleep-bags", "/baby-boy/tops-and-bodysuits", "/baby-boy/bottoms", "/baby-boy/sweaters", "/baby-boy/cashmere", "/baby-boy/jackets-and-outerwear", "/baby-boy/rompers", "/baby-boy/sweatshirts", "/baby-boy/accessories", "/baby-&-kids/toddler-girl", "/toddler-girl/swim", "/toddler-girl/sleepwear", "/toddler-girl/sleep-bags", "/toddler-girl/dresses", "/toddler-girl/tops", "/toddler-girl/bottoms", "/toddler-girl/sweaters", "/toddler-girl/cashmere", "/toddler-girl/outerwear", "/toddler-girl/sweatshirts-and-sweatpants", "/toddler-girl/accessories", "/baby-&-kids/backpacks-and-more", "/baby-&-kids/toddler-boy", "/toddler-boy/swim", "/toddler-boy/sleepwear", "/toddler-boy/sleep-bags", "/toddler-boy/tops", "/toddler-boy/bottoms", "/toddler-boy/sweaters", "/toddler-boy/cashmere", "/toddler-boy/outerwear", "/toddler-boy/sweatshirts-and-sweatpants", "/toddler-boy/accessories", "/baby-&-kids/girls", "/girls/swim", "/girls/sleepwear", "/girls/dresses", "/girls/tops", "/girls/bottoms", "/girls/sweaters", "/girls/cashmere", "/girls/outerwear", "/girls/activewear", "/girls/sweatshirts-and-sweatpants", "/girl/accessories", "/baby-&-kids/boys", "/boys/swim", "/boys/sleepwear", "/boys/tops", "/boys/bottoms", "/boys/sweaters", "/boys/cashmere", "/boys/outerwear", "/boys/activewear", "/boys/sweatshirts-and-sweatpants", "/boy/accessories", "/home/travel/carryon-suitcases?filter=subcollections%3DCarry-On%2520Suitcases", "/home/travel/checked-suitcases?filter=subcollections%3DChecked%2520Suitcases", "/home/travel/travel-accessories?filter=subcollections%3DTravel%2520Accessories", "/home/travel/duffles-totes", "/home/travel/backpacks", "/home/travel/garment-bags", "/home/travel?filter=subcollections%3DBundle%2520%2526%2520Save", "/bags-&-accessories", "/women/the-vacation-shop/bags-accessories", "/women/spring-edit/bags-accessories", "/the-workwear-edit/bags-accessories", "/the-handwoven-collection", "/cashmere/cashmere-accessories", "/home/travel/bundle-save?filter=subcollections%3DBundle%2520%2526%2520Save", "/women/bags-&-leather-goods/crossbodies-clutches", "/women/bags-&-leather-goods/totes", "/women/bags-&-leather-goods/belt-bags", "/women/bags-&-leather-goods/backpacks", "/women/bags-&-leather-goods/small-accessories", "/bags-&-accessories/womens-accessories", "/bags-&-accessories/women/hats", "/men/leather-goods/bags-backpacks", "/men/leather-goods/leather-accessories", "/bags-&-accessories/mens-accessories", "/men/belts-and-leather-accessories", "/jewelry", "/women/jewelry/bridal-jewelry", "/jewelry/back-in-stock", "/women/watch-bands", "/men/fine-jewelry/necklaces", "/men/fine-jewelry/rings", "/men/fine-jewelry/bracelets", "/men/fine-jewelry/earrings", "/men/watch-bands", "/gold-bars-collectibles", "/beauty-&-wellness/all", "/beauty-&-wellness/beauty", "/beauty-&-wellness/wellness", "/fitness", "/therabody", "/augustinus-bader", "/ursa-major", "/isdin", "/supergoop", "/virtue", "/living-proof", "/goop", "/ceremonia", "/le-prunier", "/true-botanicals", "/philip-b", "/koba", "/iles-formula", "/irene-forte", "/graduation-gifting", "/gifts/under-$50", "/gift-card", "/gifts/women", "/gifts/men", "/gifts/for-baby-and-kids", "/home/throws-&-blankets", "/cashmere", "/birthday-gifts", "/wedding-and-engagement-gifts", "/housewarming-gifts", "/baby-shower-gifts", "/anniversary-gifts" ], "type": "string", "description": "Pick from Quince's mega-menu. Refreshed via scripts/fetch_categories.py. Used only when mode = category.", "default": "/women/sweaters" }, "categoryMaxProducts": { "title": "Max products per category", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap on products scraped from the chosen category. Used only when mode = category.", "default": 200 }, "productUrls": { "title": "Product URLs", "type": "array", "description": "One or more full PDP URLs to scrape. Used only when mode = product_urls.", "items": { "type": "string", "pattern": "^https?://(www\\.)?quince\\.com/.+" }, "default": [] }, "region": { "title": "Region", "enum": [ "US", "CA" ], "type": "string", "description": "Quince storefront region. Affects pricing and currency.", "default": "US" }, "proxy": { "title": "Apify Proxy Configuration", "type": "object", "description": "Apify Proxy settings. RESIDENTIAL is recommended. If you hit proxy tunnel failures during a run, try a different country (e.g. US -> CA) or a different proxy group, then re-run." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum parallel HTTP requests.", "default": 10 }, "maxRequestRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times to retry a failed network request before giving up.", "default": 3 } } }, "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 } } } } } } } } } }