# KB 시세 Apartment Complex Valuation

**Use case:** 

Official KB 시세 valuations per apartment complex: sale high/avg/low, jeonse range, recent deal price and floor, households, build year, floors and GPS.

## Input

```json
{
  "scrapeMode": "detail",
  "searchMode": "bySerial",
  "bboxes": [
    "37.488,127.041,37.560,127.110"
  ],
  "complexSerials": [
    "2030",
    "1",
    "100",
    "500",
    "1000",
    "3000",
    "5000",
    "10000"
  ],
  "level": 15,
  "priceStatus": "2",
  "withPhotos": true,
  "filters": {},
  "maxResults": 25
}
```

## Output

```json
{
  "thumbnail": {
    "label": "🖼️ Thumbnail",
    "format": "string"
  },
  "id": {
    "label": "🆔 ID",
    "format": "string"
  },
  "url": {
    "label": "🔗 URL",
    "format": "string"
  },
  "source": {
    "label": "🏷️ Source",
    "format": "string"
  },
  "name": {
    "label": "📍 Region Name",
    "format": "string"
  },
  "parent_name": {
    "label": "🗂️ Parent Region",
    "format": "string"
  },
  "region_class": {
    "label": "🧭 Region Class",
    "format": "string"
  },
  "propertyTitle": {
    "label": "🏢 Complex Name",
    "format": "string"
  },
  "category": {
    "label": "🏷️ Property Type",
    "format": "string"
  },
  "category_code": {
    "label": "🔢 Property Type Code",
    "format": "string"
  },
  "is_reconstruction": {
    "label": "🏗️ Reconstruction",
    "format": "boolean"
  },
  "sale_price_avg_krw": {
    "label": "💰 Sale Avg (KRW)",
    "format": "integer"
  },
  "sale_price_high_krw": {
    "label": "💰 Sale High (KRW)",
    "format": "integer"
  },
  "sale_price_low_krw": {
    "label": "💰 Sale Low (KRW)",
    "format": "integer"
  },
  "jeonse_price_avg_krw": {
    "label": "🏦 Jeonse Avg (KRW)",
    "format": "integer"
  },
  "jeonse_price_high_krw": {
    "label": "🏦 Jeonse High (KRW)",
    "format": "integer"
  },
  "jeonse_price_low_krw": {
    "label": "🏦 Jeonse Low (KRW)",
    "format": "integer"
  },
  "monthly_rent_krw": {
    "label": "🗓️ Monthly Rent (KRW)",
    "format": "integer"
  },
  "monthly_deposit_krw": {
    "label": "🗓️ Monthly Deposit (KRW)",
    "format": "integer"
  },
  "sale_price_manwon": {
    "label": "💴 Sale Avg (만원)",
    "format": "integer"
  },
  "jeonse_price_manwon": {
    "label": "💴 Jeonse Avg (만원)",
    "format": "integer"
  },
  "recent_deal_price_krw": {
    "label": "🤝 Recent Deal (KRW)",
    "format": "integer"
  },
  "recent_deal_floor": {
    "label": "🏢 Recent Deal Floor",
    "format": "string"
  },
  "recent_deal_date": {
    "label": "📅 Recent Deal Date",
    "format": "string"
  },
  "is_ai_valuation": {
    "label": "🤖 AI Valuation",
    "format": "boolean"
  },
  "listing_count_sale": {
    "label": "📈 Sale Listings",
    "format": "integer"
  },
  "listing_count_jeonse": {
    "label": "📈 Jeonse Listings",
    "format": "integer"
  },
  "listing_count_monthly": {
    "label": "📈 Monthly Listings",
    "format": "integer"
  },
  "sale_price_per_pyeong_krw": {
    "label": "📐 Sale per Pyeong (KRW)",
    "format": "integer"
  },
  "jeonse_price_per_pyeong_krw": {
    "label": "📐 Jeonse per Pyeong (KRW)",
    "format": "integer"
  },
  "jeonse_ratio": {
    "label": "📊 Jeonse Ratio",
    "format": "number"
  },
  "monthly_sale_change_pct": {
    "label": "📉 Monthly Change %",
    "format": "number"
  },
  "deal_count_sale": {
    "label": "🔢 Sale Deal Count",
    "format": "integer"
  },
  "base_date": {
    "label": "📅 Valuation Base Date",
    "format": "string"
  },
  "build_year": {
    "label": "🏗️ Build Year",
    "format": "integer"
  },
  "build_date": {
    "label": "📅 Build Date",
    "format": "string"
  },
  "households_total": {
    "label": "🏘️ Total Households",
    "format": "integer"
  },
  "households_general": {
    "label": "🏘️ General Households",
    "format": "integer"
  },
  "buildings_total": {
    "label": "🏢 Buildings",
    "format": "integer"
  },
  "floor_max": {
    "label": "⬆️ Max Floor",
    "format": "integer"
  },
  "floor_min": {
    "label": "⬇️ Min Floor",
    "format": "integer"
  },
  "parking_total": {
    "label": "🅿️ Parking Spaces",
    "format": "integer"
  },
  "parking_per_household": {
    "label": "🅿️ Parking/Household",
    "format": "number"
  },
  "heating_type": {
    "label": "🔥 Heating Type",
    "format": "string"
  },
  "heating_fuel": {
    "label": "⛽ Heating Fuel",
    "format": "string"
  },
  "builder": {
    "label": "🏗️ Builder",
    "format": "string"
  },
  "far": {
    "label": "📐 Floor Area Ratio",
    "format": "number"
  },
  "bcr": {
    "label": "📐 Building Coverage Ratio",
    "format": "number"
  },
  "area_supply_m2": {
    "label": "📏 Supply Area (m²)",
    "format": "number"
  },
  "area_exclusive_m2": {
    "label": "📏 Exclusive Area (m²)",
    "format": "number"
  },
  "area_supply_pyeong": {
    "label": "📏 Supply Area (평)",
    "format": "number"
  },
  "address_road": {
    "label": "📮 Road Address",
    "format": "string"
  },
  "address_jibun": {
    "label": "📮 Jibun Address",
    "format": "string"
  },
  "dong_name": {
    "label": "📍 Dong",
    "format": "string"
  },
  "legal_dong_code": {
    "label": "🔢 Legal Dong Code",
    "format": "string"
  },
  "postal_code": {
    "label": "📮 Postal Code",
    "format": "string"
  },
  "latitude": {
    "label": "🌐 Latitude",
    "format": "number"
  },
  "longitude": {
    "label": "🌐 Longitude",
    "format": "number"
  },
  "regulations": {
    "label": "⚖️ Regulations",
    "format": "array"
  },
  "unit_types": {
    "label": "🏠 Unit Types",
    "format": "array"
  },
  "representative_area_serial": {
    "label": "🔢 Rep. Area Serial",
    "format": "string"
  },
  "photos": {
    "label": "📷 Photos",
    "format": "array"
  },
  "image_count": {
    "label": "🔢 Image Count",
    "format": "integer"
  },
  "currency": {
    "label": "💱 Currency",
    "format": "string"
  },
  "metadata": {
    "label": "🧾 Run Metadata",
    "format": "object"
  }
}
```

## About this Actor

This example demonstrates how to use [KB Land Scraper — South Korea Property Data & KB 시세 API](https://apify.com/sian.agency/kbland-property-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/sian.agency/kbland-property-scraper.md) to learn more, explore other use cases, and run it yourself.


## 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.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **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 full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/sian.agency/kbland-property-scraper.md

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