{ "openapi": "3.0.1", "info": { "title": "Rent the Runway Designer Rental Catalog Extractor", "description": "Browses or searches Rent the Runway's designer rental catalog by category, designer, occasion, color, and price, returning rental price, retail price, sizes in stock, and ratings.", "version": "1.1", "x-build-id": "QDzhClJRP5uK5f5Qp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataspryva~rent-the-runway-designer-rental-catalog-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataspryva-rent-the-runway-designer-rental-catalog-extractor", "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/dataspryva~rent-the-runway-designer-rental-catalog-extractor/runs": { "post": { "operationId": "runs-sync-dataspryva-rent-the-runway-designer-rental-catalog-extractor", "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/dataspryva~rent-the-runway-designer-rental-catalog-extractor/run-sync": { "post": { "operationId": "run-sync-dataspryva-rent-the-runway-designer-rental-catalog-extractor", "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": "Mode", "enum": [ "category", "search", "designer", "productUrls" ], "type": "string", "description": "What to fetch. Browse a category, search by keyword and filters, pull one or more designers, or enrich specific product URLs/IDs.", "default": "category" }, "category": { "title": "Category", "enum": [ "dresses", "cocktail-dresses", "formal-dresses", "bridesmaid-dresses", "wedding-guest-dresses", "summer-dresses", "maternity-clothes", "tops", "jumpsuits-rompers", "skirts", "pants", "jeans", "shorts", "sweaters", "jackets-coats", "handbags", "jewelry", "sunglasses", "gowns", "all" ], "type": "string", "description": "Category to browse in mode=category. In mode=search, set it to limit a keyword search to that category. \"All categories\" browses the full catalog.", "default": "all" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text search in mode=search, e.g. \"floral dress\". Optional: leave blank and use filters to browse. Site-wide search is used when no category is selected." }, "designers": { "title": "Designers (mode=designer)", "type": "array", "description": "Designer names, IDs or designer URLs. Each one is resolved to the site's designer ID.", "items": { "type": "string" } }, "designer": { "title": "Designer", "enum": [ "any", "derek_lam_10_crosby_x_rtr", "maje", "toccin", "polo_ralph_lauren", "sandro", "tanya_taylor", "alc", "jason_wu_x_rtr", "madewell", "adam_lippes_x_rtr", "hutch", "ronny_kobo_x_rtr", "lauren_ralph_lauren", "staud", "joes_jeans", "veronica_beard", "boss", "peter_som_x_rtr", "31_phillip_lim", "ulla_johnson", "sea_new_york", "rails", "levis", "dress_the_population", "shoshanna", "rosetta_getty_x_rtr", "badgley_mischka", "cece", "farm_rio", "marine_layer", "thakoon_x_rtr", "dl1961", "simkhai", "simonmiller", "splendid", "marissa_webb_x_rtr", "michael_kors", "ieena_for_mac_duggal", "derek_lam_10_crosby", "vince", "diane_von_furstenberg", "theory", "free_people", "tory_burch", "tibi", "bardot", "likely", "jason_wu", "equipment", "joie", "cinq_a_sept", "rachel_zoe", "milly", "parker", "club_monaco", "mara_hoffman", "allsaints", "anine_bing", "anna_sui", "altuzarra", "bcbgmaxazria", "cecilie_bahnsen", "nanette_lepore", "ted_baker", "amanda_uprichard", "maggy_london", "donna_morgan", "jill_jill_stuart", "halston", "watters", "amsale", "reformation", "rachel_antonoff", "blanknyc", "black_halo", "fifteen_twenty", "marie_oliver", "misa_los_angeles", "naadam", "7_for_all_mankind", "hudson", "ganni" ], "type": "string", "description": "Filter a category/search run to one designer. Use Custom designer for anyone outside this curated list.", "default": "any" }, "customDesigner": { "title": "Custom designer", "type": "string", "description": "Any designer name, ID or URL outside the curated list. Overrides the Designer dropdown." }, "productUrls": { "title": "Product URLs or IDs (mode=productUrls)", "type": "array", "description": "Product page URLs or style IDs, e.g. https://www.renttherunway.com/shop/designers/cult_gaia/cassidy_gown or CULTR24.", "items": { "type": "string" } }, "occasion": { "title": "Occasion", "enum": [ "any", "Weekend", "Work", "DateNightOut", "DaytimeEvent", "DateNight", "NightOut", "Party", "WeddingGuest", "Vacation", "FormalAffair", "Cocktail", "BlackTie", "Athleisure", "Lounge", "Bridesmaid", "MotherOfTheBride", "ActiveSport", "ForTheBride", "FourthOfJuly", "LaborDayWeekend", "athleisure", "formalaffair", "bridesmaid", "datenightout", "daytimeevent", "weekend", "forthebride", "party", "vacation", "weddingguest", "work" ], "type": "string", "description": "Where you want to wear it." }, "color": { "title": "Color", "enum": [ "any", "Blue", "Black", "Brown", "Multicolored", "White", "OffWhite", "Green", "Red", "Pink", "Grey", "Purple", "Yellow", "Orange", "Gold", "Silver", "Clear", "RoseGold", "black", "blue", "brown", "gold", "green", "grey", "multicolored", "offwhite", "orange", "pink", "purple", "red", "silver", "white", "yellow" ], "type": "string", "description": "Primary color." }, "embellishment": { "title": "Embellishment", "enum": [ "any", "None", "Buttons", "Pockets", "Belt", "Collar", "Pleats", "Ruffles", "CutOuts", "Smocking", "Embroidered", "Lace", "Drawstring", "Sequins", "Hardware", "LayersExtraFabric", "Sash", "LurexMetallicThreading", "MeshOverlay", "Applique", "NeckStrap", "FringeTassles", "Crochet", "Jacquard", "Tentacles", "RawHem", "Burnout", "FurTrim", "Boning", "Quilted", "Hood", "Beading", "Grommets", "Cuff", "LeatherTrim", "Rhinestones", "FrayedEdging", "MetalDetailing", "Slip", "Bandage", "Bodysuit", "Beaded", "Distressed", "Feathers", "PomPoms", "DenimTrim", "Embossed", "Pearls", "Flocked", "Fringe", "Studded", "VintageFaded", "Yarndye", "cutouts", "embroidered", "lace", "pleats", "pockets", "ruffles", "sequins" ], "type": "string", "description": "Embellishment detail." }, "neckline": { "title": "Neckline", "enum": [ "any", "CrewNeck", "VNeck", "Collared", "SquareNeck", "MockNeck", "Strapless", "ScoopNeck", "Sweetheart", "HalterNeck", "Turtleneck", "BoatNeck", "OneShoulder", "OffTheShoulder", "Asymmetric", "CowlNeck", "None", "PlungeNeck", "TieNeck", "QuarterZip", "SplitNeck", "HighNeck", "ColdShoulder", "Henley", "boatneck", "collared", "cowlneck", "crewneck", "halterneck", "highneck", "mockneck", "offtheshoulder", "oneshoulder", "plungeneck", "scoopneck", "squareneck", "strapless", "sweetheart", "turtleneck", "vneck" ], "type": "string", "description": "Neckline style." }, "stylePersona": { "title": "Style", "enum": [ "any", "ClassicPreppy", "FeminineRomantic", "CasualLaidBack", "Edgy", "Minimalist", "Eclectic", "BohoChic", "bohochic", "casuallaidback", "eclectic", "edgy", "feminineromantic", "minimalist", "classicpreppy" ], "type": "string", "description": "Overall style persona." }, "print": { "title": "Print", "enum": [ "any", "None", "Floral", "Stripe", "PlaidCheck", "Abstract", "Graphic", "Geometric", "AnimalPrint", "ColorBlock", "PolkaDots", "Logo", "JacquardBrocade", "TieDye", "Ombre" ], "type": "string", "description": "Print or pattern." }, "sleeve": { "title": "Sleeve", "enum": [ "any", "LongSleeve", "Sleeveless", "ShortSleeve", "CapSleeve", "34Sleeve", "None" ], "type": "string", "description": "Sleeve length." }, "seasonality": { "title": "Season", "enum": [ "any", "SpringSummer", "Seasonless", "FallWinter" ], "type": "string", "description": "Season the item is intended for." }, "length": { "title": "Length", "enum": [ "any", "Midi", "Ankle", "Hip", "BelowHip", "MidThigh", "Floor", "Mini", "AboveHip", "Short", "Crop", "Knee", "HighLow", "Calf", "MicroMini" ], "type": "string", "description": "Garment length." }, "maternity": { "title": "Maternity", "enum": [ "any", "NotMaternity", "MaternityRelevant", "BumpFriendly", "TrueMaternity", "Nursing" ], "type": "string", "description": "Maternity or bump-friendly fit." }, "weddingOccasion": { "title": "Wedding occasion", "enum": [ "any", "CityWedding", "CountryClubWedding", "NewYearsWedding", "EngagementParty", "VineyardWedding", "BridalShower", "BacheloretteParty", "BeachWedding", "MotherOfTheBride" ], "type": "string", "description": "Wedding setting or event." }, "weddingFormality": { "title": "Wedding formality", "enum": [ "any", "BlackTieOptional", "Cocktail", "BlackTie", "Daytime", "Outdoor" ], "type": "string", "description": "Wedding dress code." }, "sizes": { "title": "Sizes", "type": "array", "description": "Only items available in these sizes. Uses the site's universal 0-22 size scale; letter sizes S/M/L are accepted from older saved inputs.", "items": { "type": "string" } }, "rentalType": { "title": "Rental type", "enum": [ "oneTime", "subscription", "subscriptionAll" ], "type": "string", "description": "One-off rental uses a date, duration and shipping zip. Subscription modes use the membership closet; Subscription (include sold out) includes unavailable styles.", "default": "oneTime" }, "rentalStartDate": { "title": "Rental start date (one-off)", "type": "string", "description": "Start date in YYYY-MM-DD, e.g. 2027-04-17. Leave blank to use the site default (about six months ahead). Sundays are not valid rental start dates." }, "rentalDuration": { "title": "Rental duration (one-off)", "enum": [ "4", "8" ], "type": "string", "description": "Rental length in days. The site supports 4 and 8 days.", "default": "4" }, "zipCode": { "title": "Shipping ZIP code", "type": "string", "description": "US ZIP code used for availability and delivery-window pricing.", "default": "10001" }, "minRentalPrice": { "title": "Min rental price (USD)", "minimum": 0, "maximum": 100000, "type": "number", "description": "Drop items whose rental price is below this amount." }, "maxRentalPrice": { "title": "Max rental price (USD)", "minimum": 0, "maximum": 100000, "type": "number", "description": "Drop items whose rental price is above this amount." }, "minRating": { "title": "Min rating (0-10)", "minimum": 0, "maximum": 10, "type": "number", "description": "Drop items rated below this on Rent the Runway's 0-10 scale." }, "sortBy": { "title": "Sort by", "enum": [ "recommended", "newest", "msrpLowToHigh", "msrpHighToLow", "priceLowToHigh", "priceHighToLow", "ratingHighToLow", "relevance" ], "type": "string", "description": "Order of results. Price sorts by retail (MSRP) value are server-side; rental-price and rating sorts use the fetched candidate window.", "default": "recommended" }, "includeDetails": { "title": "Include product details", "type": "boolean", "description": "Fetch descriptions, fabric, fit notes, attributes, sizes and images from each product page.", "default": true }, "includeAvailability": { "title": "Include size availability", "type": "boolean", "description": "Check which sizes are actually available for the selected date/scope instead of listing every size the item was made in.", "default": true }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Add up to 40 recent reviews per item, including fit feedback and reviewer measurements when available.", "default": false }, "includePriceTiers": { "title": "Include 4-day and 8-day prices", "type": "boolean", "description": "Add both rental price tiers for one-off rentals. Uses one extra request per item.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Upper bound when Include reviews is on. The actor fetches review pages until this bound or exhaustion. Default 200; max 1000.", "default": 200 }, "onlyNew": { "title": "Only new items", "type": "boolean", "description": "Emit only product IDs not seen in a previous run with onlyNew enabled. Uses a persistent key-value store; useful for scheduled price/stock monitors.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on emitted item records. Detail enrichment is practical up to 300 items; larger runs are faster with Include product details off.", "default": 50 } } }, "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 } } } } } } } } } }