# Dabang 다방 Scraper: Korea Rent Data, Deal Labels & Price Drops (`getascraper/dabang-property-listings-scraper`) Actor

Scrape Dabang 다방 rentals and officetel sales by Korean district or neighborhood. Get deposit, rent and maintenance as numbers, a comparable monthly cost, price per pyeong, below-market deal labels, photos, and new, price-drop and removed tracking. No login. Pay per listing.

- **URL**: https://apify.com/getascraper/dabang-property-listings-scraper.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** Real estate, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🏠 Dabang 다방 Scraper: Korea Rent Data, Deal Labels & Price Drops

<table width="100%" style="margin-bottom:0">
<tr>
<td style="padding:24px 28px;background:#EAF1FF;border:1px solid #C6D7F8;border-top:4px solid #1D4FD8;border-radius:12px">
<span style="font-size:23px;font-weight:800;color:#0F172A;line-height:1.3">Korean rental prices from Dabang, ready to compare and watch.</span><br>
<span style="font-size:15px;color:#475569;line-height:1.6">Pull 다방 listings for any Seoul district or Korean neighborhood. Deposit, rent and maintenance come as numbers, with a monthly cost that puts 월세 and 전세 on one scale, a price per pyeong and a deal label on every listing.</span>
</td>
</tr>
</table>
<table width="100%" style="margin-top:0">
<tr>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C6D7F8;border-radius:10px 0 0 10px;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#14327A">📐 Real monthly cost</span><br>
<span style="font-size:12px;color:#475569">Deposit, rent and maintenance as numbers, plus one comparable monthly cost so 월세 and 전세 line up.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C6D7F8;border-left:none;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#14327A">💸 Deal labels</span><br>
<span style="font-size:12px;color:#475569">Price per m² and per pyeong, compared with similar homes: BELOW_MARKET, AT_MARKET or ABOVE_MARKET.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C6D7F8;border-left:none;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#14327A">🗺️ Many areas, one run</span><br>
<span style="font-size:12px;color:#475569">Search several districts at once and get median, lowest and highest prices for every neighborhood.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C6D7F8;border-left:none;border-radius:0 10px 10px 0;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#14327A">🔔 Change monitor</span><br>
<span style="font-size:12px;color:#475569">NEW, PRICE_DROP, PRICE_UP and REMOVED labels with days on market between scheduled runs.</span>
</td>
</tr>
</table>

Looking for a Dabang scraper for Seoul rents? This Actor reads the public 다방 (Dabang) listings for one-room, two-room and officetel homes and turns them into clean rows for a spreadsheet, a database or an alert. Each row has the deposit, monthly rent, maintenance fee, area, floor, photos, listing signals and an approximate map point.

This Actor is not affiliated with or endorsed by Dabang. It reads only listings that anyone can see without an account.

### 🔍 What does this Actor do?

Dabang shows rents one card at a time. This Actor turns a search into a price table.

- Searches by Korean district or neighborhood name, one area or many in the same run, and removes duplicates between overlapping areas.
- Filters on Dabang itself by deposit, monthly rent, sale price, room layout, floor type, building age, elevator, parking, short lease, duplex, separated layout and 360 degree photos.
- Covers one-room and two-room homes, officetels, and officetel sales (매매).
- Converts prices written the Korean way (1억3000, 2억8800) into numbers in 만원 and in won, and adds area in m² and pyeong.
- Adds an effective monthly cost: rent + maintenance + deposit x yearly rate / 12. You set the rate, so a 월세 home and a 전세 home can be compared fairly.
- Compares each listing with similar listings in your run and labels it BELOW_MARKET, AT_MARKET or ABOVE_MARKET, with the percent gap and percentile.
- Saves neighborhood statistics (median, average, lowest and highest) for every deal type.
- Tracks a saved search between runs and labels each listing NEW, PRICE_DROP, PRICE_UP, UPDATED, UNCHANGED or REMOVED, with days on market.

### 🎯 What can I use it for?

- **Proptech and market analysts:** build rent and deposit benchmarks by neighborhood, room type and price per pyeong.
- **Relocation and expat housing agencies:** shortlist homes under a monthly budget and watch for new ones in the districts clients ask about.
- **Real estate investors:** find listings priced under their neighborhood median and track price cuts and days on market.
- **Researchers and journalists:** study jeonse versus monthly rent and how Seoul rents move over time.
- **Data teams:** feed a clean daily table into a dashboard or pipeline.

### 🚀 How to use it

<table width="100%">
<tr>
<td style="padding:16px 14px;width:33%;background:#EAF1FF;border:1px solid #C6D7F8;border-radius:10px 0 0 10px;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#1D4FD8;letter-spacing:1px">STEP 1</span><br>
<span style="font-size:14px;font-weight:700;color:#0F172A">Type an area</span><br>
<span style="font-size:12px;color:#475569">Enter a district or neighborhood in Hangul, such as 강남구, and pick rent, jeonse or sale.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#EAF1FF;border:1px solid #C6D7F8;border-left:none;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#1D4FD8;letter-spacing:1px">STEP 2</span><br>
<span style="font-size:14px;font-weight:700;color:#0F172A">Run it</span><br>
<span style="font-size:12px;color:#475569">Start with the default of 24 listings, then raise the limit to cover whole neighborhoods.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#EAF1FF;border:1px solid #C6D7F8;border-left:none;border-radius:0 10px 10px 0;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#1D4FD8;letter-spacing:1px">STEP 3</span><br>
<span style="font-size:14px;font-weight:700;color:#0F172A">Export or monitor</span><br>
<span style="font-size:12px;color:#475569">Download CSV, Excel or JSON, or add a monitor name and put the run on a schedule.</span>
</td>
</tr>
</table>

### 📥 Input

Every field is optional. With nothing changed you get 24 monthly-rent and jeonse listings from 강남구. Amounts are in 만원 (10,000 KRW).

| Field | Type | Required | Description |
|---|---|---|---|
| Korean search area | text | No | A Korean district or neighborhood in Hangul, such as 강남구, 역삼동 or 마포구. Broad districts expand into their neighborhoods, up to the neighborhood limit below. You can also paste an 8-digit Dabang neighborhood code. |
| More search areas | array of text | No | Extra districts or neighborhoods to search in the same run, one per line, for example 서초구 or 송파구. Leave empty to search only the area above. |
| Neighborhoods per area | integer | No | How many matching Dabang neighborhoods to search for each area you entered. A district such as 강남구 contains about a dozen neighborhoods. |
| Property group | enum | No | Which Dabang property group to read. Officetels also include sale listings (매매); one-room and two-room listings are rentals only. |
| Deal types | array of enum | No | Monthly rent, jeonse, sale, or any mix. Leave empty to use monthly rent and jeonse. |
| Room layouts | array of enum | No | Limit by number of rooms. Leave empty for every layout. |
| Floors | array of enum | No | Limit by floor type. Leave empty for every floor type. |
| Minimum deposit | integer | No | Lowest deposit (보증금) in 만원 (10,000 KRW). 1000 means 10 million KRW. |
| Maximum deposit | integer | No | Highest deposit (보증금) in 만원. 5000 means 50 million KRW. |
| Minimum monthly rent | integer | No | Lowest monthly rent (월세) in 만원. |
| Maximum monthly rent | integer | No | Highest monthly rent (월세) in 만원. 70 means 700,000 KRW a month. |
| Count maintenance in the rent filter | boolean | No | When on, the monthly rent limits also include the maintenance fee (관리비). |
| Maximum sale price | integer | No | Highest sale price (매매가) in 만원 for officetel sales. |
| Minimum area | number | No | Smallest floor area in square meters. 33 m² is about 10 pyeong. |
| Maximum area | number | No | Largest floor area in square meters. |
| Maximum building age | integer | No | Only buildings approved for use within this many years. 5 keeps near-new buildings. |
| Elevator | boolean | No | Only buildings with an elevator. |
| Parking | boolean | No | Only homes where parking is possible. |
| Short lease possible | boolean | No | Only homes that accept short leases (단기). |
| 360 degree photos | boolean | No | Only listings with panorama photos. |
| Duplex | boolean | No | Only duplex homes (복층). Applies to one-room and two-room listings. |
| Separated layout | boolean | No | Only homes with a separated bedroom (분리형). Applies to one-room and two-room listings. |
| Direct listings | boolean | No | Only listings marked as direct by the owner (직거래). |
| Deposit yearly rate | number | No | Yearly rate used to turn a deposit into a monthly cost, so monthly rent and jeonse can be compared. Effective monthly cost = rent + maintenance + deposit x rate / 12. |
| Monitor name | text | No | Give the search a name to track it between runs. Each listing is then marked NEW, PRICE_DROP, PRICE_UP, UPDATED, UNCHANGED or REMOVED. Use the same name and the same filters on every run. |
| Only changed listings | boolean | No | With a monitor name, save only new, changed and removed listings and skip unchanged ones. |
| Maximum listings | integer | No | Stop after this many unique listings. The default gives a quick sample; raise it to cover whole neighborhoods. Free plan runs are capped at 25 listings. |
| Pages per neighborhood | integer | No | Pages read for each neighborhood and property group. Each page holds about 24 listings. |

### 📊 Data table

Fields a listing does not show are left out of the row. Nothing is filled with placeholders. Dabang listing results do not include street addresses, phone numbers or the full description page, so the Actor does not return them.

| Field | Type | Description |
|---|---|---|
| `listingId` | text | Dabang listing ID. Stable across runs, so it works as a database key. |
| `url` | text | Link to the listing on Dabang. Shown as a link only; the Actor does not open it. |
| `title` | text | Listing headline written by the poster, in Korean. |
| `description` | text | Card line with floor, area and maintenance fee, as shown. |
| `category` | text | Which Dabang feed found the listing: `one-two` or `officetel`. |
| `dealType` | text | `MONTHLY_RENT`, `LEASE` (jeonse) or `SELL`. |
| `dealTypeKo` | text | Deal type in Korean: 월세, 전세 or 매매. |
| `propertyType` | text | Property type as Dabang labels it, such as 원룸, 투룸, 오피스텔 or 아파트. |
| `roomTypeLabel` | text | Room type text exactly as shown, including the 단기 tag. |
| `shortLeaseAvailable` | boolean | True when Dabang tags the home as open to short leases. |
| `buildingName` | text | Building or complex name, when shown. |
| `priceLabel` | text | Price exactly as shown, for example `1000/80` or `2억8800`. |
| `depositManwon` | number | Deposit (보증금) in 만원. For monthly rent and jeonse. |
| `monthlyRentManwon` | number | Monthly rent (월세) in 만원. |
| `salePriceManwon` | number | Sale price (매매가) in 만원. Sales only. |
| `depositKrw` | number | Deposit in Korean won. |
| `monthlyRentKrw` | number | Monthly rent in Korean won. |
| `salePriceKrw` | number | Sale price in Korean won. |
| `maintenanceFeeKrw` | number | Monthly maintenance fee (관리비) in won. 0 when the card says no fee. |
| `monthlyOutlayKrw` | number | Rent plus maintenance fee: what leaves your account each month. |
| `conversionRatePercent` | number | Yearly deposit rate used for the effective monthly cost. |
| `effectiveMonthlyCostKrw` | number | Rent + maintenance + deposit x rate / 12. Lets monthly rent and jeonse be compared. |
| `areaSqm` | number | Floor area in square meters. |
| `areaPyeong` | number | Floor area in pyeong (1 pyeong = 3.3058 m²). |
| `effectiveMonthlyCostPerSqmKrw` | number | Effective monthly cost divided by area in m². |
| `effectiveMonthlyCostPerPyeongKrw` | number | Effective monthly cost divided by area in pyeong. |
| `depositPerSqmKrw` | number | Deposit divided by area in m². |
| `salePricePerSqmKrw` | number | Sale price divided by area in m². |
| `salePricePerPyeongKrw` | number | Sale price divided by area in pyeong. |
| `floorLabel` | text | Floor text as shown, for example 4층 or 고층. |
| `floorNumber` | number | Floor number when Dabang shows an exact floor. |
| `floorBand` | text | `LOW`, `MID`, `HIGH`, `SEMI_BASEMENT` or `ROOFTOP` when Dabang shows a band instead of a number. |
| `neighborhood` | text | Neighborhood name (동). |
| `regionCode` | text | Dabang neighborhood code. Usable as a search area. |
| `regionName` | text | Full area name, for example 서울특별시 강남구 역삼동. |
| `province` | text | City or province. |
| `district` | text | District (구). |
| `searchedArea` | text | The search area you entered that led to this listing. |
| `approximateLatitude` | number | Approximate latitude. Dabang shifts map points on purpose, so this is not the exact address. |
| `approximateLongitude` | number | Approximate longitude. |
| `locationPrecision` | text | Always `approximate` when coordinates are present. |
| `primaryImageUrl` | text | Main photo link. |
| `imageUrls` | array | Photo links shown on the listing card. |
| `imageCount` | number | Number of photos. |
| `isDirect` | boolean | True for direct listings (직거래). |
| `isOwnerListing` | boolean | True when posted by the owner. |
| `ownerVerified` | boolean | True when the owner is verified. |
| `naverVerified` | boolean | True when the listing carries Naver verification. |
| `naverVerifiedDate` | text | Naver verification date, as shown. |
| `lhLease` | boolean | True for LH public-lease homes. |
| `hasPanorama` | boolean | True when 360 degree photos exist. |
| `quickMoveIn` | boolean | True when tagged for quick move-in. |
| `isPremiumListing` | boolean | True when the listing sits in Dabang's premium block. |
| `highlightTag` | text | Dabang highlight such as `NEW_CONSTRUCTIONS` or `PETS_ALLOWED`. |
| `agencyName` | text | Brokerage office name. Only on premium listings. |
| `agencyActiveListings` | number | Active listings of that brokerage. Only on premium listings. |
| `comparableListings` | number | Similar listings in your run used for the comparison (at least 5). |
| `comparisonScope` | text | `NEIGHBORHOOD` or `ALL_SEARCHED_AREAS`. |
| `peerMedianCostPerSqmKrw` | number | Median cost per m² of the comparable listings. |
| `priceVsMedianPercent` | number | How far the listing is above (+) or below (-) that median, in percent. |
| `pricePercentile` | number | Share of comparable listings that are cheaper, 0 to 100. |
| `dealLabel` | text | `BELOW_MARKET` (15% or more under the median), `AT_MARKET` or `ABOVE_MARKET`. |
| `changeType` | text | With a monitor name: `NEW`, `PRICE_DROP`, `PRICE_UP`, `UPDATED`, `UNCHANGED` or `REMOVED`. |
| `changedFields` | array | Which fields changed since the previous run. |
| `firstSeenAt` | text | When the monitor first saw the listing. |
| `daysOnMarket` | number | Days since the monitor first saw it. |
| `previousPriceLabel` | text | Price shown in the previous run. |
| `previousEffectiveMonthlyCostKrw` | number | Effective monthly cost in the previous run. |
| `effectiveMonthlyCostChangeKrw` | number | Change in effective monthly cost since the previous run. |
| `removedAt` | text | When a removed listing was noticed as gone. |
| `scrapedAt` | text | When the listing was collected. |

The run also saves two records in its key-value store: `RUN_SUMMARY` (pages read, listings saved, change counts, notes) and `REGION_SUMMARY` (deposit, rent, maintenance, effective monthly cost and cost per m² statistics for each neighborhood and deal type).

### 💰 Pricing

You pay per listing saved. A run that finds no listings costs nothing, and there are no subscriptions. Paid Apify plans get lower per-listing prices. The default run of 24 listings is a small, quick test. Free plan runs are limited to 25 listings per run, 3 runs per 24 hours, and a 30 minute wait between runs.

### ⭐ Enjoying Dabang 다방 Scraper: Korea Rent Data, Deal Labels & Price Drops?

<table width="100%" style="display:table;width:100%">
<tr>
<td style="padding:20px 24px 14px;background:#EAF1FF;border:1px solid #C6D7F8;border-left:5px solid #1D4FD8;border-radius:10px 10px 0 0">
<span style="font-size:20px;letter-spacing:4px">⭐ ⭐ ⭐ ⭐ ⭐</span><br>
<span style="font-size:17px;font-weight:800;color:#0F172A">Comparing Korean rents by hand is worth a quick rating.</span><br>
<span style="font-size:14px;color:#475569">A 5-star rating takes 10 seconds and helps other analysts and housing teams find this Actor. Your feedback also tells us which filters to add next.</span>
</td>
</tr>
<tr>
<td style="padding:0;background:#1D4FD8;border:1px solid #C6D7F8;border-top:none;border-radius:0 0 10px 10px;text-align:center">
<a href="https://apify.com/getascraper/dabang-property-listings-scraper/reviews" style="display:block;padding:13px 16px;color:#FFFFFF;text-decoration:none;font-weight:800;font-size:15px;letter-spacing:0.3px">★&nbsp;&nbsp;Rate this Actor on Apify</a>
</td>
</tr>
</table>

### ❓ FAQ

#### Does the Dabang scraper need an account or login?

No. The Actor reads the public listing results that anyone can open. It never asks for a login, password, cookie or API key, and it never contacts an agent or an owner.

#### How do I get rents for one Seoul neighborhood from Dabang?

Type the neighborhood in Hangul, for example 역삼동, set the deal type and room layout, and raise "Maximum listings" and "Pages per neighborhood" to cover everything. Add a monitor name and a schedule to catch new listings and price drops.

#### How is the effective monthly cost calculated?

Rent + maintenance fee + deposit x yearly rate / 12, with the rate set by "Deposit yearly rate" (5% by default). A jeonse home has no rent, so its cost is the maintenance fee plus the deposit cost. This puts 월세 and 전세 listings on one scale. It is a comparison tool, not a quote.

#### Does it return exact addresses or agent phone numbers?

No. Dabang listing results do not contain them, and the Actor never opens the individual listing page. Map points are approximate on purpose: Dabang shifts them, so use them for area-level maps only.

### 🔗 Other actors

- [Lianjia Scraper 链家: China Resale Listings, Prices & Communities](https://apify.com/getascraper/lianjia-real-estate-scraper) ↗ - Chinese resale homes with prices and communities.
- [Gmarket Korea Scraper: Prices in KRW, USD & BigSmile Deals](https://apify.com/getascraper/gmarket-scraper) ↗ - Korean marketplace prices and deals.
- [Musinsa Scraper: 무신사 크롤러](https://apify.com/getascraper/musinsa-scraper) ↗ - Korean fashion products and prices.
- [Property24 Scraper: Real Estate Listings, Prices & Broker Leads](https://apify.com/getascraper/property24-scraper) ↗ - South African property listings.
- [NYC Rentals and Sales Scraper for StreetEasy: Comps, Price Cuts](https://apify.com/getascraper/streeteasy-scraper) ↗ - New York rentals and sales with price cuts.

# Changelog

This Actor's version history is a separate document: https://apify.com/getascraper/dabang-property-listings-scraper/changelog.md

# Actor input Schema

## `locationQuery` (type: `string`):

A Korean district or neighborhood in Hangul, such as 강남구, 역삼동 or 마포구. Broad districts expand into their neighborhoods, up to the neighborhood limit below. You can also paste an 8-digit Dabang neighborhood code.

## `additionalLocationQueries` (type: `array`):

Extra districts or neighborhoods to search in the same run, one per line, for example 서초구 or 송파구. Leave empty to search only the area above.

## `maxRegions` (type: `integer`):

How many matching Dabang neighborhoods to search for each area you entered. A district such as 강남구 contains about a dozen neighborhoods.

## `category` (type: `string`):

Which Dabang property group to read. Officetels also include sale listings (매매); one-room and two-room listings are rentals only.

## `dealTypes` (type: `array`):

Monthly rent, jeonse, sale, or any mix. Leave empty to use monthly rent and jeonse.

## `roomTypes` (type: `array`):

Limit by number of rooms. Leave empty for every layout.

## `floorTypes` (type: `array`):

Limit by floor type. Leave empty for every floor type.

## `minDepositManwon` (type: `integer`):

Lowest deposit (보증금) in 만원 (10,000 KRW). 1000 means 10 million KRW.

## `maxDepositManwon` (type: `integer`):

Highest deposit (보증금) in 만원. 5000 means 50 million KRW.

## `minRentManwon` (type: `integer`):

Lowest monthly rent (월세) in 만원.

## `maxRentManwon` (type: `integer`):

Highest monthly rent (월세) in 만원. 70 means 700,000 KRW a month.

## `includeMaintenanceInRent` (type: `boolean`):

When on, the monthly rent limits also include the maintenance fee (관리비).

## `maxSalePriceManwon` (type: `integer`):

Highest sale price (매매가) in 만원 for officetel sales.

## `minAreaSqm` (type: `number`):

Smallest floor area in square meters. 33 m² is about 10 pyeong.

## `maxAreaSqm` (type: `number`):

Largest floor area in square meters.

## `maxBuildingAgeYears` (type: `integer`):

Only buildings approved for use within this many years. 5 keeps near-new buildings.

## `onlyElevator` (type: `boolean`):

Only buildings with an elevator.

## `onlyParking` (type: `boolean`):

Only homes where parking is possible.

## `onlyShortLease` (type: `boolean`):

Only homes that accept short leases (단기).

## `onlyPanorama` (type: `boolean`):

Only listings with panorama photos.

## `onlyDuplex` (type: `boolean`):

Only duplex homes (복층). Applies to one-room and two-room listings.

## `onlySeparatedRooms` (type: `boolean`):

Only homes with a separated bedroom (분리형). Applies to one-room and two-room listings.

## `onlyDirect` (type: `boolean`):

Only listings marked as direct by the owner (직거래).

## `depositConversionRatePercent` (type: `number`):

Yearly rate used to turn a deposit into a monthly cost, so monthly rent and jeonse can be compared. Effective monthly cost = rent + maintenance + deposit x rate / 12.

## `monitorName` (type: `string`):

Give the search a name to track it between runs. Each listing is then marked NEW, PRICE_DROP, PRICE_UP, UPDATED, UNCHANGED or REMOVED. Use the same name and the same filters on every run.

## `onlyChanges` (type: `boolean`):

With a monitor name, save only new, changed and removed listings and skip unchanged ones.

## `maxItems` (type: `integer`):

Stop after this many unique listings. The default gives a quick sample; raise it to cover whole neighborhoods. Free plan runs are capped at 25 listings.

## `maxPagesPerRegion` (type: `integer`):

Pages read for each neighborhood and property group. Each page holds about 24 listings.

## Actor input object example

```json
{
  "locationQuery": "강남구",
  "additionalLocationQueries": [],
  "maxRegions": 5,
  "category": "one-two",
  "dealTypes": [
    "MONTHLY_RENT",
    "LEASE"
  ],
  "roomTypes": [],
  "floorTypes": [],
  "includeMaintenanceInRent": false,
  "onlyElevator": false,
  "onlyParking": false,
  "onlyShortLease": false,
  "onlyPanorama": false,
  "onlyDuplex": false,
  "onlySeparatedRooms": false,
  "onlyDirect": false,
  "depositConversionRatePercent": 5,
  "onlyChanges": false,
  "maxItems": 24,
  "maxPagesPerRegion": 10
}
```

# Actor output Schema

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

No description

## `summary` (type: `string`):

No description

## `neighborhoods` (type: `string`):

No description

# 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 = {
    "locationQuery": "강남구",
    "additionalLocationQueries": [],
    "maxRegions": 5,
    "category": "one-two",
    "dealTypes": [
        "MONTHLY_RENT",
        "LEASE"
    ],
    "roomTypes": [],
    "floorTypes": [],
    "includeMaintenanceInRent": false,
    "onlyElevator": false,
    "onlyParking": false,
    "onlyShortLease": false,
    "onlyPanorama": false,
    "onlyDuplex": false,
    "onlySeparatedRooms": false,
    "onlyDirect": false,
    "depositConversionRatePercent": 5,
    "onlyChanges": false,
    "maxItems": 24,
    "maxPagesPerRegion": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/dabang-property-listings-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 = {
    "locationQuery": "강남구",
    "additionalLocationQueries": [],
    "maxRegions": 5,
    "category": "one-two",
    "dealTypes": [
        "MONTHLY_RENT",
        "LEASE",
    ],
    "roomTypes": [],
    "floorTypes": [],
    "includeMaintenanceInRent": False,
    "onlyElevator": False,
    "onlyParking": False,
    "onlyShortLease": False,
    "onlyPanorama": False,
    "onlyDuplex": False,
    "onlySeparatedRooms": False,
    "onlyDirect": False,
    "depositConversionRatePercent": 5,
    "onlyChanges": False,
    "maxItems": 24,
    "maxPagesPerRegion": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/dabang-property-listings-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 '{
  "locationQuery": "강남구",
  "additionalLocationQueries": [],
  "maxRegions": 5,
  "category": "one-two",
  "dealTypes": [
    "MONTHLY_RENT",
    "LEASE"
  ],
  "roomTypes": [],
  "floorTypes": [],
  "includeMaintenanceInRent": false,
  "onlyElevator": false,
  "onlyParking": false,
  "onlyShortLease": false,
  "onlyPanorama": false,
  "onlyDuplex": false,
  "onlySeparatedRooms": false,
  "onlyDirect": false,
  "depositConversionRatePercent": 5,
  "onlyChanges": false,
  "maxItems": 24,
  "maxPagesPerRegion": 10
}' |
apify call getascraper/dabang-property-listings-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/dabang-property-listings-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/diPtKaOyNFcVXWsQb/builds/jRH5nrd2KjbVGTjCm/openapi.json