disco.re Scraper 🇰🇷 — South Korea Property Data & Real Estate API 🏠

🎉 Turn disco.re (디스코) listings into clean structured data — sale, jeonse & monthly rent, nationwide, no API key

Built for real-estate analysts, proptech teams, investors and lead-gen agencies who need South Korea property data at scale

---

📋 Overview

Scrape disco.re (디스코) — a popular South Korean property platform — into ready-to-use datasets. Pull tens of thousands of listings with price, deposit, monthly rent, area, floor, building, structure, full address, GPS coordinates, agent contact, photos — plus parcel-registry numbers and recent real-transaction (실거래) history — as JSON, CSV or Excel.

Why proptech teams and investors choose us:

• ✅ Complete listings: price, deposit, monthly rent, area, floor, building name, structure, parking, GPS, agent name & phone, photos, registry and transaction history
• ⚡ Fast & affordable Overview mode: harvest the full nationwide map dataset in seconds — the cheapest way to grab listing volume
• 🎯 All three deal types: sale (매매), jeonse (전세) and monthly rent (월세), across every region of Korea
• 💸 Pay-per-result: only pay for listings you actually extract — generous FREE tier, no credit card to start
• 💎 Detail mode with everything: title, floor, structure, agent contact, photos, parcel-registry land/floor area and recent real (실거래) transactions — each detail row is also enriched with the overview fields, so you always get a complete record
• ✨ Investor KPIs built in: automatic price-per-m² (KRW) and dual KRW / 만원 values, plus a thumbnail-first row for instant gallery views

---

✨ Features

• 🏠 Sale, jeonse & monthly rent: 매매, 전세 and 월세 in one actor
• 🎛️ Filter by property type & deal type, or paste a URL: pick apartment, officetel, land, factory and more, or paste a disco.re map URL — or fetch specific listing ids
• 💵 Full pricing breakdown: sale price, deposit and monthly rent in both 만원 and absolute KRW
• 📐 Rich specs: supply / floor / land / building area (m²), floor and total floors, rooms, bathrooms, direction, structure, parking
• 🧭 Geo data: full jibun address, parcel number (PNU), latitude & longitude
• 🧑‍💼 Agent contact: agent name, brokerage office, phone, registration number and tier
• 📸 Full photo gallery: every listing image URL, plus a cover thumbnail
• 🗺️ Registry & transaction history: parcel-registry land/floor area and recent real (실거래) transactions per parcel
• 📊 Computed KPIs: price-per-m² in KRW, ready for comparables and yield models
• 🔢 Filters & limits: narrow by property type and deal type, cap each run with Max results
• 📤 Clean exports: JSON, CSV and Excel directly from the dataset

---

🎬 Quick Start

Pick a mode (Overview for speed, Detail for full data), choose your filters (a property/deal type, a search URL, or specific listing ids), and run. Results stream into your dataset as clean rows you can export to JSON, CSV or Excel.

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

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose your mode

Pick Overview (fast & cheap — compact listings from the nationwide dataset) or Detail (full fields per listing).

Step 2: Choose your filters

Pick a property type and/or deal type, paste a disco.re map URL, or — in Detail mode — paste specific listing ids (suids).

Step 3: Run it

Click Start (or call the API). Listings stream into your dataset in real time.

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

• A clean table of disco.re listings with prices and specs
• Address, PNU, GPS, agent contact and full photos (Detail mode)
• Parcel-registry and recent real-transaction history (Detail mode)
• A JSON / CSV / Excel export ready for your model or CRM

---

📥 Input Configuration

Field	Type	Required	Description
scrapeMode	string	No	overview (fast & cheap) or detail (full fields). Default overview.
searchMode	string	No	byFilter, bySearchUrl, or bySuid (detail only). Default byFilter.
estateType	string	No	Property-type code: 3 apartment, 4 officetel, 0 detached, 2 multiplex, 5 commercial, 7 store/office, 8 factory/warehouse, 1 land, 12 lodging, 90 pre-sale right.
dealType	string	No	0 sale (매매), 1 jeonse (전세), 2 monthly rent (월세).
searchUrls	array	No	disco.re map URLs — their filters are honoured.
suids	array	No	Detail mode: specific listing ids (e.g. ecfww3di).
withRegistry	boolean	No	Detail mode: also fetch parcel registry + recent real transactions. Default true.
maxResults	integer	No	Cap listings per run. FREE: 25. PAID: unlimited. Default 100.
proxyCountry	string	No	Empty = direct (default). KR routes through a Korean residential proxy for very large runs.

Example — by filter (apartments for sale):

{
  "scrapeMode": "overview",
  "searchMode": "byFilter",
  "estateType": "3",
  "dealType": "0",
  "maxResults": 200
}

Example — detail by listing id:

{
  "scrapeMode": "detail",
  "searchMode": "bySuid",
  "suids": ["ecfww3di"],
  "withRegistry": true
}

---

📤 Output

Results are saved to the Apify dataset. Key fields include:

Field	Type	Description
listingId	string	disco.re listing identifier (suid)
url	string	Canonical listing data endpoint
propertyTitle	string	Listing title (Detail mode)
deal_type_label	string	매매 / 전세 / 월세
estate_type_label	string	Property kind (아파트, 오피스텔, …)
price / deposit / monthly	integer	Price, deposit, monthly rent (만원)
price_krw / deposit_krw / monthly_krw	integer	Same values in absolute KRW
price_per_sqm_krw	integer	Computed price per m² (KRW)
area / supply_area / floor_area / land_area	number	Areas (m²)
floor / floor_total / rooms / bathrooms	integer	Property specs
building_name / structure_type / car_cnt	—	Building details (Detail mode)
address / pnu / latitude / longitude	—	Location & parcel
agent_name / agent_office / agent_phone	string	Agent contact (Detail mode)
images / image_count / thumbnail	—	Photos (Detail mode)
parcel_land_area / parcel_floor_area	number	Parcel-registry areas (Detail mode)
recent_transactions	array	Recent real (실거래) transactions (Detail mode)

Example:

{
  "listingId": "ecfww3di",
  "url": "https://www.disco.re/sale/get_for_sale_info/?suid=ecfww3di",
  "source": "detail",
  "propertyTitle": "E실35 코너호실 발코니확장 룸1 싱크대등 풀인테리어 선유도역 초역세권 지산",
  "deal_type_label": "매매",
  "estate_type_label": "공장·창고",
  "building_name": "선유도역2차아이에스비즈타워",
  "price": 99000,
  "price_krw": 990000000,
  "price_per_sqm_krw": 9295598,
  "supply_area": 209.54,
  "floor_area": 106.51,
  "floor": 6,
  "floor_total": 15,
  "structure_type": "철근콘크리트",
  "car_cnt": 281,
  "address": "서울특별시 영등포구 양평동4가 80",
  "latitude": 37.536219384753,
  "longitude": 126.894988306442,
  "agent_name": "임정은",
  "agent_office": "마스터자이타워공인중개사사무소",
  "agent_phone": "01022753744",
  "image_count": 8,
  "currency": "KRW"
}

---

💼 Use Cases & Examples

1. Rental Yield & Investment Analysis

Investors and proptech analysts modelling returns across Seoul, Busan and beyond.

Input: A property/deal-type filter, sale and rent runs. Output: Price, deposit, monthly rent and computed KRW/m² per listing. Use: Build gross-yield and jeonse-to-sale models for whole districts.

2. Price & Rent Comparables (CMA)

Brokers and appraisers needing fast comparables.

Input: A disco.re search URL for a specific area and property type. Output: Comparable listings with price, area and KRW/m². Use: Produce a comparative market analysis in minutes, not hours.

3. Agent & Lead Generation

Agencies sourcing seller and landlord inventory plus agent contacts.

Input: Filter-based runs in Detail mode. Output: Listings with address, specs and agent name, office & phone. Use: Feed a CRM with fresh, qualified property and agent leads.

4. Market Research & Trend Dashboards

Data teams tracking Korea's housing market.

Input: Scheduled daily runs across property types. Output: A time series of prices, deposits and inventory. Use: Power BI / Looker dashboards on supply and pricing trends.

5. Powering a Real-Estate Data API

Proptech startups building products on Korea listings.

Input: Programmatic API calls per property type. Output: Structured JSON ready to ingest. Use: Back a search app or valuation API with live disco.re data.

6. Valuation with Real-Transaction History

Appraisers and lenders verifying market value.

Input: Detail mode with registry enrichment. Output: Listings plus parcel-registry areas and recent real (실거래) transactions. Use: Cross-check asking prices against actual recorded sales.

---

🔗 Integration Examples

JavaScript/Node.js

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

const run = await client.actor('sian.agency/disco-property-scraper').call({
  scrapeMode: 'overview',
  searchMode: 'byFilter',
  estateType: '3',
  dealType: '0',
  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/disco-property-scraper').call(
    run_input={
        'scrapeMode': 'overview',
        'searchMode': 'byFilter',
        'estateType': '3',
        'dealType': '0',
        '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~disco-property-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"scrapeMode":"overview","searchMode":"byFilter","dealType":"0","maxResults":100}'

Automation Workflows (N8N / Zapier / Make)

1. Trigger: Schedule (e.g. daily) or webhook
2. HTTP Request: Call the actor API
3. Process: Handle the JSON results
4. Action: Save to a sheet, push to a CRM, or send an alert

---

📊 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 successfully extracted
• Ideal for dashboards, comparables and data APIs

💰 Transparent pay-per-result pricing — the fast Overview event is the cheapest way to harvest Korea property data at volume; upgrade to Detail only when you need address, GPS, agent contact, photos and transaction history.

🔗 View current pricing

---

❓ Frequently Asked Questions

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

Q: Does it cover sale, jeonse and monthly rent? A: Yes — set dealType to 0 (매매/sale), 1 (전세/jeonse) or 2 (월세/monthly rent). Leave it empty for all three.

Q: What is the difference between Overview and Detail? A: Overview is the fast, cheap path — it pulls the nationwide map dataset and emits compact listings (type, price, area, address, GPS). Detail fetches each listing for the title, floor, structure, agent contact, photos and — when enabled — parcel-registry areas and recent real (실거래) transactions. Each detail row is also enriched with the overview fields, so every record is complete.

Q: What currency are prices in? A: Korean Won (KRW). disco.re stores money in 만원 (10,000 KRW) units; we keep that raw value and also expose absolute KRW (*_krw) fields.

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

Q: Do I need a disco.re account or API key? A: No. The actor works straight out of the box.

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

---

🐛 Troubleshooting

No results returned

• Check your filter combination — some property/deal-type combinations have few listings. Leave a filter empty to broaden the search.
• If you pasted a search URL, open it on disco.re first to confirm it returns listings.

A specific listing id was skipped

• Sold or removed listings return an empty record and are skipped automatically. Try a currently-live listing id (suid).

Fewer rows than expected in Overview

• FREE runs are capped at 25 listings. Raise Max results on a PAID run to gather more.

Large runs slowing down

• Set proxyCountry to KR to route through a Korean residential proxy and avoid IP rate-limits at scale.

---

⚖️ 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.

Disclaimer: This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by disco.re or 디스코. "disco.re", "디스코" and related marks are trademarks of their respective owners. Use this actor in compliance with disco.re's terms and all applicable laws.

---

🤝 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