{ "openapi": "3.0.1", "info": { "title": "Olive Young Global Scraper – K-Beauty Products & Reviews", "description": "Scrape Olive Young Global (올리브영) K-beauty products and reviews by keyword or product ID: name, brand, USD price, discount, rating, review text, date, skin type, skin concerns, helpful votes. Korean-site reviews included. No login, no API key, no browser. $2 per 1,000 items.", "version": "0.1", "x-build-id": "zK4s4iP8BYhucUK4I" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/romantic_boysenberry~oliveyoung-review-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-romantic_boysenberry-oliveyoung-review-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/romantic_boysenberry~oliveyoung-review-scraper/runs": { "post": { "operationId": "runs-sync-romantic_boysenberry-oliveyoung-review-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/romantic_boysenberry~oliveyoung-review-scraper/run-sync": { "post": { "operationId": "run-sync-romantic_boysenberry-oliveyoung-review-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": { "mode": { "title": "Mode", "enum": [ "products", "reviews" ], "type": "string", "description": "\"products\": keywords in, one item per product (name, brand, price, rating, review count). \"reviews\": product IDs/URLs (or keywords) in, one item per review.", "default": "products" }, "keywords": { "title": "Search keywords", "type": "array", "description": "Olive Young Global search queries, e.g. \"sunscreen\", \"snail mucin\", \"COSRX\", \"toner pad\". English works best; brand names and Korean also match. In reviews mode each keyword contributes its first maxProductsPerKeyword products.", "items": { "type": "string" } }, "productUrlsOrIds": { "title": "Product URLs or IDs", "type": "array", "description": "Olive Young Global product IDs (GA240824996) or product URLs (https://global.oliveyoung.com/product/detail?prdtNo=GA240824996). Used in addition to keywords.", "items": { "type": "string" } }, "maxItems": { "title": "Max items per keyword / per product", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Products mode: products taken per keyword. Reviews mode: reviews taken per product (per source). Billing is per item pushed.", "default": 50 }, "maxProductsPerKeyword": { "title": "Max products per keyword (reviews mode)", "minimum": 1, "maximum": 48, "type": "integer", "description": "Reviews mode only: how many top search results per keyword to collect reviews for.", "default": 5 }, "reviewSource": { "title": "Review source (reviews mode)", "enum": [ "global", "korea", "both" ], "type": "string", "description": "\"global\": reviews written on global.oliveyoung.com (original language, with skin type/tone/concern, helpful votes, nickname). \"korea\": reviews from the Korean site oliveyoung.co.kr, machine-translated to English (rating, text, date, option, image count). \"both\": the two lists back to back.", "default": "global" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. The JSON endpoints used here answer Apify platform IPs directly, so no proxy is the cheapest working setting. Switch to Apify residential (KR) if runs start failing with Cloudflare challenge errors." } } }, "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 } } } } } } } } } }