Keywords: yes24, korean books, korean bestseller, korea book data, south korea, korean web scraping, naver data, apify actor, korean data extraction

YES24 Book Scraper 🇰🇷📚

Scrape YES24 (예스24) — Korea's largest online bookstore — for bestseller charts, book search results, and detailed product information. Extract titles, authors, prices, ISBNs, ratings, genres, descriptions, and more.

No browser needed — uses fast, lightweight HTML parsing and structured data (JSON-LD). No proxies required.

⚡ Quick Start

Scrape bestseller chart (Top 24)

{
    "mode": "bestseller",
    "category": "all",
    "maxResults": 24
}

Search for books by keyword

{
    "mode": "search",
    "keyword": "파이썬",
    "maxResults": 20
}

Get bestseller chart with full details (ISBN, genre, description)

{
    "mode": "bestseller",
    "category": "novel",
    "fetchDetails": true,
    "maxResults": 50
}

Get detailed info for specific books

{
    "mode": "detail",
    "goodsIds": ["175568752", "109625396"]
}

🎯 Use Cases

• Publishing Market Research — Track Korean book market trends and bestseller movements
• Academic Research — Collect metadata for Korean literature studies and bibliometrics
• Price Monitoring — Track book prices and discounts across categories
• Book Recommendation Systems — Build datasets for book discovery and recommendation engines
• Library Cataloging — Bulk extraction of ISBN, author, publisher, and classification data
• K-Literature Trends — Monitor which Korean authors and genres are trending
• Content Strategy — Data-driven insights for publishers and bookstores
• Translation Scouting — Discover popular Korean books for international translation deals

📥 Input Parameters

Parameter	Type	Default	Description
mode	string	"bestseller"	Scrape mode: bestseller, search, or detail
keyword	string	—	Search keyword (required when mode is search)
category	string	"all"	Bestseller category (see below)
goodsIds	string[]	—	Product IDs for detail mode
fetchDetails	boolean	false	Fetch each book's detail page for ISBN, genre, description
maxResults	integer	24	Maximum books to return (1–500)
proxyConfiguration	object	—	Apify Proxy settings (optional)

Bestseller Categories

Category	Korean Name	Description
all	종합	Overall bestsellers (all categories)
novel	소설/시/희곡	Fiction, poetry, drama
essay	에세이	Essays and memoirs
business	경제/경영	Business and economics
self-help	자기계발	Self-improvement
science	과학	Science
history	역사	History
computer	IT/컴퓨터	Computer science and IT
children	어린이	Children's books
comics	만화	Comics and manga
travel	여행	Travel guides
cooking	요리	Cookbooks
foreign	외국도서	Foreign language books

📤 Output Fields

List mode (search / bestseller)

Field	Type	Description
rank	integer	Bestseller ranking (bestseller mode only)
goodsId	string	YES24 product ID
title	string	Book title
subtitle	string	Subtitle / tagline
productType	string	Product type (도서, eBook, etc.)
author	string	Author name(s)
publisher	string	Publisher name
publishDate	string	Publication date
salePrice	integer	Sale price in KRW
originalPrice	integer	Original price in KRW
discount	string	Discount percentage
rating	float	Customer rating (0–10)
reviewCount	integer	Number of customer reviews
imageUrl	string	Book cover image URL
url	string	Direct URL to product page

Detail mode (or with fetchDetails: true)

All fields above, plus:

Field	Type	Description
isbn	string	ISBN-13
description	string	Book description / synopsis
genre	string[]	Genre categories
keywords	string	SEO keywords
datePublished	string	Publication date (ISO format)
numberOfPages	integer	Page count
bookFormat	string	Format (Paperback, Hardcover, EBook)
language	string	Language code (ko-KR, en, etc.)
tableOfContents	string	Table of contents text
price	integer	Price from structured data
currency	string	Currency code (KRW)
availability	string	Stock availability

Sample Output (bestseller)

{
    "rank": 1,
    "goodsId": "178042058",
    "title": "단단력",
    "subtitle": "선생님과 아이들을 모두 지키는 190일 매일 미션 일력",
    "productType": "도서",
    "author": "이종혁 저/김참외 그림",
    "publisher": "테크빌교육",
    "publishDate": "2026년 03월",
    "salePrice": 15300,
    "originalPrice": 17000,
    "discount": "10%",
    "rating": 10.0,
    "reviewCount": 20,
    "imageUrl": "https://image.yes24.com/goods/178042058/L",
    "url": "https://www.yes24.com/product/goods/178042058",
    "mode": "bestseller",
    "category": "all",
    "scrapedAt": "2026-03-01T00:30:00.000000+09:00"
}

Sample Output (detail)

{
    "goodsId": "175568752",
    "title": "괴수 보존 협회",
    "description": "SF 장르에서 발표하는 작품마다 대중과 평론가를 함께 만족시키며...",
    "isbn": "9791193367230",
    "author": "존 스칼지",
    "publisher": "구픽",
    "datePublished": "2026-02-05",
    "numberOfPages": 364,
    "bookFormat": "Paperback",
    "genre": ["소설/시/희곡", "장르소설", "SF"],
    "keywords": "괴수보존협회, SF란시대의거울, The Kaiju Preservation Society",
    "price": 16200,
    "currency": "KRW",
    "availability": "InStock",
    "language": "ko-KR",
    "imageUrl": "https://image.yes24.com/goods/175568752/xl",
    "url": "https://www.yes24.com/product/goods/175568752",
    "mode": "detail",
    "scrapedAt": "2026-03-01T00:30:00.000000+09:00"
}

💰 Pricing

• $0.50 per 1,000 books — Pay only for results
• Detail page fetching included in the price
• No hidden fees or minimum spend

⚙️ Performance

Mode	Speed	Data
fetchDetails: false	~24 books/sec	Titles, authors, prices, ratings
fetchDetails: true	~3 books/sec	+ ISBN, genre, description, TOC
detail mode	~3 books/sec	Full structured data per book

🔧 Technical Details

• Method: Server-side rendered HTML + JSON-LD structured data parsing
• Rate limiting: Built-in delays to respect YES24's servers
• Proxy: Optional (YES24 doesn't block bots by default)
• Language: Python 3.12+
• No browser: Pure HTTP requests (httpx + BeautifulSoup) — fast and cost-effective
• Encoding: UTF-8 (detail pages) with automatic charset detection

📋 Notes

• YES24 is Korea's largest online bookstore, founded in 1999
• Bestseller charts update daily with 24 books per page
• Product detail pages provide rich JSON-LD structured data (Book + Product schema)
• All public data — no authentication required
• Korean and English search keywords both supported
• The scraper automatically initializes a session for search functionality