# Yungching Scraper - Taiwan Homes for Sale (`normdata/yungching-scraper`) Actor

Scrape homes for sale on Yungching (永慶房仲網), a top Taiwan broker, in all 22 counties. Price in 萬 and NTD, price cuts, parking price, district, community, type, age, ping and m², layout, floor, MRT. Add agent, branch, land, zoning, mortgage. 20 filters, no proxy.

- **URL**: https://apify.com/normdata/yungching-scraper.md
- **Developed by:** [Norm Data](https://apify.com/normdata) (community)
- **Categories:** Real estate
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $13.00 / 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

![Norm Data](https://raw.githubusercontent.com/FabriAV/normdata/refs/heads/main/assets/banner_norm2.png)

## 🏠 Yungching Scraper - Taiwan Homes for Sale

**Yungching Scraper** extracts **homes for sale from Yungching (永慶房仲網)**, one of Taiwan's biggest real estate brokers, with about **190,000 listings** in all 22 cities and counties. For each home you get the **price in 萬 and NTD, price cuts, district, community, type, age, area in ping and m², layout and floor**.

Turn on **Details** to add the **agent, company and branch**, land area, zoning and the monthly mortgage. Narrow the search with **20 filters** like price, rooms, age and nearby MRT. Use it to **track prices, find price cuts or build lead lists of agents**: 1,000 listings in about 20 seconds.

> 👉 **Try it now:** press **Start**. The ready-made input gives you 10 listings in a few seconds.<br>
> 💰 **$0.018 per listing** on the Free plan (10 listings per run), from $0.016 on paid plans. [See pricing](#-pricing)

### ✨ Why this scraper?

> - **All 190,000 listings**<br>
>   No page cap: every page of a city is read, so Taichung with 59,000 listings gives 59,000 rows.
>
> - **20 filters and 11 sort orders**<br>
>   Use, building type, price, area, rooms, age, floor, bathrooms, parking, facing, features, nearby places and quick filters like price cut.
>
> - **Clean results**<br>
>   Promoted cards that the site mixes into every list are left out, so what you get matches what you asked for.
>
> - **Clean, typed data**<br>
>   Prices as numbers in 萬 and NTD, areas in ping and m², English names for cities and building types.
>
> - **Agents and branches**<br>
>   With Details: agent, company, branch, zoning, land area and the monthly mortgage.
>
> - **Fast and easy**<br>
>   No proxy or login. Or just paste Yungching search links.
>
> - **Apify platform**<br>
>   Schedule daily runs, get only new listings, export to Excel or CSV, or connect Google Sheets, Zapier and Make.

### 🚀 How to scrape Yungching

1. Create a free Apify account.
2. Pick the filters you need, or keep the ready-made input.
3. Click **Start**.
4. Download the listings as Excel, CSV or JSON from the **Output** tab.

### 💰 Pricing

#### How much does it cost to scrape Yungching?

You pay a one-time **$0.003** per run, plus a price for each listing saved (and for each add-on you turn on):

| Charged for | Free | Bronze | Silver | Gold+ |
| --- | --- | --- | --- | --- |
| **Listing**: One home for sale saved to the dataset | 0.018 | 0.016 | 0.0145 | 0.013 |
| **Details**: House page read for agent, branch, land, zoning and mortgage (Details on) | 0.007 | 0.0063 | 0.0056 | 0.005 |

Example: 1,000 listings cost about **$16** on Bronze. No proxy or compute costs on top.

### 📦 What data you get

| Field | Description |
| --- | --- |
| `imageUrl` | Main photo. |
| `id` | Yungching house id. |
| `title` | Listing title. |
| `priceWan`, `priceNtd` | Asking price in 萬 (10,000 NTD) as on the site, and in NTD. |
| `originalPriceWan`, `priceCutWan`, `priceCutPercent` | First asking price, the cut in 萬 and in percent, when the price went down. |
| `parkingPriceWan` | Parking price included in the price, when the site gives it. |
| `county`, `countyEn`, `district`, `zipCode` | County in Chinese and English, district and zip code. |
| `address` | Street (the site hides the house number). |
| `community` | Building or community name. |
| `propertyType`, `propertyTypeEn` | Property type in Chinese and English, like 住宅大樓 (High-rise residential). |
| `age`, `ageYears` | Building age as shown ("46.9年") and in years. |
| `buildingAreaPing`, `buildingAreaM2` | Registered building area (建坪), in ping and m². |
| `mainAreaPing`, `mainAreaM2`, `mainAreaParts` | Main building plus balcony or platform area, in ping and m², and which parts it counts ("主+陽"). |
| `floor`, `totalFloors` | Floor of the unit (can be a range like "B1~4") and floors in the building. |
| `layout`, `bedrooms`, `livingRooms`, `bathrooms`, `addedLayout` | Layout as shown ("3房(室)2廳1衛"), its bedrooms, living rooms and bathrooms, and the part added later (加蓋). |
| `highlight` | The agent's one line pitch on the card. |
| `agency` | Brand that lists it: 永慶房屋 (Yungching direct), 永慶不動產, 有巢氏房屋 or 台慶不動產. |
| `caseNumber` | *(Details)* Case number on the house page (YC1270108). |
| `unitPriceWanPerPing` | *(Details)* Price per ping in 萬. |
| `description` | *(Details)* The agent's description. |
| `agentName`, `companyName`, `branchName` | *(Details)* Agent name, company and branch. |
| `mainBuildingPing`, `sharedAreaPing`, `attachedAreaPing`, `attachedAreaParts` | *(Details)* Area parts in ping: main building, shared parts, attached parts and what they are. |
| `landAreaPing`, `landAreaM2` | *(Details)* Land share in ping and m². |
| `zoning`, `registeredUse` | *(Details)* Land zoning and registered use. |
| `monthlyMortgageNtd` | *(Details)* The site's monthly mortgage estimate in NTD. |
| `isExclusive` | Exclusive listing (專任委託). |
| `isNew` | Newly listed (新上). |
| `isRented` | Sold with a tenant (出租中). |
| `hasParking` | Price includes parking. |
| `hasVrTour`, `hasAiStaging` | Has a VR tour, has AI staged photos. |
| `tags`, `nearMrt` | Card tags like 有天然瓦斯 (natural gas), 房間都有窗 (windows in every room), and nearby MRT stations. |
| `guarantees`, `nearby` | *(Details)* Guarantees like 非凶宅 (no death in the home) and the leak warranty, and nearby places (stations, schools). |
| `url` | House page on Yungching. |
| `branchUrl`, `communityUrl`, `agentPhotoUrl` | *(Details)* Branch page, community page and agent photo. |
| `scrapedAt` | When this row was saved. |
| `error` | Only present when a row failed. The fields that loaded are still there. |

Fields marked *Details* only appear when that add-on is on.

#### Example row (trimmed)

```json
{
  "imageUrl": "https://yccdn.yungching.com.tw/v1/image/?key=NF58Ko5oaCsVsZBxCPCmQ7yTm2mK_BEqdDKgtU_HjC2AJ_GZwEBUmr80nU8sRnNOqVhtUUJ4lA_cF1mBh5MY1RWd5eEaa7mn9qxu8f6s-rtKfVoBsurTgAnsNQ3b1ueVa0jD0JJ ...",
  "id": "7590930",
  "title": "看101三房坡車",
  "priceWan": 6488,
  "priceNtd": 64880000,
  "parkingPriceWan": 350,
  "county": "台北市",
  "countyEn": "Taipei City",
  "district": "中山區",
  "zipCode": "104",
  "address": "台北市中山區民權東路三段",
  "community": "僑大花園廣場",
  "propertyType": "住宅大樓",
  "propertyTypeEn": "High-rise residential",
  "age": "42.0年",
  "ageYears": 42,
  "buildingAreaPing": 78.65,
  "buildingAreaM2": 260,
  "mainAreaPing": 50.44,
  "mainAreaM2": 166.74,
  "mainAreaParts": "主+陽",
  "floor": "13",
  "totalFloors": 15,
  "layout": "3房(室)2廳2衛",
  "bedrooms": 3,
  "livingRooms": 2,
  "bathrooms": 2,
  "highlight": "有管理代收服務",
  "agency": "永慶房屋",
  "caseNumber": "YC1293144",
  "unitPriceWanPerPing": 93.16,
  "description": "高樓前後遠景",
  "agentName": "吳政緯",
  "companyName": "永慶房屋(股)公司",
  "branchName": "復興民生直營店",
  "mainBuildingPing": 44.36,
  "sharedAreaPing": 15.44,
  "attachedAreaPing": 6.08,
  "attachedAreaParts": "陽台6.08坪",
  "landAreaPing": 7.15,
  "landAreaM2": 23.64,
  "zoning": "第參種商業區",
  "registeredUse": "住家用",
  "monthlyMortgageNtd": 82087,
  "isExclusive": false,
  "isNew": true,
  "isRented": false,
  "hasParking": true,
  "hasVrTour": false,
  "hasAiStaging": false,
  "tags": ["廁所有窗", "有天然瓦斯", "房間都有窗"],
  "guarantees": ["非短期交易", "非凶宅", "非輻射屋"],
  "nearby": ["五常國小", "中山國中"],
  "url": "https://buy.yungching.com.tw/house/7590930",
  "branchUrl": "https://shop.yungching.com.tw/0233169908_0104",
  "communityUrl": "https://community.yungching.com.tw/building/11308",
  "agentPhotoUrl": "https://pic.yungching.com.tw/res/DrawImage/ShowPic/0/140/HF00/1020307vrd92isvt.jpg?t=20261109",
  "scrapedAt": "2026-11-09T14:28:54.851Z"
}
```

### ⚙️ Input

| Section | What it's for |
| --- | --- |
| **Maximum results** | Always first, caps the whole run. Empty means no limit. |
| **What to scrape** | Counties, districts, keywords, sort and details (agent and more). |
| **Filters** | Property use, building type, quick filter, minimum price (萬 NTD), maximum price (萬 NTD), area type, minimum area (ping), maximum area (ping), minimum rooms, maximum rooms, rooms without added rooms, minimum age (years), maximum age (years), minimum floor, maximum floor, minimum bathrooms, maximum bathrooms, parking, facing, exclude, features and nearby. |
| **Monitoring** | Only new listings and monitor name. |
| **Links** | Links instead of the fields above. Filters are ignored with links. |

**Example: 2+ room elevator flats near the MRT in Taipei and New Taipei, NT$15 to 30 million, biggest price cut first:**

```json
{
  "counties": ["Taipei-city", "NewTaipei-city"],
  "buildingTypes": ["電梯大廈"],
  "minPriceWan": 1500,
  "maxPriceWan": 3000,
  "minRooms": 2,
  "nearby": ["近捷運"],
  "sort": "30",
  "includeDetails": true
}
```

Prices are in 萬 (10,000 NTD), as on the site: 1500 means NT$15 million.

#### More input examples

**Price cuts in Taichung, newest first (schedule it daily):**

```json
{
  "counties": ["Taichung-city"],
  "quickFilter": "pricereduction",
  "onlyNew": true,
  "monitorName": "taichung-price-cuts"
}
```

**Shops and offices with their agents:**

```json
{
  "counties": ["Taipei-city"],
  "propertyUses": ["店面", "辦公"],
  "includeDetails": true
}
```

**Links (filters are ignored):**

```json
{
  "startUrls": [
    { "url": "https://buy.yungching.com.tw/list/台北市-大安區_c/2000-4000_price/?od=11" }
  ]
}
```

### 🔗 Related scrapers

> - [Sinyi Scraper](https://apify.com/normdata/sinyi-scraper): Taiwan homes for sale, with agents and map points.
> - [8891 Scraper](https://apify.com/normdata/auto8891-scraper): Taiwan used cars.
> - [iyp Taiwan Scraper](https://apify.com/normdata/iyp-taiwan-scraper): Taiwan yellow pages and business contacts.
> - [Casas y Terrenos Scraper](https://apify.com/normdata/casasyterrenos-scraper): Mexico real estate and agents.

### ❓ FAQ and troubleshooting

#### Is there a Yungching API? Do I need an API key?

> Yungching has no public data API. This Actor works as a Yungching API alternative: it reads the public pages and gives you clean JSON, CSV or Excel, with no API key, no login and no code to maintain. You can also call it from your own code with the Apify API, or from an AI agent through MCP.

#### Why do I get only 10 listings?

> On the Apify free plan each run saves up to 10 results, so you can try it before paying. Any paid plan removes the limit and gives you all 190,000 listings.

#### Do I get the agent's phone number or the exact address?

> No. Yungching does not show the agent's phone, the house number or a map point on its public pages. With Details you get the agent's name, company and branch, plus the branch page link. Franchise stores (加盟店) list the store and its company, not an agent.

#### Why does the bathrooms filter give fewer homes than I expected?

> Yungching's own filter counts bathrooms without the ones added later (加蓋), and this Actor works the same way. The `bathrooms` and `addedLayout` fields show both numbers, so you can check each home.

#### Is this an official Yungching tool?

> No. It is independent and not affiliated with Yungching. It reads only the homes Yungching publishes for buyers, at a moderate pace. Use agent names in line with Taiwan's Personal Data Protection Act and do not send spam.

### 📧 Contact

Need a scraper for a different site, or found something wrong with this one? norm.data.scrapers@gmail.com

# Actor input Schema

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

Stop after this many listings in total. Leave empty for no limit. The Apify Free plan is always capped at 10.

## `counties` (type: `array`):

Taiwan cities and counties (22).

## `districts` (type: `array`):

Districts by zip code (368; type to search). Their county is searched for you.

## `keywords` (type: `array`):

Words to search, like a community, road or MRT station ("信義", "天母", "古亭站"). Each keyword is its own search.

## `sort` (type: `string`):

Order of results. Default: newest listed first.

## `includeDetails` (type: `boolean`):

Also open each house page for the case number, price per ping, agent, company and branch, description, main, shared and attached area, land area, zoning, registered use, monthly mortgage, guarantees and nearby places. One extra request per listing.

## `propertyUses` (type: `array`):

Home, shop, office, factory, parking, land. Each use is its own search.

## `buildingTypes` (type: `array`):

High-rise, mid-rise, walk-up, house or villa.

## `quickFilter` (type: `string`):

Only price cuts, new builds, newly listed, 新青安 OK or popular homes.

## `minPriceWan` (type: `integer`):

Only homes from this price, in 萬 (10,000 NTD). 1500 = NT$15 million.

## `maxPriceWan` (type: `integer`):

Only homes up to this price, in 萬 (10,000 NTD).

## `areaKind` (type: `string`):

Which area the area range uses. Default: building area (建坪).

## `minAreaPing` (type: `integer`):

Only homes from this size, in ping (1 ping = 3.31 m²).

## `maxAreaPing` (type: `integer`):

Only homes up to this size, in ping.

## `minRooms` (type: `integer`):

Only homes with at least this many rooms.

## `maxRooms` (type: `integer`):

Only homes with at most this many rooms.

## `roomsWithoutAdded` (type: `boolean`):

Count only registered rooms, not rooms added later (加蓋).

## `minAgeYears` (type: `integer`):

Only buildings at least this old.

## `maxAgeYears` (type: `integer`):

Only buildings at most this old.

## `minFloor` (type: `integer`):

Only units from this floor up.

## `maxFloor` (type: `integer`):

Only units up to this floor.

## `minBathrooms` (type: `integer`):

Only homes with at least this many bathrooms, not counting added (加蓋) ones.

## `maxBathrooms` (type: `integer`):

Only homes with at most this many bathrooms, not counting added (加蓋) ones.

## `parking` (type: `string`):

Only homes with or without parking.

## `facing` (type: `array`):

Which way the home faces.

## `exclude` (type: `array`):

Leave out ground floor, 4th floor, top floor or rooftop additions.

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

Windows in every room, natural gas, balconies, corner unit.

## `nearby` (type: `array`):

Low shared area, near MRT, park, market, school or hospital, barrier free.

## `onlyNew` (type: `boolean`):

Skip listings saved by earlier runs with the same monitor name.

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

Runs with the same name share their history. Use a different name for each schedule.

## `startUrls` (type: `array`):

Yungching list pages with any of their filters (https://buy.yungching.com.tw/list/台北市-大安區_c/2000-4000_price/) or house pages (https://buy.yungching.com.tw/house/7590100).

## Actor input object example

```json
{
  "maxItems": 10,
  "counties": [
    "Taipei-city"
  ],
  "sort": "80",
  "includeDetails": true
}
```

# Actor output Schema

## `results` (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 = {
    "maxItems": 10,
    "counties": [
        "Taipei-city"
    ],
    "sort": "80",
    "includeDetails": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("normdata/yungching-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 = {
    "maxItems": 10,
    "counties": ["Taipei-city"],
    "sort": "80",
    "includeDetails": True,
}

# Run the Actor and wait for it to finish
run = client.actor("normdata/yungching-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 '{
  "maxItems": 10,
  "counties": [
    "Taipei-city"
  ],
  "sort": "80",
  "includeDetails": true
}' |
apify call normdata/yungching-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,normdata/yungching-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/9aBydaUpmroXTP9vb/builds/GitDNidy01TzZuu4k/openapi.json
