Sarangbang Korea Property Scraper — Real Estate Data & API 🏠🇰🇷

🎉 Pull every Sarangbang listing into clean JSON or CSV — ~90% of fields straight from the source, no account or API key needed

For Korean real-estate analysts, proptech teams, investors and agencies who need structured property data fast

---

📋 Overview

Need structured property data from one of Korea's biggest real-estate portals? This actor turns Sarangbang (home.sarangbang.com) listings — apartments, villas, officetels, houses and commercial — into clean, ready-to-use datasets across all of South Korea, for sale (매매), jeonse (전세) and monthly rent (월세).

Why teams choose this scraper:

• ✅ ~90% field coverage in one fast pass: price, deposit, monthly rent, supply & exclusive area, floor, address, agency, phone and photos — straight from the listing feed.
• ⚡ Fast Overview mode: paginate thousands of listings quickly, no per-page browser overhead.
• 🎯 Detail enrichment on demand: add full road address, legal-dong code, lot number and the complete photo gallery only when you need them.
• 💰 Transparent pay-per-result pricing: you're charged per listing extracted — no charge until your input is validated.
• 💎 Korea-native: KRW pricing, square-metre areas, correct sale/jeonse/monthly-rent split — no guesswork.
• ✨ No-code or API: run from the Apify console or call it from any language.

---

✨ Features

• 🏠 All property types: apartments (apt), officetels (city), villas, studios, houses, offices and commercial.
• 🤝 All deal types: sale (매매), jeonse (전세) and monthly rent (월세) — with deposit and monthly-rent split out cleanly.
• 📂 Search by category: pick a property type and region, no URL fiddling.
• 🔗 Search by URL: paste a Sarangbang search-results link and every filter carries through.
• 🔎 Detail enrichment: full road address, legal-dong code, lot number and full photo gallery per listing.
• 💴 Korea-native fields: KRW prices, ㎡ areas, computed price-per-㎡.
• 🖼️ Photo galleries: every listing image URL, plus a cover thumbnail.
• 📊 Clean exports: JSON, CSV or Excel directly from the Apify dataset.

---

🎬 Quick Start

Pick a mode, set a category or paste a search URL, and run. Results land in the dataset as clean rows you can export to JSON, CSV or Excel. Start with FREE-tier runs to see the data, then scale up.

curl -X POST https://api.apify.com/v2/acts/sian.agency~sarangbang-property-scraper/runs?token=YOUR_TOKEN \
-H 'Content-Type: application/json' \
-d '{"scrapeMode":"overview","searchMode":"byCategory","cat":"life","menu":"apt","maxResults":100}'

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose your data

Pick Overview (fast, ~90% of fields) or Detail (overview + per-listing enrichment).

Step 2: Choose your search

Select a category + region, paste a Sarangbang search URL, or (Detail only) supply specific listing URLs / record numbers.

Step 3: Run and export

Click Start (or call the API). Export the dataset as JSON, CSV or Excel.

That's it! In a couple of minutes, you'll have:

• A clean dataset of Korean property listings
• Prices, deposits, rents, sizes, floors, addresses, agencies and photos
• Ready-to-analyze JSON/CSV

---

📥 Input Configuration

Field	Type	Required	Description
scrapeMode	string	No	overview (fast) or detail (overview + enrichment)
searchMode	string	No	byCategory, bySearchUrl, or byListingUrl (Detail only)
cat	string	No	Top category: life (residential), biz, land
menu	string	No	Property type: apt, city, villa, studio, house, office
area1 / area2 / area3	string	No	Region codes (province / district / neighbourhood)
opt	string	No	Specific apartment-complex code
submenu	string	No	Deal type: sell or rent
minPrice / maxPrice	integer	No	Price range filter (KRW)
minArea / maxArea	integer	No	Area range filter (㎡)
orderby / sort	string	No	Sort key and direction
searchUrls	array	No	Sarangbang search-results URLs
listingUrls	array	No	Detail-page URLs or record numbers (Detail mode)
maxResults	integer	No	Max listings per run (FREE: 25, PAID: unlimited)

Example — overview by category:

{
  "scrapeMode": "overview",
  "searchMode": "byCategory",
  "cat": "life",
  "menu": "apt",
  "maxResults": 200
}

Example — detail from a search URL:

{
  "scrapeMode": "detail",
  "searchMode": "bySearchUrl",
  "searchUrls": ["https://home.sarangbang.com/v2/page/linead/search.html?cat=life&menu=apt&area1=46"],
  "maxResults": 50
}

---

📤 Output

Results are saved to the Apify dataset with 39 fields including:

Field	Type	Description
id	string	Sarangbang record number
propertyTitle	string	Listing title
property_type	string	apt / city / villa / studio / house / office
deal_type	string	sell (매매) or rent (전세 / 월세)
price	integer	Sale price or deposit (KRW)
deposit	integer	Deposit for jeonse / monthly rent (KRW)
monthly_rent	integer	Monthly rent for 월세 (KRW)
price_per_m2_krw	integer	Computed price per square metre
area_supply_m2	number	Supply area (㎡)
area_exclusive_m2	number	Exclusive area (㎡)
floor	string	Floor
dong	string	Neighbourhood
address	string	Address summary
road_address	string	Road address (Detail)
seller_name	string	Agency / agent
seller_tel	string	Agency phone
images	array	All photo URLs

Example:

{
  "id": "20260619110803580",
  "propertyTitle": "글로벌",
  "property_type": "apt",
  "deal_type": "sell",
  "money_type": "매매",
  "price": 180000000,
  "price_per_m2_krw": 2435064,
  "area_supply_m2": 99.11,
  "area_exclusive_m2": 73.92,
  "floor": "13",
  "dong": "나주 남평읍",
  "road_address": "나주시 남평읍 동사리",
  "seller_name": "남평공인중개사",
  "seller_tel": "010-8513-4984",
  "image_count": 33,
  "source": "overview"
}

---

💼 Use Cases & Examples

1. Korean property market research

Analysts tracking price and supply across cities and neighbourhoods.

Input: A category + region, Overview mode. Output: A clean dataset of listings with prices, deposits, rents and areas. Use: Build price indices and supply dashboards by district.

2. Investment & rental-yield modelling

Investors comparing sale prices against jeonse/monthly-rent levels.

Input: Two runs — one submenu=sell, one submenu=rent, same region. Output: Matched sale and rental datasets with deposits and monthly rents. Use: Compute gross yields and jeonse-to-price ratios.

3. Proptech & data pipelines

Engineering teams feeding listings into a product or warehouse.

Input: Scheduled runs via the API. Output: Fresh JSON appended to your store on a schedule. Use: Keep your Korea property dataset continuously up to date.

4. Lead generation for agencies

Agencies sourcing listing agencies and contact numbers.

Input: Overview mode over a target region. Output: Agency names and phone numbers attached to each listing. Use: Build a verified contact list of active agents.

5. Listing enrichment

Teams that already have record numbers and need full detail.

Input: Detail mode, byListingUrl with record numbers. Output: Road address, legal-dong code, lot number and full photo gallery. Use: Enrich an existing catalogue with authoritative location data.

---

🔗 Integration Examples

JavaScript/Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/sarangbang-property-scraper').call({
  scrapeMode: 'overview', searchMode: 'byCategory', cat: 'life', menu: 'apt', maxResults: 100,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/sarangbang-property-scraper').call(
    run_input={'scrapeMode': 'overview', 'searchMode': 'byCategory', 'cat': 'life', 'menu': 'apt', 'maxResults': 100}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~sarangbang-property-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"scrapeMode":"overview","searchMode":"byCategory","cat":"life","menu":"apt","maxResults":100}'

Automation Workflows (N8N / Zapier / Make)

1. Trigger: Schedule or webhook
2. HTTP Request: Call the actor API
3. Process: Handle the JSON results
4. Action: Save, notify, or transform

---

📊 Performance & Pricing

FREE Tier (Try It Now)

• 25 listings per run — full feature access, same data quality
• No credit card required
• Perfect for testing and small projects

PAID Tier (Production Ready)

• Unlimited listings per run
• Pay-per-result: only charged for listings actually extracted
• Fast, direct extraction — no per-page browser overhead

💰 Pay only for what you pull — a cheap, high-volume Overview event plus an optional Detail enrichment event.

🔗 View current pricing

---

❓ Frequently Asked Questions

Q: How many listings can I extract? A: FREE tier: 25 per run. PAID tier: unlimited.

Q: What's the difference between Overview and Detail mode? A: Overview returns ~90% of fields fast from the listing feed. Detail additionally fetches each listing page to add road address, legal-dong code, lot number and the full photo gallery.

Q: Does it handle sale, jeonse and monthly rent? A: Yes — sale (매매), jeonse (전세) and monthly rent (월세), with deposit and monthly rent split into separate fields.

Q: What output formats are available? A: JSON, CSV and Excel — export directly from the Apify dataset.

Q: Do I need an account or API key for the source site? A: No. No account, no key, no manual login.

Q: Can I run it on a schedule? A: Yes — schedule it in the Apify console or trigger it from the API.

Q: Is this legal? A: We only extract publicly available listing data. See the legal section below.

---

🐛 Troubleshooting

No results returned

• Check your category (cat/menu) and region codes are valid Sarangbang codes.
• If using bySearchUrl, confirm the URL is a Sarangbang search-results page.

Fewer results than expected

• FREE tier caps at 25 listings per run — increase maxResults on the PAID tier.
• Tighten or loosen your price/area filters.

Detail mode returns the same fields as Overview

• Detail enrichment adds a few fields (road address, legal-dong code, lot number, full gallery); most fields already come from Overview.

---

⚖️ 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 note: "Sarangbang" and any related names, logos and brands are the property of their respective owners. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by the operators of home.sarangbang.com. It accesses only publicly available data.

---

🤝 Support

Join our active support community

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

---

Built by SIÁN Agency | More Tools