{ "openapi": "3.0.1", "info": { "title": "Olive Young Product Scraper: Ingredients & Prices", "description": "Scrape Olive Young products from its global store by keyword, category, product URL or best-seller page: price, discount, rating, stock and full ingredient lists, volume and manufacturer on every product at the base price. Optional review statistics. No login.", "version": "0.1", "x-build-id": "xfJZHnaIUBAHvCgfx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pradio~olive-young-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pradio-olive-young-product-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/pradio~olive-young-product-scraper/runs": { "post": { "operationId": "runs-sync-pradio-olive-young-product-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/pradio~olive-young-product-scraper/run-sync": { "post": { "operationId": "run-sync-pradio-olive-young-product-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": { "keyword": { "title": "Keyword, URL or list", "type": "string", "description": "A search term (for example 'laneige'), a category page URL, a product page URL or a product number (GA… or GS…) on Olive Young's global store. One seed per line runs several; each row echoes the line it came from in `input`." }, "maxItems": { "title": "Maximum items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "The most product rows one run returns; the run stops at the cap and the run log says so.", "default": 100 }, "includeReviews": { "title": "Include review aggregates", "type": "boolean", "description": "Also read each product's review aggregates: average rating, star counts, verified-buyer share, latest review date, skin-type counts. Costs extra requests per product. Aggregates only: never review text or reviewer data.", "default": false }, "includeProductInfo": { "title": "Include product info", "type": "boolean", "description": "Also read each product's notice panel: the ingredient list, volume, skin suitability, shelf life, manufacturer and distributor, country of manufacture, and whether the store flags it a functional cosmetic. One extra read per product at the same per-row price.", "default": true }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Keep only rows priced at or above this USD figure. Rows outside the range are dropped before they are emitted, so they are never billed." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Keep only rows priced at or below this USD figure. Rows outside the range are dropped before they are emitted, so they are never billed." }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep only rows whose displayed rating is at least this (0–5). Rows below it, and rows the store shows no rating for, are dropped before they are emitted, so they are never billed." }, "sort": { "title": "Sort", "enum": [ "popular", "newest", "price_low", "price_high", "most_reviews", "highest_rated" ], "type": "string", "description": "The order rows come back in. On a category page URL the store sorts its own list; on a keyword, product URL or product number the store's route takes no order, so the collected rows are re-ordered before they are returned. On the best-seller page the store's rank order always stands and position is the rank.", "default": "popular" } } }, "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 } } } } } } } } } }