Naver Real Estate Scraper (네이버 부동산)

Scrapes current property listings from Naver Real Estate — South Korea's largest and most popular real estate platform. Get active sale listings, jeonse/monthly rent offers, complex details, and price history.

Why use this Actor?

• Korea's #1 real estate platform — Naver Real Estate has the most comprehensive listing coverage in South Korea.
• Current market data — unlike transaction records, this shows what's actually on the market right now.
• Structured data — listings are returned as clean JSON with location, complex info, pricing, and property details.
• Hierarchical search — drill down from province to district to neighborhood to specific complexes.
• Optional enrichment — fetch complex details (household count, construction year) and price history.

Important: Korean Proxy Required

Naver Real Estate blocks all non-Korean IP addresses. You must configure a Korean residential proxy to use this Actor.

Apify provides Korean residential proxies at approximately $13/GB. A typical run scraping 1,000 listings uses roughly 5-15 MB of bandwidth.

Configure the proxy in the Proxy Configuration input field.

How much does it cost?

This Actor uses pay-per-event pricing. You are charged per listing result returned. The main cost is the Korean proxy bandwidth — the Actor itself has minimal compute requirements.

Estimated cost per 1,000 listings: proxy bandwidth (~$0.10-0.20) + per-result charge.

Features

• 9 property types: Apartments, officetels, villas, detached houses, studios, presale units, mixed-use complexes, commercial houses, and single/multi-family homes
• 4 trade types: Sale (매매), jeonse (전세), monthly rent (월세), short-term rental (단기임대)
• Configurable scope: Control how many districts, neighborhoods, and complexes to search
• Rate limiting: Built-in configurable delay between requests to avoid blocking
• Budget control: Stops automatically when your spending limit is reached

Input parameters

Parameter	Required	Default	Description
region	✅	서울특별시	Province/city name
district	No	-	Specific district (narrows search)
propertyType	No	APT	Property type code (see table below)
tradeType	No	A1	Trade type code (see table below)
maxDistricts	No	5	Max districts to search
maxNeighborhoods	No	5	Max neighborhoods per district
maxComplexes	No	20	Max complexes per neighborhood
maxArticles	No	50	Max listings per complex
includeComplexDetail	No	false	Fetch extra complex details
includePriceHistory	No	false	Fetch price history
requestDelay	No	1.0	Seconds between requests
proxyConfiguration	✅	-	Korean residential proxy (required)

Property type codes

Code	Type (Korean)	Type (English)
APT	아파트	Apartment
ABYG	아파트분양권	Apartment Presale
JGC	주상복합	Mixed-use Complex
OPST	오피스텔	Officetel
HOJT	빌라/연립	Villa/Row House
JWJT	전원주택/단독	Detached House
DDDGG	단독/다가구	Single/Multi-family
SGJT	상가주택	Commercial House
OR	원룸	Studio

Trade type codes

Code	Type (Korean)	Type (English)
A1	매매	Sale
B1	전세	Jeonse (lump-sum deposit)
B2	월세	Monthly Rent
B3	단기임대	Short-term Rental

Example output

{
    "region": "서울특별시",
    "district": "강남구",
    "neighborhood": "역삼동",
    "complexNo": "100",
    "complexName": "래미안대치팰리스",
    "complexAddress": "서울시 강남구 역삼동",
    "totalHousehold": 1500,
    "totalDong": 12,
    "latitude": "37.5012",
    "longitude": "127.0413",
    "articleNo": "2400001",
    "articleName": "래미안 101동",
    "propertyType": "아파트",
    "tradeTypeName": "매매",
    "price": "25억 5,000",
    "exclusiveArea": 134.88,
    "floor": "12/25",
    "direction": "남향",
    "tags": ["역세권", "학군"],
    "description": "남향 로열층"
}

Use cases

• Property search automation — find listings matching specific criteria across multiple districts
• Market monitoring — track available inventory and asking prices over time
• Price comparison — compare asking prices with actual transaction data (pair with the Korean Real Estate Transaction Data Actor)
• Real estate research — analyze listing patterns, popular areas, and market supply
• Investment analysis — monitor specific complexes or neighborhoods for new listings

FAQ

Q: Why do I need a Korean proxy? A: Naver Real Estate blocks all non-Korean IP addresses at the network level. Without a Korean proxy, all requests will be rejected. Apify offers Korean residential proxies (~$13/GB).

Q: How much does the proxy cost per run? A: A typical run scraping 1,000 listings uses 5-15 MB of proxy bandwidth, costing approximately $0.07-0.20. The proxy cost is usually the largest component of the total run cost.

Q: Can I search a specific apartment complex? A: Yes. Set the district parameter to narrow down your search area, then use maxNeighborhoods and maxComplexes to control scope. The Actor will find and list complexes in that area.

Q: What does "25억 5,000" mean? A: Korean real estate prices use 억 (hundred million) as the unit. 25억 5,000 = 25억 + 5,000만원 = 2,550,000,000 KRW ≈ $1.8M USD.

Q: How often should I run this to track market changes? A: For market monitoring, weekly runs capture most changes. Daily runs are useful if you're watching specific complexes for new listings. Use Apify's scheduling feature to automate this.

Q: Can I combine this with the Korean Real Estate Transaction Data Actor? A: Yes — this is a powerful combination. This scraper shows current asking prices (what sellers want), while the transaction Actor shows actual closed deals (what buyers paid). The gap between them reveals market sentiment.

Integration with Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

# Scrape Gangnam apartment listings
run = client.actor("aligned_kettledrum/naver-land-scraper").call(
    run_input={
        "region": "서울특별시",
        "district": "강남구",
        "propertyType": "APT",
        "tradeType": "A1",
        "maxDistricts": 1,
        "maxNeighborhoods": 10,
        "maxComplexes": 50,
        "maxArticles": 20,
        "includeComplexDetail": True,
        "requestDelay": 1.5,
        "proxyConfiguration": {"useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"]},
    }
)

# Analyze results
import pandas as pd
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
df = pd.DataFrame(items)

print(f"Total listings: {len(df)}")
print(f"Complexes: {df['complexName'].nunique()}")
print(f"Neighborhoods: {df['neighborhood'].unique()}")

Technical details

This Actor scrapes Naver Real Estate's internal JSON APIs that power their web frontend. No browser rendering is needed — pure HTTP requests, which means fast execution and low resource usage.

Prices are displayed in Korean format: "25억 5,000" = 2,550,000,000 KRW (~$1.8M USD).

The Actor respects rate limits with configurable delays between requests. Default is 1 second between API calls.