Hogangnono Apartment Analytics Scraper — Korea Apartment Price Data & API 🇰🇷🏢

🎉 Turn Korea's most-loved apartment-price site into clean, structured analytics — monthly price stats, valuation, trade history and specs, one record per complex

Built for property analysts, valuation modelers, investors and proptech teams who need Korean apartment price intelligence at scale

---

📋 Overview

Pull Korean apartment-complex (단지) price analytics without lifting a finger — this actor reads Hogangnono (호갱노노) and returns one clean, structured record per apartment complex: latest monthly average / minimum / maximum price, KB-style valuation, real-deal (실거래) trade history, trade volume, household and build specs, exact coordinates and resident-review counts. No account, no API key, no manual copy-paste.

Why teams choose us:

• ✅ Price intelligence, not just listings: every record carries monthly avg/min/max price, max real-trade price, loanable valuation and lifetime trade count
• 📊 Built for analytics: one row per complex, ready to build district price indices, valuation models and trend dashboards
• 🧾 Real-deal history: recent actual (실거래) transactions with price, floor, date and method on every complex
• 🗺️ Region market context: each complex carries its district's price-per-pyeong, trade volume, household count and rank
• 💱 Dual currency built in: every KRW price comes with a USD companion, converted at the run's live exchange rate
• 💰 Pay only for results: transparent per-complex pricing, generous free tier, no subscription

---

✨ Features

• 📍 Scan any Korean district — pass one or more 시군구 region codes (e.g. 11680 = 강남구 / Gangnam-gu) and get the ranked complexes
• 🏢 Target specific complexes — pass exact complex IDs (bg4ed) or /apt/<id> URLs
• 📊 Two depth modes — cheap Overview (KB valuation + specs + geo + region context) or Detail (adds the monthly price time-series 시세)
• 💰 Trade-type aware — price series for sale (매매), jeonse (전세) or monthly rent (월세)
• 🏗️ Full complex specs — households, floors, buildings, parking, heating, builder, build year, floor-area & coverage ratios
• 📈 Trade analytics — lifetime trade count, latest monthly volume, recent real-deal rows
• 🌐 Exact geolocation — precise latitude/longitude + full lot-number and road-name address
• 💬 Community signal — resident-review count, average rating, neighborhood rank
• 💱 Live FX conversion — KRW + USD on every price field
• 📊 Clean exports — JSON, CSV and Excel straight from the dataset

---

🎬 Quick Start

Pick a mode and a region, hit Start, and collect a clean analytics dataset. Overview maps a district cheaply; Detail adds the monthly price time-series per complex.

curl -X POST "https://api.apify.com/v2/acts/sian.agency~hogangnono-apartment-analytics-scraper/runs?token=YOUR_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"scrapeMode": "overview", "regionCodes": ["11680"], "maxResults": 100}'

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose your area

Enter one or more Korean district codes (e.g. 11680 for 강남구), or leave blank to use the default district. To target exact complexes, paste their IDs into Apartment Complex IDs.

Step 2: Pick a mode

Overview for fast, cheap complex analytics — or Detail to add the monthly price time-series. Choose the trade type (sale / jeonse / rent) for the price series.

Step 3: Run and export

Click Start. Download your results as JSON, CSV or Excel.

That's it! In about a minute, you'll have:

• One analytics record per apartment complex with price stats and valuation
• Specs, exact coordinates, region market context and trade history
• KRW and USD pricing on every row

---

📥 Input Configuration

Field	Type	Required	Description
scrapeMode	string	No	overview (cheap analytics) or detail (adds monthly price time-series)
regionCodes	array	No	Korean district (시군구) codes or /region/<code> URLs to scrape (default 11680 = 강남구)
aptHashes	array	No	Specific complex IDs or /apt/<id> URLs — overrides regionCodes
tradeType	string	No	sale (매매), jeonse (전세) or rent (월세) — which transaction type the price series reflects
maxResults	integer	No	Max complexes (FREE: 25, PAID: unlimited)

Example:

{
  "scrapeMode": "detail",
  "regionCodes": ["11680"],
  "tradeType": "sale",
  "maxResults": 50
}

---

📤 Output

Each row is one apartment complex with 60+ fields. Sample (trimmed):

{
  "id": "bg4ed",
  "url": "https://hogangnono.com/apt/bg4ed",
  "complexName": "리버뷰",
  "category": "아파트",
  "monthly_avg_price_krw": 180000000,
  "monthly_avg_price_usd": 130435,
  "max_real_trade_price_krw": 200000000,
  "loanable_trade_price_krw": 90000000,
  "trade_count": 70,
  "total_household": 128,
  "floor_max": 15,
  "heat_type": "중앙난방",
  "builder": "삼윤개발",
  "build_year": 1993,
  "sido": "서울특별시",
  "sigungu": "강남구",
  "dong": "청담동",
  "latitude": 37.522287,
  "longitude": 127.055336,
  "address": "서울특별시 강남구 청담동 68-19",
  "review_count": 8,
  "region": { "full_name": "서울특별시 강남구", "price_per_py_manwon": 9035.94, "latest_trade_count": 180, "price_per_py_rank": 1 }
}

In Detail mode each complex also carries the monthly price time-series (latest avg/min/max + monthly trade volume from the monthly-reports API).

---

💡 Use Cases

• Property analysts building Seoul apartment price indices by district
• Valuation teams calibrating models with KB-style loanable prices and real-deal history
• Investors comparing trade volume and price trends across complexes and neighborhoods
• Proptech teams powering dashboards with fresh Korean apartment price intelligence
• Researchers studying the Korean housing market with structured, geocoded complex data

---

❓ FAQ

Q: What's the difference between Overview and Detail? A: Overview returns the complex profile — KB valuation, specs, geo, review count and region context — cheaply (1 request per complex). Detail adds the monthly price time-series 시세 (latest avg/min/max + monthly volume), at 2 requests per complex.

Q: How do I find a region code? A: Open a district on hogangnono.com and copy the number from the URL — hogangnono.com/region/11680 → 11680 (강남구).

Q: Do I need an account or API key for the source site? A: No. The actor handles everything; you only need your Apify token.

Q: Is this legal? A: Yes — we only extract publicly available data. See the legal note below.

---

🐛 Troubleshooting

No results returned

• Check the region code (it's the 시군구 number, e.g. 11680), or try another district
• Try Overview mode first to confirm the district has ranked complexes

Detail mode is slower

• This is expected — Detail fetches the monthly-reports time-series per complex. Use Overview when you don't need the price series, or lower maxResults.

Hitting the free limit

• The FREE tier caps each run at 25 complexes. Upgrade to PAID for unlimited results.

---

⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the legality of web scraping.

Trademark notice: Hogangnono (호갱노노) is a trademark of its respective owner. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Hogangnono or its operator. All product names and trademarks belong to their respective owners and are used here for identification purposes only.

---

🤝 Support

Join our active support community

• For issues or questions, open an issue in the actor's repository
• Check the SIÁN Agency Store for more automation tools
• ✉️ apify@sian-agency.online

---

Built by SIÁN Agency | More Tools