{ "openapi": "3.0.1", "info": { "title": "Cult Beauty Scraper: Product Prices & New Arrivals (UK)", "description": "Cult Beauty scraper: category, brand, sale and new-in pages or search terms to one row per product with GBP price, RRP, discount percent, promo text, brand, variant, stock and image. For UK beauty price, markdown and new-arrival watching.", "version": "0.1", "x-build-id": "QG6L5qKmbHrgSJ8vE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/superslowsloth~cultbeauty-products/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-superslowsloth-cultbeauty-products", "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/superslowsloth~cultbeauty-products/runs": { "post": { "operationId": "runs-sync-superslowsloth-cultbeauty-products", "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/superslowsloth~cultbeauty-products/run-sync": { "post": { "operationId": "run-sync-superslowsloth-cultbeauty-products", "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": { "startUrls": { "title": "Category, brand, sale or new-in pages", "type": "array", "description": "Cult Beauty pages to read in full, for example https://www.cultbeauty.co.uk/c/skin-care/serums/, https://www.cultbeauty.co.uk/c/sale/ or https://www.cultbeauty.co.uk/c/whats-new/shop-all/. Use a page that lists products. A landing page that links its own list of everything (/c/skin-care/ links /c/skin-care/shop-all/, a brand page /c/brands/anua/ links /c/brands/anua/shop-all/) is read through that list. A search URL (cultbeauty.co.uk/search/?q=...) is read as that search term. Leave empty to use search terms only.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "What you would type into the Cult Beauty search box, one term per line (for example vitamin c, retinol night cream or red lipstick). Each term is read separately. Cult Beauty sends most terms it recognises to a category, ingredient or brand page, and that whole list is read; any other term is read as search results. A term it cannot match returns no products. A product that two terms both find is returned once, under the first.", "items": { "type": "string" } }, "maxItems": { "title": "Max products per search term or page", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Read at most this many products for each search term or page. The site lists 32 per page, so 100 reads four pages. Up to 10,000 are accepted.", "default": 100 }, "sort": { "title": "Sort order", "enum": [ "popularity", "price-asc", "price-desc", "name", "newest" ], "type": "string", "description": "The order Cult Beauty lists the products in, the same five choices as its own sort menu. 'Popularity' is its default. Choose 'Newest first' to watch new arrivals. The price sorts follow the site's own price index.", "default": "popularity" }, "onlyOnSale": { "title": "Only products on sale", "type": "boolean", "description": "Return only products whose current price is below the RRP (the on_sale field). Products that are not reduced are read but not returned and not charged, and do not count toward Max products.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify's automatic datacenter proxy (the default). cultbeauty.co.uk answered Apify datacenter addresses with its product list on 10 of 10 requests when this actor was built; the residential group was not needed. A refused request is retried from a fresh address.", "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 } } } } } } } } } }