Yes24 Bestseller Scraper 📚

Scrape the bestseller charts from Yes24 (예스24) — Korea's largest online bookstore and a top physical K-pop album retailer. Get clean, structured chart data (rank, title, author/artist, publisher/label, list & sale price in KRW, rating, review count, Yes24 sales index, publication date, image, product URL) in JSON, CSV, or Excel.

Yes24 is where Korean reading demand and K-pop album demand become measurable: its book chart tracks the K-lit wave (post-Han-Kang-Nobel), and its CD/LP chart is effectively a K-pop album sales chart — Yes24's physical album sales feed Korea's Hanteo/Circle charts.

Try it free. Apify's free plan includes $5 of monthly platform credit — roughly 2,000 results from this actor, no credit card required. Set your input, click Start, and export JSON/CSV/Excel.

---

🚀 What it does

Give it a chart and it returns the ranked bestseller list:

Chart	What you get	Example input
books	The overall Korean book bestseller chart (~1,000 ranked titles)	{ "category": "books" }
music	The CD/LP chart — K-pop albums, ranked by sales	{ "category": "music" }

Power users can pass any raw Yes24 categoryNumber (e.g. 002 foreign books, or a deep book sub-genre code) to chart any category in the site's tree, and set how many chart rows to pull (maxItems).

---

📥 Input

Field	Type	Default	Description
category	string	books	books (Korean book chart) or music (CD/LP — K-pop album chart).
categoryNumber	string	—	Advanced: raw Yes24 category code that overrides category (any code from the bestseller page's category tree).
maxItems	integer	100	Max chart rows to return (paginated at 24 per request, chart runs ~1,000 deep).
proxyConfiguration	object	off	Optional Apify proxy. Not required — enable for IP diversity at scale.

Input example — top 100 K-pop albums by sales:

{
  "category": "music",
  "maxItems": 100
}

---

📤 Output

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

{
  "source": "yes24",
  "product_id": "193401355",
  "rank": 1,
  "title": "박효신 - A & E",
  "author": "박효신",
  "publisher": "지니(genie)뮤직",
  "price_krw": 166700,
  "sale_price_krw": 135000,
  "rating": 8.4,
  "review_count": 20,
  "sales_point": 154440,
  "published_date": "2026-08",
  "category": "music",
  "category_number": "003",
  "url": "https://www.yes24.com/product/goods/193401355",
  "image_url": "https://image.yes24.com/goods/193401355/L",
  "scraped_at": "2026-07-10T15:19:58.256+09:00"
}

Field notes

• rank — 1-based chart position as printed by Yes24.
• author — the public commercial attribution printed on the chart card: author (plus credited translator/illustrator) for books, artist/group name for albums. No personal contact details, profiles, or user IDs are collected.
• publisher — publisher (books) or label/distributor (albums).
• price_krw / sale_price_krw — list price and current selling price, integer KRW (equal when there is no discount).
• sales_point — Yes24's own sales index (판매지수), a demand metric that lets you compare sales momentum between titles and across snapshots — more informative than rank alone.
• rating — Yes24 member review score on a 0–10 scale; review_count — number of member reviews. Both are null when a title has no reviews yet (common for pre-order albums — see limitations).
• published_date — publication/release date normalized to ISO (2026-08), including future dates for pre-orders.
• A 25-record real sample (15 books + 10 albums) lives in samples/sample-output.json.

---

💡 Use cases

• K-lit rights scouting — Korean fiction is the hottest rights market since Han Kang's Nobel. See what Korea is actually reading now, with author, publisher and a real sales index — before it surfaces in English-language trade press.
• K-pop album sales signals — the CD/LP chart ranks physical album demand (including pre-orders with future release dates), the same physical sales that drive Hanteo/Circle chart outcomes. Track versions, box sets and label activity per group.
• Publishing market research — genre trends, price points, discount depth, and publisher share of the top 1,000, snapshot by snapshot.
• Price monitoring — list vs. sale price across the chart, per publisher or label.
• AI agents & LLM pipelines — feed a clean, ranked JSON catalog of what Korea reads and listens to into RAG or a trend-analysis assistant.

---

🌐 Data source

This actor reads Yes24's public bestseller chart pages — the same server-rendered HTML any visitor sees at yes24.com/product/category/bestseller. No login, no private API. The pages are served without a bot challenge, so no proxy is required; you can enable an Apify proxy for IP diversity when running at scale.

---

⚠️ Known limitations (honest notes)

• rating / review_count depend on reviews existing. On the book chart nearly every item has them (39/40 in live tests). On the music chart most entries are new or pre-order albums that have no reviews yet, so those two fields are often null there (9/40 populated in live tests). All other fields populate on both charts.
• rating is on a 0–10 scale (Yes24's review score), not the 5-star scale most platforms use.
• sales_point is Yes24's proprietary index, not a unit-sales figure. It is comparable between titles and across time, but not convertible to absolute copies sold.
• Chart depth is ~1,000 items per category — this is a bestseller chart scraper, not a full catalog crawler.

---

⚖️ Rate & legality note

• Only public, non-personal chart data is collected — listings anyone can see without logging in. No personal data (no reader reviews, reviewer nicknames, profiles, or user IDs). author and publisher are public commercial attribution — author/artist and publisher/label names, like a shop name.
• Requests are rate-limited (sequential pages, ≥500 ms delay) to stay light on the site.
• You are responsible for complying with Yes24's Terms of Service and applicable law in your jurisdiction. Use the data for research, monitoring, and analytics — not to replicate the platform.

---

❓ FAQ

Is it legal to scrape this data? This actor collects only public, non-personal chart data — the same bestseller lists any visitor sees on Yes24 without logging in. No personal data is collected (reader reviews, nicknames, and profiles are never parsed; author/artist names are public commercial attribution). You are responsible for how you use the data; see the rate & legality note above.

What does it cost in practice? $2.50 per 1,000 results (launch pricing) + a few cents of platform usage. Example: snapshotting the top 500 books daily costs about $1.25/day. Apify's free $5 monthly credit covers ~2,000 results.

Do I need to configure proxies? No — the default settings work out of the box. Optionally, enable an Apify proxy for IP diversity when running at scale.

How fresh is the data? Every run scrapes the live Yes24 chart at run time (Yes24 recomputes its bestseller ranking on a rolling basis). Schedule the actor for daily/weekly time series.

Can I scrape a specific genre instead of the overall chart? Yes — pass the genre's raw code in categoryNumber (any code from the bestseller page's category tree, e.g. a Korean-fiction sub-genre). The books/music presets cover the two headline charts.

What is NOT included? Reader reviews and any reviewer identity (never collected), unit sales figures (sales_point is Yes24's own index), and products outside the bestseller charts (~1,000 items deep per category).

---

🇰🇷 More Korean data actors

This actor is part of a suite of Korean-platform scrapers by the same maintainer:

• ktown4u-scraper — global K-pop album & goods store, product and price data.
• pocamarket-scraper — K-pop photocard marketplace, listing & price data.
• wadiz-scraper — Korea's largest reward crowdfunding platform, campaign & funding data.

Browse all: apify.com/kdatafactory

---

🏃 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).

---

If this actor saves you time, a rating on the Store page helps a solo maintainer a lot. Found an issue? Open it in the Issues tab — I respond fast.