{ "openapi": "3.0.1", "info": { "title": "PrettyLittleThing Fashion Scraper", "description": "Scrape prettylittlething.com fashion products. Search by keyword or browse any category (dresses, tops, co-ords, shoes, accessories, and more). Filter by size, colour, price, and sale status. Returns pricing, sizes, colours, images, and product URLs.", "version": "1.0", "x-build-id": "VM7VvVhZgwioypW6P" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~prettylittlething-fashion-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-prettylittlething-fashion-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/crawlerbros~prettylittlething-fashion-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-prettylittlething-fashion-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/crawlerbros~prettylittlething-fashion-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-prettylittlething-fashion-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": "Mode", "enum": [ "search", "byCategory" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text product search (mode=search). E.g. `denim jacket`, `midi dress`, `bikini`.", "default": "dress" }, "category": { "title": "Category", "enum": [ "womens-new-in", "womens-clothing", "womens-dresses", "womens-tops", "womens-co-ords", "womens-coats-jackets-blazers", "womens-bottoms", "womens-coats-jackets", "womens-skirts", "womens-shorts", "womens-shorts-jorts", "womens-trousers", "womens-athleisure", "womens-activewear", "womens-hoodies", "womens-sweatshirts", "womens-trousers-joggers", "womens-tracksuits", "womens-swimwear", "womens-playsuits-jumpsuits-jumpsuits", "womens-playsuits-jumpsuits-playsuits", "womens-knitwear", "womens-loungewear", "womens-lingerie", "womens-nightwear", "womens-denim", "womens-jeans", "womens-plus-size", "womens-petite", "womens-shape", "womens-tall", "womens-shoes", "womens-shoes-boots", "womens-accessories", "womens-accessories-bags", "womens-accessories-jewellery", "womens-sale", "best-sellers", "trending-now", "womens-occasion-wedding" ], "type": "string", "description": "Category to browse (mode=byCategory).", "default": "womens-dresses" }, "size": { "title": "Size", "enum": [ "any", "4", "6", "8", "10", "12", "14", "16", "18", "20", "22", "24", "26", "28", "30", "32", "34", "36", "38", "40", "42", "44", "46", "XXS", "XS", "S", "M", "L", "XL", "XXL", "2XL", "3XL", "4XL", "5XL", "6XL", "One Size" ], "type": "string", "description": "Only emit products available in this UK size.", "default": "any" }, "color": { "title": "Colour", "enum": [ "any", "Black", "Blue", "Green", "Pink", "White", "Brown", "Red", "Multi", "Beige", "Yellow", "Navy", "Purple", "Orange", "Grey", "Cream", "Khaki", "Gold", "Silver", "Nude", "Ecru", "Metallics", "Neutral", "Clear", "Coral", "Rose Gold" ], "type": "string", "description": "Only emit products in this colour family.", "default": "any" }, "brand": { "title": "Brand", "enum": [ "any", "PrettyLittleThing", "boohoo", "KarenMillen", "Coast", "Wallis", "Dorothy Perkins", "DSGN Studio", "NastyGal", "Oasis", "Linzi", "AX Paris", "Warehouse", "Where's That From", "Urban Bliss", "EGO", "MissPap", "STEVE MADDEN", "Femme Luxe", "XY London", "FS Collection", "Goddiva", "STYLEWISE", "Pink Vanilla", "Busem", "Jon Richard", "Dove", "Dilvin", "Public Desire", "Moda Minx", "TFNC London", "Vesper", "Ann Summers", "Guess", "Marc Jacobs" ], "type": "string", "description": "PrettyLittleThing's storefront is a multi-brand marketplace (PrettyLittleThing house label plus boohoo, KarenMillen, Coast, Wallis, Dorothy Perkins, and 350+ other brands sold on prettylittlething.com). Only emit products from this brand. Use `customBrand` for any brand not in this curated list.", "default": "any" }, "customBrand": { "title": "Custom brand (advanced)", "type": "string", "description": "Any brand name not in the curated `brand` list, matched exactly as it appears on prettylittlething.com (e.g. `Tommy Hilfiger`, `Gucci`, `Yankee Candle`). Overrides `brand` when set." }, "minPrice": { "title": "Min price (GBP)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Drop products cheaper than this (current selling price, in GBP)." }, "maxPrice": { "title": "Max price (GBP)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Drop products more expensive than this (current selling price, in GBP)." }, "onSaleOnly": { "title": "On sale only", "type": "boolean", "description": "Only emit products currently discounted (markdown / sale price).", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on emitted records.", "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 } } }, "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 } } } } } } } } } }