Hwahae Scraper - K-Beauty Rankings API (Korean Skincare)

A Hwahae scraper for daily top-20 Korean cosmetics rankings from Hwahae (화해) public ranking pages, Korea's #1 cosmetics review app (10M+ reviews): by category, trending (급상승), by skin type, and by age group. Each product comes with rank change, rating, review count, price, English category names and an aggregated review-topic summary (e.g. "Soothing", "Non-sticky", "Strengthens skin barrier"). It is built for K-beauty resellers, Amazon/TikTok Shop sellers, brand managers and trend reports.

Live-tested on Apify: YES (2026-10-29). 60 ranking rows from the public ranking pages (top 20 per ranking).

Why this actor

• All four Hwahae ranking types (category / trending / skin type / age), top 20 of each, from the public ranking pages only.
• Hwahae's own rank delta (hwahaeRankDelta, isNewOnHwahae) plus a change vs your previous run.
• English everywhere it matters: 140+ category names, skin types, age groups and the most common review topics come from a static dictionary, and Korean brand names are romanized.
• No reviewer data: only product-level aggregates. No review texts, nicknames, ages or skin profiles of individual users.

Input

{ "rankingType": "skin", "skinTypes": ["민감성", "지성"], "categoryCodes": ["001:001", "001:004"], "maxRank": 20 }

Common category codes: 001 all, 001:001 skincare, 001:001:001 toner, 001:001:003 essence/serum, 001:001:005 cream, 001:002 cleansing, 001:003 masks, 001:004 sun care, 001:004:001 sunscreen, 001:005 base makeup, 001:005:005 cushion, 001:007 lip, 001:009 hair, 003 men.

Output

One item per ranked product. Real row from the 2026-10-29 skincare ranking (shortened):

{
  "rankingType": "category", "categoryCode": "001:001", "categoryKo": "스킨케어", "categoryEn": "Skincare",
  "rank": 2, "hwahaeRankDelta": 1, "isNewOnHwahae": false,
  "productId": 2197950, "productName": "히알루로닉 붐 세럼 워터 드롭", "brandName": "아비브", "brandNameRomanized": "Abib",
  "packageInfo": "1.69 fl. oz. 50 mL", "listPriceKrw": 32000, "reviewCount": 3390, "rating": 4.64,
  "topReviewTopics": [{"topicEn": "Breathable"}, {"topicEn": "Blends in"}, {"topicEn": "Has granules"}],
  "rankingUpdatedAt": "2026-10-29 05:00:00", "url": "https://www.hwahae.co.kr/goods/77974"
}

Full field list: see the Output tab (dataset schema).

Pages used (public only)

• https://www.hwahae.co.kr/rankings?english_name=…&theme_id=…: the public ranking page (allowed by robots.txt). Ranks 1 to 20 come from the page's __NEXT_DATA__.
• https://www.hwahae.co.kr/robots.txt is read first; any disallowed path stops the run.
• The actor does not call Hwahae's internal app API (the "load more" JSON behind the page), so ranks 21 to 100 are not available. maxRank is capped at 20.
• Rate: 1 request every 2.5 s, sequential.

Limitations

• Hwahae updates category rankings about weekly and trending rankings daily. Check rankingUpdatedAt.
• shopOfferPriceKrw is the price of Hwahae's shop offer, which can be a bundle. Use listPriceKrw with packageInfo for the single-product list price.
• Review-topic English labels cover the most common topics. Others are null, with the Korean kept.
• Only the top 20 per ranking. Ranks 21 to 100 would need Hwahae's internal API, which this actor does not use.
• This is an unofficial integration and may break if Hwahae changes its site.

API keys

None. This actor reads public pages only, takes no credentials and stores none.

Pricing (pay per event)

• ranking-row: $4.00 per 1,000 rows (English names, categories and review topics included), plus Apify's tiny apify-actor-start event.
• Platform usage is included: you pay only the event prices, not the compute.
• One ranking (20 rows) costs about $0.08; 15 rankings (300 rows) about $1.20.
• Set Max total charge for a run to cap spend; the actor stops early when it is reached.

FAQ

Do I need a Hwahae account or API key? No. It reads Hwahae's public ranking pages only.

How fresh is the data? Trending rankings change daily and category rankings about weekly. Each row carries rankingUpdatedAt. Schedule the actor daily and use rankChangeVsLastRun to see movement.

Can I get ranks beyond 20? No. Ranks 21+ sit behind Hwahae's internal API, which this actor does not use.

Can I use it for Olive Young or Glowpick? Not this actor. Olive Young blocks crawlers in robots.txt, so Hwahae is the legal Korean K-beauty ranking source this actor covers.

Is there an English demo of the data? Yes: K-Beauty Now publishes the same rankings in English every day.