# Olive Young Global Bestsellers Scraper (`graveled_receiver/oliveyoung-global-bestsellers`) Actor Scrape bestselling K-beauty products from Olive Young Global — ranks, prices, discounts, brands, and review scores. No login required. - **URL**: https://apify.com/graveled\_receiver/oliveyoung-global-bestsellers.md - **Developed by:** [YG](https://apify.com/graveled_receiver) (community) - **Categories:** E-commerce, Travel, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.002 / actor start This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Olive Young Global Bestsellers Scraper Scrape **bestselling K-beauty products** from [Olive Young Global](https://global.oliveyoung.com) — Korea's #1 health & beauty retailer — in seconds. Get product ranks, prices, discounts, brands, review scores, and sold-out status as clean structured data. No login, no cookies, no browser required. ### Why this data? Olive Young is the definitive source of what's trending in Korean beauty. Its Global store ships to 150+ countries, and its bestseller rankings move global K-beauty demand. Use this actor to: - **Track K-beauty trends** — monitor which products and brands are rising before they hit Amazon or TikTok Shop - **Price intelligence** — compare Olive Young prices and discount depth against your own channels - **Product sourcing** — find proven bestsellers for import, resale, or affiliate content - **Market research** — feed structured K-beauty data into dashboards, newsletters, or AI agents ### What you get Each product includes: | Field | Example | |---|---| | `rank` | 1 | | `productNo` | `GA251236199` | | `productName` | `Acupressure Stimulation Gel Sheet 12P` | | `brandName` | `Kyusoku Jikan` | | `priceSale` / `priceNormal` | 8.9 / 12.0 (in delivery-country currency) | | `reviewScore` | 4.8 | | `isSoldOut` | false | | `productUrl` | direct link to the product page | Plus the complete `raw` API payload (30+ fields) for advanced use. ### Input - **Which lists** — Top Orders (sales bestsellers) and/or Review Best (top-reviewed) - **Delivery country** — prices localize to any shipping destination (US, GB, JP, SG, AU, CA, ...) - **Language** — English, Chinese, or Japanese product names - **Max items** — up to ~100 per list ### Usage Runs in under 30 seconds. Schedule it daily to build a **bestseller time series** — rank movements over time are far more valuable than a single snapshot. ```json { "lists": ["order-best"], "deliveryCountry": "US", "language": "en", "maxItems": 100 } ```` ### FAQ **Is this legal?** The actor collects only publicly available, factual, non-personal product data (names, prices, ranks, aggregate scores) from endpoints that the site's robots.txt allows for all crawlers, at a rate well below the site's requested crawl delay. No login, no bot-protection bypass, no review text, no personal data, no image files (URLs only). Review the target site's terms and your local laws before commercial use. **Affiliation:** This actor is an independent tool and is **not affiliated with, endorsed by, or sponsored by CJ Olive Young or OLIVE YOUNG**. All trademarks belong to their respective owners. **How fresh is the data?** Every run fetches live data directly from Olive Young Global. # Actor input Schema ## `lists` (type: `array`): Which bestseller rankings to scrape. ## `deliveryCountry` (type: `string`): ISO country code that prices and availability are calculated for (e.g. US, GB, JP, SG, AU, CA). ## `language` (type: `string`): Language of product names and descriptions. ## `includeSoldOut` (type: `boolean`): Keep products that are currently sold out in the results. ## `maxItems` (type: `integer`): Maximum number of products to return per list (bestseller list serves up to ~100). ## Actor input object example ```json { "lists": [ "order-best" ], "deliveryCountry": "US", "language": "en", "includeSoldOut": true, "maxItems": 100 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "lists": [ "order-best" ], "deliveryCountry": "US" }; // Run the Actor and wait for it to finish const run = await client.actor("graveled_receiver/oliveyoung-global-bestsellers").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "lists": ["order-best"], "deliveryCountry": "US", } # Run the Actor and wait for it to finish run = client.actor("graveled_receiver/oliveyoung-global-bestsellers").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "lists": [ "order-best" ], "deliveryCountry": "US" }' | apify call graveled_receiver/oliveyoung-global-bestsellers --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=graveled_receiver/oliveyoung-global-bestsellers", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Olive Young Global Bestsellers Scraper", "description": "Scrape bestselling K-beauty products from Olive Young Global — ranks, prices, discounts, brands, and review scores. No login required.", "version": "0.1", "x-build-id": "cA0FqJYeapqZQabsj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/graveled_receiver~oliveyoung-global-bestsellers/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-graveled_receiver-oliveyoung-global-bestsellers", "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/graveled_receiver~oliveyoung-global-bestsellers/runs": { "post": { "operationId": "runs-sync-graveled_receiver-oliveyoung-global-bestsellers", "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/graveled_receiver~oliveyoung-global-bestsellers/run-sync": { "post": { "operationId": "run-sync-graveled_receiver-oliveyoung-global-bestsellers", "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": { "lists": { "title": "Which bestseller lists", "type": "array", "description": "Which bestseller rankings to scrape.", "items": { "type": "string", "enum": [ "order-best", "review-best" ], "enumTitles": [ "Top Orders (bestsellers by sales)", "Review Best (top-reviewed products)" ] }, "default": [ "order-best" ] }, "deliveryCountry": { "title": "Delivery country", "type": "string", "description": "ISO country code that prices and availability are calculated for (e.g. US, GB, JP, SG, AU, CA).", "default": "US" }, "language": { "title": "Language", "enum": [ "en", "zh", "ja" ], "type": "string", "description": "Language of product names and descriptions.", "default": "en" }, "includeSoldOut": { "title": "Include sold-out products", "type": "boolean", "description": "Keep products that are currently sold out in the results.", "default": true }, "maxItems": { "title": "Max items per list", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of products to return per list (bestseller list serves up to ~100).", "default": 100 } } }, "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 } } } } } } } } } } ```