# 네이버 부동산 스크래퍼 Naver Real Estate Scraper Korea (`zen-studio/naver-land-scraper`) Actor

Scrape Naver Real Estate (네이버 부동산) property listings across Korea: asking prices in KRW, sizes, floors, facing direction and building records. 19 property types from apartments to shops, offices and land, plus 매매, 전세, 월세 and 단기임대 deal types.

- **URL**: https://apify.com/zen-studio/naver-land-scraper.md
- **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community)
- **Categories:** Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.29 / 1,000 property listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Naver Real Estate Scraper (네이버 부동산) | Korea Property Listings, Prices & Building Data (2026)

<blockquote style="border-left:4px solid #4C945E;background:#F0FDF4;padding:12px 16px;margin:12px 0">
<span style="font-size:16px;font-weight:700;color:#1C1917">1,000 listings in about 30 seconds:</span> <span style="font-size:15px;color:#57534E">60+ fields per property, prices parsed into plain KRW, and 19 property types from apartments through to shops, offices and land.</span>
</blockquote>

<a href="https://console.apify.com/actors/HngnV5OlFdsPYkaUS/input"><img src="https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/naver-land-scraper-hero.png" alt="Naver Real Estate (네이버 부동산) property scraper: asking price in KRW, 공급면적 and 전용면적, floor, facing direction, building household count and assigned school as structured JSON" style="max-width:100%"></a>

<blockquote style="border-left:4px solid #E7E5E4;padding:8px 14px;margin:12px 0">
<span style="font-size:14px">⚡ Most Korean property scrapers stop at apartments and officetels. This one also collects 상가 (shops), 사무실 (offices), 토지 (land), 건물 (whole buildings), 지식산업센터 and 공장·창고. In an industrial district like 가산동 those types are half of everything listed.</span>
</blockquote>

<table>
<tr>
<td colspan="4" style="padding:10px 14px;background:#4C945E;border:none;border-radius:4px 4px 0 0">
<span style="color:#FAFAF9;font-size:14px;font-weight:700;letter-spacing:0.5px">Zen Studio Naver Scrapers</span>
<span style="color:#E8F5E9;font-size:13px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;Korea's search, shopping, local and property platforms</span>
</td>
</tr>
<tr>
<td style="padding:12px 16px;border:1px solid #E7E5E4;border-radius:0 0 0 4px;background:#D3EDD9;border-right:none;border-top:none;vertical-align:top;width:25%">
<a href="https://apify.com/zen-studio/naver-land-scraper" style="color:#4C945E;text-decoration:none;font-weight:700;font-size:14px">Naver Real Estate</a><br>
<span style="color:#4C945E;font-size:12px;font-weight:600">&#10148; You are here</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;background:#E8F5E9;border-right:none;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-F5g6zADHgY9XgfKpv-uUDQtIEe9Q-naver-place-maps-scraper-logo.png" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/naver-place-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">Naver Place</a><br>
<span style="color:#78716C;font-size:12px">Local businesses, reviews</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;background:#E8F5E9;border-right:none;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-49Zb7Ewj7OXyRFnLp-kYOJCOdhrR-naver-cafe-scraper-logo.png" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/naver-blog-cafe-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">Naver Blog & Cafe</a><br>
<span style="color:#78716C;font-size:12px">Posts, bodies, comments</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;border-radius:0 0 4px 0;background:#E8F5E9;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-DHVT6jhgablck1CTx-kFq5oLPY2n-naver-shopping-scraper.png" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/naver-shopping-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">Naver Shopping</a><br>
<span style="color:#78716C;font-size:12px">Keyword and category search</span>
</td>
</tr>
</table>

#### Copy to your AI assistant

```
zen-studio/naver-land-scraper on Apify. Scrapes Naver Real Estate (네이버 부동산 / new.land.naver.com, Korean property listings). Takes Korean district / neighbourhood / building names and/or listing links, returns one row per listing in the DEFAULT dataset: articleNo, articleName, realEstateTypeName, tradeTypeName, dealOrWarrantPrc, priceKrw, depositKrw, monthlyRentKrw, salePriceKrw, supplyAreaM2, exclusiveAreaM2, floorNumber, totalFloors, direction, tagList, regionName, complexNo, listingUrl, latitude/longitude. 60+ fields per listing. Call ApifyClient("TOKEN").actor("zen-studio/naver-land-scraper").call(run_input={"searchTerms": ["강남구"], "propertyTypes": ["APT"], "tradeTypes": ["A1"], "maxListings": 1000}), then client.dataset(run["defaultDatasetId"]).list_items().items. 19 propertyTypes (APT OPST VL YR DSD DDDGG SGJT JGC JGB JWJT OR SG SMS APTHGJ GJCG TJ GM ABYG OBYG) and 4 tradeTypes (A1 sale, B1 jeonse, B2 monthly rent, B3 short-term). Prices are in 만원 for filters (priceMin/priceMax) and KRW in output. Building records go to a SEPARATE "complexes" dataset when includeBuildingInfo is true, one row per building, joined by complexNo. includeAgentContact adds personal data and is off by default. Full spec: GET https://api.apify.com/v2/acts/zen-studio~naver-land-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Token: https://console.apify.com/account/integrations
```

### Key Features

- **19 property types**: 아파트, 오피스텔, 빌라, 원룸 and 단독·다가구, plus 상가, 사무실, 토지, 건물, 지식산업센터, 공장·창고, 재건축, 재개발 and 분양권.
- **Four deal types**: 매매 (sale), 전세 (deposit-only lease), 월세 (deposit plus monthly rent) and 단기임대 (short-term let). Deposits and monthly rents are separate numbers, so a 월세 deposit is never reported as the price.
- **Prices as numbers**: Naver writes `40억` and `5억 3,000`; every row also carries `priceKrw`, `depositKrw`, `monthlyRentKrw` and `salePriceKrw` in plain KRW.
- **Building records**: household and block counts, completion date, every floor plan type with its own official 한국부동산원 valuation, photos, and the assigned elementary school.
- **Filter on what matters**: price, size, building age, facing direction, and 29 property features such as high floor, fully furnished, parking or low maintenance fees.

### How to Scrape Naver Real Estate Listings

#### Basic: every listing in one neighbourhood

```json
{
    "searchTerms": ["서울 강남구 대치동"],
    "maxListings": 500
}
```

#### Apartments for sale in a whole district

```json
{
    "searchTerms": ["강남구"],
    "propertyTypes": ["APT"],
    "tradeTypes": ["A1"],
    "maxListings": 2000
}
```

#### Monthly rentals under a deposit ceiling

```json
{
    "searchTerms": ["관악구 신림동"],
    "propertyTypes": ["OR", "VL"],
    "tradeTypes": ["B2"],
    "priceMax": 5000,
    "maxListings": 1000
}
```

#### Commercial and industrial space

```json
{
    "searchTerms": ["가산동"],
    "propertyTypes": ["SG", "SMS", "APTHGJ", "GJCG"],
    "includeDetail": true,
    "maxListings": 500
}
```

Search terms accept a neighbourhood (`서울 강남구 대치동`), a district (`강남구`), a whole city (`서울시`), or a building by name (`헬리오시티`). A name that matches nothing is reported in the run log rather than returning zero results without explanation.

### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `searchTerms` | array | *required* | Districts, neighbourhoods or building names in Korean |
| `propertyUrls` | array | `[]` | Links to specific properties or whole buildings |
| `complexIds` | array | `[]` | Building reference numbers |
| `propertyTypes` | array | all | `APT`, `OPST`, `VL`, `YR`, `DSD`, `DDDGG`, `SGJT`, `JGC`, `JGB`, `JWJT`, `OR`, `SG`, `SMS`, `APTHGJ`, `GJCG`, `TJ`, `GM`, `ABYG`, `OBYG` |
| `tradeTypes` | array | all | `A1` 매매, `B1` 전세, `B2` 월세, `B3` 단기임대 |
| `priceMin` / `priceMax` | integer | none | In 만원. `50000` is 5억 |
| `areaMin` / `areaMax` | integer | none | In m², applied to 공급면적 |
| `maxBuildAge` / `minBuildAge` | integer | none | Building age in years |
| `directions` | array | `[]` | `SS` 남향, `SE`, `SW`, `EE`, `WW`, `NN`, `NE`, `NW` |
| `features` | array | `[]` | 29 options: floor position, renovation, parking, households, loans, maintenance fees |
| `sortBy` | string | `rank` | `rank` 랭킹순 or `dateDesc` 최신순 |
| `maxListings` | integer | `100` | `0` collects everything available |
| `includeDetail` | boolean | `false` | Full listing details |
| `includeBuildingInfo` | boolean | `false` | Building record to a separate dataset |
| `includeAgentContact` | boolean | `false` | Agent contact fields. Personal data, off by default |

### How to Scrape Naver Real Estate in 4 Steps

1. Open the **Naver Real Estate Scraper** and type a Korean district or neighbourhood into **지역 (Locations)**, for example `강남구`.
2. Pick your **매물 종류 (Property types)** and **거래 유형 (Deal types)**, or leave both empty to collect everything listed.
3. Set **최대 수집 개수 (Maximum results)**, and switch on **단지 정보 (building information)** if you want household counts, floor plan valuations and school assignment.
4. Click **Start**, then download the results as JSON, CSV or Excel from the Storage tab.

### What Data Can You Extract from Naver Real Estate?

Every listing includes:

- **Identity**: listing number, name, property type, deal type, verification status, agent-written description, feature tags
- **Price**: Naver's own 억/만원 string plus parsed KRW, deposit and monthly rent separately, price change state, the range for other units at the same address
- **Size and position**: 공급면적 and 전용면적 in m², floor and total floors, facing direction, block name, coordinates
- **Location**: neighbourhood name and code, building reference, a link back to the listing
- **With full details on**: room and bathroom counts, move-in date, heating type and fuel, parking spaces per household, management costs, acquisition and holding tax estimates, 공시지가, floor plans and photos. 재건축 listings add the builder and approval stage; 토지 listings add zoning, buildability and road access.
- **With building info on**: a separate `complexes` dataset, one row per building, joined by `complexNo`.

#### Output Example

```json
{
  "articleNo": "2645147927",
  "articleName": "대치푸르지오써밋",
  "articleStatus": "R0",
  "realEstateTypeCode": "APT",
  "realEstateTypeName": "아파트",
  "articleRealEstateTypeCode": "A01",
  "articleRealEstateTypeName": "아파트",
  "tradeTypeCode": "A1",
  "tradeTypeName": "매매",
  "verificationTypeCode": "OWNER",
  "floorInfo": "3/17",
  "priceChangeState": "SAME",
  "isPriceModification": false,
  "dealOrWarrantPrc": "40억",
  "areaName": "110C",
  "area1": 110,
  "area2": 84,
  "direction": "남향",
  "articleConfirmYmd": "20260821",
  "siteImageCount": 0,
  "articleFeatureDesc": "남향C타입, 방3화2, 입주협의, 학원도보권블럭, 대명휘문학군",
  "tagList": ["4년이내", "방세개", "화장실두개", "세대당 1.5대이상"],
  "buildingName": "108동",
  "sameAddrCnt": 7,
  "sameAddrDirectCnt": 0,
  "sameAddrMaxPrc": "40억",
  "sameAddrMinPrc": "40억",
  "cpid": "fine",
  "cpName": "부동산포스",
  "cpPcArticleUrl": "https://www.rfine.kr/rd/rd.php?UID=2645147927",
  "latitude": "37.501077",
  "longitude": "127.062953",
  "isLocationShow": true,
  "tradeCheckedByOwner": false,
  "isDirectTrade": false,
  "isComplex": true,
  "detailAddress": "",
  "detailAddressYn": "N",
  "isVrExposed": false,
  "isSafeLessorOfHug": false,

  "priceKrw": 4000000000,
  "monthlyRentKrw": null,
  "depositKrw": null,
  "salePriceKrw": 4000000000,
  "floorNumber": 3,
  "totalFloors": 17,
  "supplyAreaM2": 110.0,
  "exclusiveAreaM2": 84.0,
  "latitudeNum": 37.501077,
  "longitudeNum": 127.062953,
  "regionCortarNo": "1168010600",
  "regionName": "서울시 강남구 대치동",
  "complexNo": "135597",
  "listingUrl": "https://new.land.naver.com/complexes/135597?articleNo=2645147927",
  "hasDetail": true,
  "hasComplexData": true,

  "articleDetail": {
    "articleNo": "2645147927",
    "aptName": "대치푸르지오써밋",
    "aptHouseholdCount": "489",
    "aptUseApproveYmd": "20230605",
    "aptConstructionCompanyName": "대우건설",
    "aptHeatMethodTypeName": "지역난방",
    "aptHeatFuelTypeName": "열병합",
    "aptParkingCount": "731",
    "aptParkingCountPerHousehold": "1.49",
    "exposureAddress": "서울시 강남구 대치동",
    "roomCount": "3",
    "bathroomCount": "2",
    "moveInTypeName": "협의가능",
    "walkingTimeToNearSubway": 8,
    "detailDescription": "남향 C타입입니다. 학원가 도보권.",
    "cortarNo": "1168010600",
    "hscpNo": "135597",
    "totalDongCount": 9
  },
  "articlePrice": {
    "dealPrice": 400000,
    "warrantPrice": 0,
    "rentPrice": 0,
    "priceBySpace": 12012.0,
    "financePrice": 0,
    "premiumPrice": 0
  },
  "articleFloor": { "correspondingFloorCount": "3", "totalFloorCount": "17" },
  "articleSpace": { "supplySpace": 110.0, "exclusiveSpace": 84.0, "exclusiveRate": "76" },
  "articleFacility": { "heatMethodTypeName": "지역난방", "directionBaseTypeName": "거실기준" },
  "articleTax": { "acquisitionTax": 140000, "registTax": 0, "totalPrice": 144600 },
  "landPrice": { "publicLandPrice": 24500000, "standardYear": "2026" },
  "administrationCostInfo": { "chargeCodeType": "05", "monthlyRentCost": 0 },
  "articlePhotos": [
    { "imageSrc": "/20260821_101/...jpg", "imageType": "10", "imageOrder": 1 },
    { "imageSrc": "/20260821_102/...jpg", "imageType": "20", "imageOrder": 2 }
  ],
  "articleRebuild": null,
  "articleGround": null,
  "articleExistTabs": ["detail", "prices", "buildingLandprice", "schools"],
  "articleBuildingRegister": null,
  "articleOneroom": null,

  "complex": {
    "complexNo": "135597",
    "complexName": "대치푸르지오써밋",
    "totalHouseholdCount": 489,
    "totalDongCount": 9,
    "useApproveYmd": "20230605",
    "address": "서울시 강남구 대치동",
    "unitTypeCount": 15,
    "assignedSchool": "서울대현초등학교",
    "schoolAllocationMessage": "해당 단지는 주소지에 따라 초등학교가 배정됩니다."
  }
}
```

Turning on **building information** adds a second dataset, one row per building rather than one per listing, joined to the listings by `complexNo`:

```json
{
  "complexNo": "135597",
  "complexName": "대치푸르지오써밋",
  "totalHouseholdCount": 489,
  "totalDongCount": 9,
  "useApproveYmd": "20230605",
  "address": "서울시 강남구 대치동",
  "detail": { "complexName": "대치푸르지오써밋", "highFloor": 17, "lowFloor": 1 },
  "unitTypes": [
    { "pyeongNo": 1, "pyeongName": "75", "supplyArea": 75.2, "exclusiveArea": 59.9 },
    { "pyeongNo": 2, "pyeongName": "110C", "supplyArea": 110.0, "exclusiveArea": 84.0 }
  ],
  "photos": [{ "imageSrc": "/complex/...jpg", "imageType": "10" }],
  "schools": [{ "schoolName": "서울대현초등학교", "organizationType": "초등학교" }],
  "schoolAllocationMessage": "해당 단지는 주소지에 따라 초등학교가 배정됩니다.",
  "marketPrices": [
    {
      "areaNo": 1,
      "pyeongName": "75",
      "supplyArea": 75.2,
      "exclusiveArea": 59.9,
      "dealUpperPriceLimit": 210000,
      "dealAveragePrice": 198000,
      "dealLowPriceLimit": 185000,
      "leaseUpperPriceLimit": 105000,
      "leaseAveragePrice": 98000
    }
  ]
}
```

### Advanced Usage

Ready-made configurations for market analysis, rental yield research, commercial property sourcing and school-district comparison.

#### Track newly listed apartments in a district

```json
{
    "searchTerms": ["송파구"],
    "propertyTypes": ["APT"],
    "tradeTypes": ["A1"],
    "sortBy": "dateDesc",
    "maxListings": 500
}
```

Run this on a schedule and sort by newest so fresh listings appear at the top of each run.

#### Jeonse research with a size floor

```json
{
    "searchTerms": ["마포구"],
    "propertyTypes": ["APT", "OPST"],
    "tradeTypes": ["B1"],
    "areaMin": 60,
    "includeBuildingInfo": true,
    "maxListings": 1000
}
```

#### Land and whole buildings

```json
{
    "searchTerms": ["제주도"],
    "propertyTypes": ["TJ", "GM"],
    "includeDetail": true,
    "maxListings": 300
}
```

Land listings carry zoning (용도지역), buildability, road access and land-trade permission in `articleGround`.

#### South-facing, recently built, high floor

```json
{
    "searchTerms": ["분당구"],
    "propertyTypes": ["APT"],
    "directions": ["SS"],
    "maxBuildAge": 10,
    "features": ["HIGHFLOOR"],
    "maxListings": 500
}
```

#### One building, everything in it

```json
{
    "propertyUrls": ["https://new.land.naver.com/complexes/111515"],
    "includeBuildingInfo": true,
    "maxListings": 0
}
```

### Pricing: Pay Per Event (PPE)

**$3.99 per 1,000 listings**, dropping to $3.29 on higher Apify plans. Optional layers are charged only when they actually return something.

| Event | Per item | Per 1,000 |
|-------|----------|-----------|
| Property listing | $0.00399 | $3.99, or $3.79 / $3.29 on Silver / Gold |
| Full listing details | $0.00199 | $1.99 |
| Building record | $0.00299 | charged once per building, not per listing |

A district sweep usually meets a few dozen buildings across thousands of listings, so building records stay a small part of a run.

### Integrations and Scheduling

Results land in a dataset you can export directly, or push onward:

- **Google Sheets** for a shared, always-current listing table
- **Make** or **Zapier** to route new listings into a CRM or a Slack channel
- **Webhooks** to trigger your own service the moment a run finishes

For monitoring a market, a **daily run sorted by 최신순** is the usual cadence: Korean listings change quickly, and 한국부동산원 has monitored and removed false listings same-day since 2022.

New to scheduling on Apify? This walkthrough covers it:

https://www.youtube.com/watch?v=1jI7WcVQmwM

### FAQ

**What is Naver Real Estate (네이버 부동산 / Naver Land / new.land.naver.com)?**
Naver Real Estate is the dominant property portal in South Korea, part of Naver, the country's largest search platform. Agents list apartments, officetels, villas, shops, offices and land there, and buyers and renters browse by district and map. It is also known as Naver Land after its web address. This Actor collects the listings, their asking prices and the building records behind them.

**How many listings can I collect?**
A single district can hold well over ten thousand listings across all property types. There is no artificial depth limit per location, so `maxListings` is what decides the size of your run.

**Does this cover commercial property, offices and land, or only apartments?**
All of them. 19 property types ship, including 상가 (shops), 사무실 (offices), 토지 (land), 건물 (whole buildings), 지식산업센터 (knowledge-industry centres) and 공장·창고 (factories and warehouses). Some types are regional: industrial districts are full of 지식산업센터, rural areas have 전원주택.

**What is 전세 (jeonse), and how is the deposit reported?**
전세 is a Korean lease with a large lump-sum deposit and no monthly rent, returned at the end of the term. Its deposit appears in `depositKrw`. For 월세 and 단기임대, which have both, the deposit is in `depositKrw` and the monthly rent in `monthlyRentKrw`, kept as separate numbers.

**What is the difference between 공급면적 and 전용면적?**
공급면적 (`supplyAreaM2`) is the supplied area, including a share of common space. 전용면적 (`exclusiveAreaM2`) is the exclusive area you actually live in. Korean listings quote both, and the size filters apply to 공급면적.

**How fresh is the data?**
Listings are read live at run time. Korean listings turn over quickly, so a run is a snapshot of that moment rather than a permanent record.

**Can I get the estate agent's contact details?**
Yes, with **Include agent contact details** switched on. It adds the agency name, registration number, address and phone numbers as structured fields. This is personal information about a named individual, so it is off by default and Korean privacy law (개인정보보호법) governs how you store and use it. Note that agents often write their own name and mobile number into the free-text description of a listing, and that description is part of the listing whether or not the toggle is on.

**Can I filter by price, size, floor or facing direction?**
Yes. Price and size take a minimum, a maximum or both. Building age, facing direction and 29 property features are separate filters. Every filter offered here was tested against the source to confirm it changes the results.

**How do I export the data?**
JSON, CSV, Excel, XML or HTML from the run's Storage tab, or through the Apify API. JSON preserves the nested detail and building blocks; CSV flattens them.

**Does Naver have an official API for real estate data?**
Naver does not publish a public property API. Its open developer platform covers search, maps, translation and login, not 부동산 listings. This Actor is the practical route to the listing data, and it returns the parsed price, size and building fields you would otherwise have to derive yourself.

**Can I get sold prices or transaction history?**
Not from this Actor. Closed transaction prices (실거래가) are published free and officially by the Ministry of Land, Infrastructure and Transport through data.go.kr, going back to 2006. What Naver has and that dataset does not is asking prices, live listings, agent identity and building records.

**Can I also collect Naver reviews of local businesses, or shopping products?**
Yes, from the siblings: [Naver Place Scraper](https://apify.com/zen-studio/naver-place-scraper) for local businesses and their reviews, [Naver Blog & Cafe Scraper](https://apify.com/zen-studio/naver-blog-cafe-scraper) for community posts, and [Naver Shopping Scraper](https://apify.com/zen-studio/naver-shopping-scraper) for products.

**Is it legal to collect Naver Real Estate listings?**
This Actor reads publicly visible listing pages only, nothing behind a login. You are responsible for complying with Naver's terms of service and with data protection law, including GDPR, CCPA and Korea's 개인정보보호법 (PIPA). Take particular care with agent contact details, which identify a named individual. Naver asserts database producer's rights over its listing data, so consider your intended use before collecting at scale.

### More Zen Studio scrapers for Asian platforms

**🛒 E-commerce**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-OFZVXeeKVlKMMXsJk-wE33BzvwYy-aliexpress-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **AliExpress 全球速卖通**
  - [AliExpress Product Scraper](https://apify.com/zen-studio/aliexpress-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-F5g6zADHgY9XgfKpv-uUDQtIEe9Q-naver-place-maps-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Naver Place 네이버 플레이스**
  - [Naver Place Scraper](https://apify.com/zen-studio/naver-place-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-49Zb7Ewj7OXyRFnLp-kYOJCOdhrR-naver-cafe-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Naver Blog & Cafe 네이버 블로그·카페**
  - [Naver Blog & Cafe Scraper](https://apify.com/zen-studio/naver-blog-cafe-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-DHVT6jhgablck1CTx-kFq5oLPY2n-naver-shopping-scraper.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Naver Shopping 네이버쇼핑**
  - [Naver Shopping Scraper](https://apify.com/zen-studio/naver-shopping-scraper)
  - [Naver Shopping Product Detail Scraper](https://apify.com/zen-studio/naver-product-detail-scraper)
  - [Naver Shopping Review Scraper](https://apify.com/zen-studio/naver-review-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-0hS9yNh3RU8DC6puG-LozxRJkdHN-coupang-review-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Coupang 쿠팡**
  - [Coupang Search Scraper](https://apify.com/zen-studio/coupang-search-scraper)
  - [Coupang Product Detail Scraper](https://apify.com/zen-studio/coupang-detail-scraper)
  - [Coupang Review Scraper](https://apify.com/zen-studio/coupang-review-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PsAKYWM55HG4AHXjK-ItywU7Bp0s-taobao-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Taobao 淘宝**
  - [Taobao Search Scraper](https://apify.com/zen-studio/taobao-search-scraper)
  - [Taobao Product Detail Scraper](https://apify.com/zen-studio/taobao-detail-scraper)
  - [Taobao Seller Products Scraper](https://apify.com/zen-studio/taobao-seller-products-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-uZy6tbKLKnSVtT4BN-emXnT123uR-jd-com-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **JD.com 京东**
  - [JD.com Search Scraper](https://apify.com/zen-studio/jd-com-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ghXSMZcW3GxsCrkiR-5hnvsKv4Yt-1688-wholesale-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **1688 阿里巴巴**
  - [1688 Wholesale Scraper](https://apify.com/zen-studio/1688-wholesale-scraper)
  - [Alibaba Scraper](https://apify.com/zen-studio/alibaba-scraper)
  - [1688 Reviews Scraper](https://apify.com/zen-studio/1688-reviews-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-5QcLc4BHaLMBUKYs3-f3CWQ60Row-goofish-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Goofish 闲鱼**
  - [Goofish (Xianyu) Search Scraper](https://apify.com/zen-studio/goofish-xianyu-search-scraper)
  - [Goofish (Xianyu) Seller Scraper](https://apify.com/zen-studio/goofish-xianyu-seller-scraper)
  - [Goofish (Xianyu) Item Detail Scraper](https://apify.com/zen-studio/goofish-xianyu-item-detail-scraper)
  - [Goofish (Xianyu) Item Comments & Q\&A Scraper](https://apify.com/zen-studio/goofish-xianyu-item-comments-scraper)
  - [Goofish (Xianyu) Reverse Image Search Scraper](https://apify.com/zen-studio/goofish-xianyu-visual-search-scraper)

**🎬 Short-video & social**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-3TJaaOJDU1AMiOoJM-Vu2eVr0P6N-douyin-profile-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Douyin 抖音**
  - [Douyin Search Scraper](https://apify.com/zen-studio/douyin-search-scraper)
  - [Douyin Profile Scraper](https://apify.com/zen-studio/douyin-profile-scraper)
  - [Douyin Video Scraper](https://apify.com/zen-studio/douyin-video-scraper)
  - [Douyin Comments Scraper](https://apify.com/zen-studio/douyin-comments-scraper)
  - [Douyin Transcripts Scraper](https://apify.com/zen-studio/douyin-transcripts-scraper)
  - [Douyin Creator Rankings Scraper](https://apify.com/zen-studio/douyin-xingtu-rankings-scraper)
  - [Douyin Live Recorder](https://apify.com/zen-studio/douyin-live-recorder)
  - [Douyin Hot Search Scraper](https://apify.com/zen-studio/douyin-hot-search-scraper)
  - [Douyin Product Search Scraper](https://apify.com/zen-studio/douyin-product-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-mHKEEgoDqr6btQQer-fUs5ZquIeN-xiaohongshu-search-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **RedNote 小红书**
  - [RedNote User Profile Scraper](https://apify.com/zen-studio/rednote-user-profile-scraper)
  - [RedNote Search Scraper](https://apify.com/zen-studio/rednote-search-scraper)
  - [RedNote Comments Scraper](https://apify.com/zen-studio/rednote-comments-scraper)
  - [RedNote Product Search Scraper](https://apify.com/zen-studio/rednote-product-search-scraper)
  - [RedNote Note Detail Scraper](https://apify.com/zen-studio/rednote-note-detail-scraper)
  - [RedNote Product Reviews Scraper](https://apify.com/zen-studio/rednote-product-reviews-scraper)
  - [RedNote Live Recorder](https://apify.com/zen-studio/rednote-live-recorder)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-dexCSKEZtKS8hg4fT-lD4weyiYga-shigua-____-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Xigua 西瓜视频**
  - [Xigua Video Search Scraper](https://apify.com/zen-studio/xigua-video-search-scraper)
  - [Xigua Video Detail Scraper](https://apify.com/zen-studio/xigua-video-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-oSxuPDE1h3HAsHZSu-x3uV98mgTe-bilibili-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Bilibili 哔哩哔哩**
  - [Bilibili Video Scraper](https://apify.com/zen-studio/bilibili-video-scraper)
  - [Bilibili Danmaku Scraper](https://apify.com/zen-studio/bilibili-danmaku-scraper)

**🏠 Real estate & autos**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-1tAzNSf8Kz0v7Q2Lr-AINJ7FsZVU-anjuke-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Anjuke 安居客**
  - [Anjuke For-Sale Listings Scraper](https://apify.com/zen-studio/anjuke-real-estate-scraper)
  - [Anjuke New-Home Scraper](https://apify.com/zen-studio/anjuke-new-home-scraper)
  - [Anjuke Rental Listings Scraper](https://apify.com/zen-studio/anjuke-rent-scraper)
  - [Anjuke Listing Detail Scraper](https://apify.com/zen-studio/anjuke-sale-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-32OkWqsiUywoq2ci3-7JhFlW1qg3-58__-real-estate-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **58.com 58同城**
  - [58.com Real Estate Scraper](https://apify.com/zen-studio/58-real-estate-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ytaE4YpSmjXDmibPv-L1UMPHa2bO-che168-autohome-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Autohome 汽车之家**
  - [Autohome (Che168) Used-Car Scraper](https://apify.com/zen-studio/che168-car-scraper)

### Support

- **Bugs**: Issues tab
- **Features**: Issues tab

### Legal Compliance

Extracts publicly available data. Users must comply with Naver's terms and data protection regulations (GDPR, CCPA, and Korea's 개인정보보호법 / PIPA).

***

*Korean property listings from Naver Real Estate: asking prices in KRW, sizes, floors, facing, agent details and building records, for apartments through to shops and land.*

# Actor input Schema

## `searchTerms` (type: `array`):

Where to look. Type a district, a neighbourhood, or a building name in Korean.<br><br>All of these work:<br>• <b>강남구</b> - a whole district, every neighbourhood in it<br>• <b>서울 강남구 대치동</b> - one neighbourhood<br>• <b>서울시</b> - a whole city (large, use the result limit below)<br>• <b>헬리오시티</b> - a building by name<br><br>A name that matches nothing is reported in the log rather than silently returning zero results.

## `propertyUrls` (type: `array`):

Links to specific properties or buildings, instead of searching.<br><br>Any of these work:<br>• <b>https://new.land.naver.com/complexes/135597?articleNo=2645147927</b> - one property<br>• <b>https://new.land.naver.com/articles/2645147927</b> - one property<br>• <b>https://new.land.naver.com/complexes/111515</b> - every property in one building<br><br>Anything that is not a property link is skipped with a note in the log.

## `complexIds` (type: `array`):

Collect every property listed in specific buildings, by reference number. Most people should use <b>Locations</b> or <b>Property links</b> above instead.

## `propertyTypes` (type: `array`):

Which kinds of property to collect. Leave empty for all of them.<br><br>Residential, commercial, industrial and land are all covered, including pre-sale rights (분양권) and whole buildings. Some types only exist in certain areas: 지식산업센터 and 공장·창고 cluster in industrial districts, 전원주택 in rural ones.

## `tradeTypes` (type: `array`):

Leave empty for all of them.<br><br><b>매매</b> is a sale, <b>전세</b> is a large lump-sum deposit with no monthly rent, <b>월세</b> is a deposit plus monthly rent, and <b>단기임대</b> is a short-term let.

## `priceMin` (type: `integer`):

In <b>만원</b> (10,000 KRW), the unit Naver uses. So <b>50000</b> is 5억, about 500 million KRW.<br><br>For 월세 and 단기임대 listings this applies to the deposit, not the monthly rent.

## `priceMax` (type: `integer`):

In <b>만원</b> (10,000 KRW). Leave empty for no upper limit.

## `areaMin` (type: `integer`):

In square metres, applied to 공급면적 (the supplied area). 84m² is the common Korean apartment size.

## `areaMax` (type: `integer`):

In square metres. Leave empty for no upper limit.

## `maxBuildAge` (type: `integer`):

Only buildings no older than this, in years. Leave empty for any age.

## `minBuildAge` (type: `integer`):

Only buildings at least this old, in years. Leave empty for any age.

## `directions` (type: `array`):

Which way the property faces. 남향 (south-facing) is the most sought-after in Korea and usually carries a price premium.<br><br>Choose several to include any of them.

## `features` (type: `array`):

Only return properties with these features. Choosing several narrows the results further, since a property must have all of them.

## `maxListings` (type: `integer`):

How many properties to collect in total. Set <b>0</b> to collect everything available for what you asked for.<br><br>A busy district holds far more than a quiet one, so this limit is what keeps a run predictable.

## `sortBy` (type: `string`):

<b>랭킹순</b> is Naver's own ordering. <b>최신순</b> puts the most recently listed first, and is the one to pick if you run this repeatedly and want new listings at the top.

## `includeDetail` (type: `boolean`):

Adds everything from the property's own page: full description, room and bathroom counts, move-in date, heating, parking, management costs, taxes, floor plans and photos.<br><br>A large run takes noticeably longer with this on.

## `includeBuildingInfo` (type: `boolean`):

For properties in an apartment complex, adds the building's own record: household and block counts, completion date, every floor plan type with its own official 한국부동산원 valuation, photos, and the assigned school.<br><br>Collected once per building and reused across all its properties. Studios, retail units and land usually have no building record, and those rows say so.

## `includeAgentContact` (type: `boolean`):

Adds the listing agency's name, registration number, address, phone numbers, the representative's name and the agency's profile links, as structured fields.<br><br><b>This is personal information about a named individual.</b> Korean privacy law (개인정보보호법) applies to how you store and use it, so it is off unless you turn it on. Requires full details above, which are switched on automatically.<br><br><b>Please note:</b> agents often write their own name, agency and mobile number into the free-text description of a listing. That description is part of the listing itself, so it is delivered whether or not this is switched on. Turning this off removes the structured contact fields, not text an agent chose to put in their own advert.

## Actor input object example

```json
{
  "searchTerms": [
    "서울 강남구 대치동"
  ],
  "propertyUrls": [],
  "complexIds": [],
  "propertyTypes": [],
  "tradeTypes": [],
  "directions": [],
  "features": [],
  "maxListings": 100,
  "sortBy": "rank",
  "includeDetail": false,
  "includeBuildingInfo": false,
  "includeAgentContact": false
}
```

# Actor output Schema

## `results` (type: `string`):

Default dataset: one row per listing. Everything Naver returns for the property, plus parsed prices in KRW, numeric floor and size, the neighbourhood it was found in, and a summary of its building.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "서울 강남구 대치동"
    ],
    "propertyUrls": [],
    "complexIds": [],
    "propertyTypes": [],
    "tradeTypes": [],
    "directions": [],
    "features": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/naver-land-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchTerms": ["서울 강남구 대치동"],
    "propertyUrls": [],
    "complexIds": [],
    "propertyTypes": [],
    "tradeTypes": [],
    "directions": [],
    "features": [],
}

# Run the Actor and wait for it to finish
run = client.actor("zen-studio/naver-land-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchTerms": [
    "서울 강남구 대치동"
  ],
  "propertyUrls": [],
  "complexIds": [],
  "propertyTypes": [],
  "tradeTypes": [],
  "directions": [],
  "features": []
}' |
apify call zen-studio/naver-land-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,zen-studio/naver-land-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/HngnV5OlFdsPYkaUS/builds/tM9JeutU1bOolg7JV/openapi.json