Naver Land Scraper — Korea Apartments, Officetels & Villas

Extract South Korean property listings from Naver Land at scale: apartments (아파트), officetels (오피스텔), villas (빌라) and more, for sale (매매), jeonse (전세), and monthly rent (월세). Search by Korean location name and export clean, structured data — price, area, floor, direction, location, listing tags, photos, and the listing agent.

No account. No manual copy-paste. Give it a district or a neighborhood and get back a ready-to-use dataset in JSON, CSV, Excel, or via API.

Built for proptech teams, market analysts, relocation services, investors, and lead-generation teams that need Korean real-estate data in bulk.

---

🧭 Table of contents

• What this scraper does
• Why use it
• Who it's for
• What data you get
• Input options
• Input examples
• Output example
• How to use (step by step)
• Tips for best results
• Use cases
• Integrations & export
• Pricing
• FAQ

---

What this scraper does

Naver Land is South Korea's leading real-estate portal, covering virtually every apartment complex, officetel, and villa on the market. This actor turns that inventory into structured data you can actually analyze.

Collect listings in two ways:

1. By location search — type a Korean district (구) or neighborhood (동), e.g. 강남구, 역삼동, 분당구. Each is resolved to its region and scraped.
2. By region code — supply Naver Land region codes (cortarNo) directly for precise, repeatable runs.

For each listing you get pricing, size, floor, facing direction, coordinates, listing tags, and — optionally — the agent's office and phone number plus the full description.

---

Why use it

• ⚡ Fast & efficient — pages through entire regions quickly and cheaply.
• 🇰🇷 Korea-native — understands 매매 / 전세 / 월세, apartments, officetels, and villas, and Korean area formats.
• 🏢 Agent contacts — optionally include the listing office name and phone number for outreach and lead generation.
• 🧱 Flexible inputs — search terms or region codes, filtered by property type and trade type.
• 🗺️ Geo-ready — every listing includes latitude/longitude for mapping and spatial analysis.
• 📦 Export anywhere — JSON, CSV, Excel, HTML table, or RSS, plus a full REST API and integrations.

---

Who it's for

• Proptech & real-estate startups building search, analytics, or valuation products for Korea.
• Market researchers & analysts tracking sale, jeonse, and rent prices across districts and complexes.
• Relocation & expat-housing services sourcing apartments and officetels for clients.
• Lead-generation teams building lists of active listing agents and offices.
• Investors & landlords monitoring competing listings and price changes in target areas.

---

What data you get

Each listing includes (when available):

Field	Description
articleNo	Unique listing ID
articleName	Listing / building name
url	Direct link to the listing
realEstateType	Property type (apartment, officetel, villa…)
tradeType	Sale / jeonse / monthly rent
price	Sale or deposit price (Korean formatted)
rentPrice	Monthly rent, when applicable
priceChangeState	Whether the price recently changed
areaName	Area / floorplan name
supplyAreaM2	Supply area (m²)
exclusiveAreaM2	Exclusive area (m²)
floorInfo	Floor / total floors
direction	Facing direction
buildingName	Building name
confirmDate	Listing confirmation date
features	Short feature description
tags	Listing tags (e.g. near-subway, newly-built)
imageCount	Number of photos
representativeImage	Main photo URL
sameAddrCount	Number of listings at the same address
sameAddrMinPrice / sameAddrMaxPrice	Price range at the same address
latitude / longitude	GPS coordinates
realtorName	Listing agent / office name
source	Listing source / partner
complexNo	Complex ID (for apartments/officetels)
verificationType	Listing verification type
agentName / agentOffice	Agent and office (with agent details enabled)
agentRepName	Representative name
agentPhone	Agent phone number
agentAddress	Agency address
description	Full listing description
exposeAddress	Exposed address
scrapedAt	When the record was scraped

---

Input options

Option	Type	Description
searchQueries	array	Korean location names (district / neighborhood).
cortarNos	array	Region codes (cortarNo) to scrape directly (advanced).
realEstateTypes	array	Property types: APT, OPST, VL, ABYG, JGC, OR, …
tradeTypes	array	A1 sale, B1 jeonse, B2 monthly rent, B3 short-term. Empty = all.
includeAgentDetails	boolean	Add agent office, phone and full description (extra requests).
maxItems	integer	Maximum listings to save (0 = no limit).
maxConcurrency	integer	Parallel detail requests (default: 8).
proxyConfiguration	object	Korean (KR) residential proxy required (default provided).

---

Input examples

1. Apartments for sale in a district

{
  "searchQueries": ["강남구"],
  "realEstateTypes": ["APT"],
  "tradeTypes": ["A1"],
  "maxItems": 500,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "KR" }
}

2. Officetels for jeonse + monthly rent across neighborhoods

{
  "searchQueries": ["역삼동", "서초동"],
  "realEstateTypes": ["OPST"],
  "tradeTypes": ["B1", "B2"],
  "maxItems": 1000,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "KR" }
}

3. Everything in a region by code

{
  "cortarNos": ["1168010100"],
  "realEstateTypes": ["APT", "OPST", "VL"],
  "maxItems": 2000
}

---

Output example

{
  "articleNo": "2500000000",
  "articleName": "역삼동 아이파크",
  "url": "https://new.land.naver.com/articles/2500000000",
  "realEstateType": "아파트",
  "tradeType": "매매",
  "price": "21억 5,000",
  "rentPrice": "",
  "priceChangeState": "SAME",
  "areaName": "84A",
  "supplyAreaM2": 110,
  "exclusiveAreaM2": 84,
  "floorInfo": "12/20",
  "direction": "남향",
  "confirmDate": "20260601",
  "tags": ["25년이내", "역세권", "주차가능"],
  "latitude": "37.500",
  "longitude": "127.036",
  "realtorName": "역삼OO공인중개사",
  "agentOffice": "역삼OO공인중개사",
  "agentPhone": "02-000-0000",
  "scrapedAt": "2026-06-09T10:00:00.000Z"
}

---

How to use (step by step)

1. Open the actor and click Try for free.
2. In Location searches, add one or more Korean place names (e.g. 강남구, 역삼동).
3. Choose Property types (apartment, officetel, villa…) and Trade types (sale, jeonse, rent).
4. Toggle Include agent details if you want agent office and phone numbers.
5. Set Max items to control dataset size.
6. Click Save & Start.
7. When the run finishes, open the Dataset tab and export to JSON, CSV, Excel, or pull it via API.

---

Tips for best results

• Keep the Korean residential proxy. Naver Land requires a KR residential proxy; the default is already configured.
• Search precisely. A neighborhood (동) gives tighter, more relevant results than a whole district.
• Filter by type. Narrow realEstateTypes and tradeTypes to exactly what you need to keep runs fast and datasets clean.
• Start small. Preview with a low maxItems, then scale up.
• Agent details cost extra requests. Disable includeAgentDetails if you only need core listing data and want maximum speed.

---

Use cases

• 📊 Price analytics — track sale, jeonse, and monthly-rent levels by district and complex.
• 🏠 Valuation & AVM models — feed area, floor, direction, and price into pricing pipelines.
• 🧲 Agent lead generation — build contact lists of active listing offices and agents.
• 🌏 Relocation platforms — surface available apartments and officetels for incoming residents.
• 🔍 Competitive monitoring — watch competing listings and price changes in your target areas.
• 🤖 AI & data products — supply fresh, structured Korean property data to apps and assistants.

---

Integrations & export

Export as JSON, CSV, Excel, HTML table, or RSS, or fetch results through the API. Connect to Make, Zapier, n8n, Google Sheets, Slack, GitHub, and more, or schedule runs to keep your dataset fresh.

---

Pricing

This actor runs on a simple pay-per-result model — you only pay for the listings you collect. Start small with the free tier and scale up as needed.

---

FAQ

Which property types are covered? Apartments, officetels, villas, pre-sale apartments, reconstruction listings, one-rooms, and more — select what you need.

Can I get the agent's phone number? Yes — enable Include agent details to add the listing office, agent phone, and full description.

Do I need a Naver account? No account or key is required.

Why is a Korean proxy required? Naver Land serves its data to Korean visitors; a KR residential proxy is needed for reliable access. The default proxy is preconfigured.

How do I scrape a whole district? Use the district name (e.g. 송파구) as a search query, or supply its region code.

How many listings can I scrape? As many as you need — set maxItems to 0 for no limit.

What is a cortarNo? It's Naver Land's internal region code. You can supply it directly for precise, repeatable runs, or just use a Korean location name and let the actor resolve it.

---

Need another Korean data source or a custom field? Open an issue on the actor's Issues tab — feedback and feature requests are welcome.