OLIVE YOUNG Global K-Beauty Scraper 🧴

Scrape best-seller rankings, keyword search results, and category listings from OLIVE YOUNG Global — Korea's #1 health & beauty retailer and the single most important storefront for K-beauty. Get clean, structured product data (name, brand, USD price, discount, rating, review count, image, product URL) in JSON, CSV, Excel, or via API.

Built for global K-beauty sellers, dropshippers, and market researchers who need to track what's actually selling in Korea — priced and named in English, ready to use.

---

🚀 What it does

Give it a mode and it returns a structured product feed:

Mode	What you get	Example input
ranking	The live Best Sellers sales ranking (up to ~100 products, with rank)	{ "mode": "ranking" }
search	Products matching a keyword, paginated & sortable	{ "mode": "search", "query": "vitamin c serum" }
category	Products in a top-level category	{ "mode": "category", "query": "Skincare" }

Data comes straight from OLIVE YOUNG Global's own public JSON APIs (the same endpoints the website's front-end calls) — so it's fast and reliable, no brittle HTML scraping.

Available categories: Skincare, Makeup, Bath & Body, Hair, Face Masks, Suncare, K-Pop, Makeup Brush & Tools, Accessories, Wellness, Men's Care, Supplements, Food & Drink, Special Value Sets.

---

📥 Input

Field	Type	Default	Description
mode	string	ranking	ranking, search, or category.
query	string	—	Keyword (search) or category name (category). Optional for ranking.
maxItems	integer	100	Max products to return. Ranking returns up to ~100 in one request.
sort	string	MOST_POPULAR	MOST_POPULAR, MOST_RELEVANT, MOST_REVIEWS, LATEST_REGISTRATION, LOWEST_PRICE, HIGHEST_PRICE (search & category only).
proxyConfiguration	object	RESIDENTIAL	Apify proxy. Keep RESIDENTIAL enabled (see note below).

Input example — top skincare products by review count:

{
  "mode": "category",
  "query": "Skincare",
  "maxItems": 100,
  "sort": "MOST_REVIEWS"
}

---

📤 Output

Each product is one dataset record in this shape (real sample from a live run):

{
  "source": "oliveyoung",
  "product_id": "GA230518746",
  "name": "SKIN1004 Madagascar Centella Hyalu-Cica Water-Fit Sun Serum 50mL*2ea (Twin pack)",
  "brand": "SKIN1004",
  "price_usd": 28,
  "sale_price_usd": 22.4,
  "currency": "USD",
  "rating": 4.9,
  "review_count": 9958,
  "category": "search/serum",
  "rank": 1,
  "is_sold_out": false,
  "url": "https://global.oliveyoung.com/product/detail?prdtNo=GA230518746",
  "image_url": "https://cdn-image.oliveyoung.com/prdtImg/1595/430be104-fda8-4dfd-a3a4-34f7df3cfa46.jpg",
  "scraped_at": "2026-07-07T09:32:24.927+09:00"
}

Field notes

• price_usd / sale_price_usd — displayed in USD (the global storefront shows post-margin USD prices). When a product is not discounted, sale_price_usd is null.
• rating / review_count — populated in search and category modes. The ranking feed does not expose a per-product review count, so those fields may be null in ranking mode.
• rank — 1-based position within the returned list/ordering.
• A full 25-record sample lives in samples/sample-output.json.

---

💡 Use cases

• Price monitoring — track USD prices and discounts on hero SKUs across time.
• K-beauty market research — see what's trending in Korea by category and review volume.
• Dropshipping / sourcing — find high-rated, high-review products with images and URLs ready to import into Shopify/Amazon listings.
• AI agents & LLM pipelines — feed a clean JSON product catalog into RAG or a shopping assistant. Pairs with the companion K-Beauty API on RapidAPI.
• Competitive intelligence — monitor best-seller ranking shifts for your brand vs rivals.

---

🌐 Data source & proxy

This actor targets OLIVE YOUNG Global (global.oliveyoung.com), the international storefront — chosen deliberately because it serves English product names and USD prices, which is exactly what global K-beauty sellers need (the Korean-domestic site returns Korean text and KRW). Data is read from the storefront's public ranking and search JSON APIs.

⚠️ Use Apify RESIDENTIAL proxy. OLIVE YOUNG's WAF geo-filters datacenter and non-Korean IP ranges. The default input keeps RESIDENTIAL proxy enabled — leave it on. Without a suitable proxy you may receive HTTP 403/429 or a challenge page instead of JSON, and the run will fail with a clear "Blocked by anti-bot" error.

---

⚖️ Rate & legality note

• Only public, non-personal catalog data is collected — product listings that anyone can see without logging in. No customer or reviewer personal data (no nicknames, profiles, or IDs) is ever scraped.
• Requests are rate-limited (sequential pages, ≥500 ms delay) to stay light on the site.
• You are responsible for complying with OLIVE YOUNG's Terms of Service and applicable law in your jurisdiction. Use the data for research, monitoring, and analytics — not to replicate the storefront.

---

🏃 Run it

On Apify: set your input and click Start. Locally:

npm install
# put your input in storage/key_value_stores/default/INPUT.json
npm start

Results land in the default dataset (Apify) or ./storage/datasets/default (local).