# Anjuke 新房 Scraper — 64 Fields + Sales Office Phones (`zen-studio/anjuke-new-home-scraper`) Actor

Extract Chinese new-home (新房) developer data from Anjuke with permanent 400-hotline sales-office phones. 64 fields per development — pricing, floorplans, price trends, metro, tags. Dual-mode: city + filters or paste loupan URLs. 25 top cities. Free tier: 5 developments, 5 runs lifetime.

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

## Pricing

from $429.00 / 1,000 developments

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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

## Anjuke New-Home Scraper | Chinese 新房 Developer Data + Sales Hotline Phones (2026)

![Anjuke New-Home Scraper](https://iili.io/BgwxDpj.png)

Scrape Chinese new-build developments (新房) from Anjuke. Every row carries a **permanent 400-hotline phone** to the developer's sales office, plus 63 more fields: pricing, floorplans, price trends, metro, tags. The only Anjuke scraper on Apify with a dialable lead-gen phone number per row.

<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 Anjuke Collection</span>
<span style="color:#E8F5E9;font-size:13px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;Complete Chinese real-estate coverage: new homes, sale listings, rentals</span>
</td>
</tr>
<tr>
<td style="padding:12px 16px;border:1px solid #E7E5E4;border-radius:0 0 0 4px;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-1tAzNSf8Kz0v7Q2Lr-AINJ7FsZVU-anjuke-scraper-logo.jpg" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/anjuke-new-home-scraper" style="color:#4C945E;text-decoration:none;font-weight:700;font-size:14px">New Homes (新房)</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;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-1tAzNSf8Kz0v7Q2Lr-AINJ7FsZVU-anjuke-scraper-logo.jpg" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/anjuke-real-estate-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">Sale Listings (二手房)</a><br>
<span style="color:#78716C;font-size:12px">Resale homes by city + filter</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;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-8wZBMOCwlciP2yL7T-bRBN21aEs1-anjuke-scraper-logo.jpg" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/anjuke-sale-detail-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">Sale Detail (URL)</a><br>
<span style="color:#78716C;font-size:12px">Enrich listings from URL list</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;border-radius:0 0 4px 0;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-lfc30NRxNSkmQX50Q-uMySapcNCz-anjuke-scraper-logo.jpg" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/anjuke-rent-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">Rent Listings (租房)</a><br>
<span style="color:#78716C;font-size:12px">Rental market, metro, source filters</span>
</td>
</tr>
</table>

#### Copy to your AI assistant

````

zen-studio/anjuke-new-home-scraper on Apify. Scrapes Chinese new-home developments with dialable 400-hotline sales phones. Call ApifyClient("TOKEN").actor("zen-studio/anjuke-new-home-scraper").call(run\_input={...}), then client.dataset(run\["defaultDatasetId"]).list\_items().items. Provide either city (pinyin, e.g. "beijing") OR startUrls, not both. Full spec: GET https://api.apify.com/v2/acts/zen-studio~anjuke-new-home-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Token: https://console.apify.com/account/integrations

````

### Key Features

- **64 fields per development** including permanent 400-hotline phone (`phoneDial`, `phone400Main`, `phone400Ext`), loupan name, address, pricing, 12-month price trend, house-type floorplans, developer, metro proximity, and on-platform review counts
- **Dial-ready phones** — the phone goes straight to the developer's sales office and does not rotate. Lead-gen ready for CRM imports, cold outreach, or call-list building
- **Dual input modes** — search by city with optional filters (region, price range, rooms, property type, sale status, sort) OR paste loupan URLs directly
- **Top 25 Chinese cities** — Beijing, Shanghai, Guangzhou, Shenzhen, Chengdu, Nanjing, Tianjin, Hangzhou, Suzhou, Chongqing, Dalian, Wuhan, Shenyang, Xian, Qingdao, Jinan, Foshan, Changsha, Ningbo, Zhengzhou, Hefei, Xiamen, Kunming, Dongguan, Wuxi
- **Free tier** — 5 developments and 5 runs lifetime, no credit card required

### How to Scrape Chinese New-Home Developments

#### Basic — 10 Beijing developments (free-tier-friendly)

```json
{
    "city": "beijing",
    "maxResults": 10
}
````

#### Filter by district and per-m² price

```json
{
    "city": "beijing",
    "region": "daxing",
    "pricePerM2Min": 30000,
    "pricePerM2Max": 60000,
    "rooms": ["2", "3"],
    "saleStatus": ["onsale"],
    "maxResults": 50
}
```

#### By total-price range (万元) + sort by price

```json
{
    "city": "shanghai",
    "totalPriceMin": 500,
    "totalPriceMax": 1000,
    "propertyType": "residential",
    "sort": "price_asc",
    "maxResults": 100
}
```

#### URL mode — specific developments

```json
{
    "startUrls": [
        "https://bj.fang.anjuke.com/loupan/523824.html",
        "https://sh.fang.anjuke.com/loupan/524704.html",
        "https://gz.fang.anjuke.com/loupan/470031.html"
    ]
}
```

### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `city` | string (select) | `beijing` | City pinyin. Pick one from the 25-city dropdown. Required unless `startUrls` is used. |
| `region` | string | *empty* | District filter, in pinyin (e.g. `chaoyang`, `haidian`, `daxing`, `pudong`, `tianhe`). |
| `pricePerM2Min` | integer | *empty* | Minimum per-m² price in CNY (元/m²). Mutually exclusive with `totalPrice*`. |
| `pricePerM2Max` | integer | *empty* | Maximum per-m² price in CNY. |
| `totalPriceMin` | integer | *empty* | Minimum total price in 万元 (10,000 CNY). Mutually exclusive with `pricePerM2*`. |
| `totalPriceMax` | integer | *empty* | Maximum total price in 万元. |
| `rooms` | array | *empty* | Room counts to match: `["1"]`, `["2","3"]`, `["4"]`, `["5"]`. |
| `propertyType` | string (select) | *empty* | `residential`, `villa`, `commercial`, `office`, `shop`. |
| `saleStatus` | array (select) | *empty* | `onsale` (在售), `upcoming` (待售), `soldout` (售罄). |
| `sort` | string (select) | `default` | `default`, `price_asc`, `price_desc`, `newest`. |
| `maxResults` | integer | `100` | Max developments to scrape. Hard-capped at 5,000. |
| `startUrls` | array | *empty* | Loupan URLs. Use instead of `city`. Format: `https://{short}.fang.anjuke.com/loupan/{id}.html`. |
| `proxyConfiguration` | object | Residential CN | Apify residential proxy (CN country). Recommended defaults. |

**Dual-mode rule:** provide either `city` or `startUrls`, never both. The actor fails fast with a clear message if both are set or neither is set.

### What Data Can You Extract from Anjuke New-Home Listings?

Every row includes:

- **Identity & URL** — `loupanName`, `loupanAlias`, `loupanId`, `url`, `fangType`
- **Location** — `cityName`, `regionTitle`, `subRegionTitle`, `address`, `lat`, `lng`, `baiduLat`, `baiduLng`
- **Classification** — `propertyType`, `propertyTypeCn`, `commercialType`, `saleStatus`, `saleStatusCn`
- **Timing** — `kaipanDate` (opening), `kaipanDateCn`, `jiaofangDate` (delivery), `jiaofangDateCn`, `presalePermit`
- **Pricing** — `pricePerM2`, `pricePerM2Unit`, `newPriceTitle`, `priceTrend` (12-month history)
- **Size** — `areaRange`, `jianzhuArea` (total built m²), `zhandiArea` (land m²), `houseTypeCount`, `houseTypes[]` (floorplan summaries with alias, area, orientation, image)
- **Amenities** — `chanquan` (tenure text), `tenureYears`, `parkingRatio`, `greenRatio`, `plotRatio`, `propertyFee`, `fitmentType`, `loopLine`
- **Developer** — `developer[]`, `propertyCompany`, `investor`, `proxyAddress`
- **Media** — `defaultImage`, `images[]` (up to 10), `imageTotal`
- **Transit & marketing** — `metroLines[]` (walking distance to nearest stations), `youdian` (highlights), `gaishu` (summary), `groupBuy` (active promo with join count + deadline), `tags[]`, `reviewCount`
- **Phone** — `phoneDial` (e.g. `400-091-9320 转 880175`), `phone400Main`, `phone400Ext`, `phone400Dynamic`, `phone400Status`
- **Meta** — `rowStatus` (`ok` / `invalid` / `unavailable` / `phone_unavailable` / `error`), `scrapedAt`

#### Output Example

```json
{
    "rowStatus": "ok",
    "loupanId": "523824",
    "loupanName": "壹品兴创·颐和公馆",
    "loupanAlias": "",
    "url": "https://bj.fang.anjuke.com/loupan/523824.html",
    "fangType": "xinfang",

    "cityId": "14",
    "cityName": "北京",
    "regionId": "865",
    "regionTitle": "大兴区",
    "subRegionId": "867",
    "subRegionTitle": "黄村",
    "address": "义忠路和义和庄南街交界处",
    "lat": "39.710506192644",
    "lng": "116.32479259169",
    "baiduLat": "39.716258",
    "baiduLng": "116.331367",

    "propertyType": "residential",
    "propertyTypeCn": "住宅",
    "commercialType": "",
    "saleStatus": "onsale",
    "saleStatusCn": "在售",

    "kaipanDate": "2024-03-15T16:00:00Z",
    "kaipanDateCn": "2024年03月16日",
    "jiaofangDate": "",
    "jiaofangDateCn": "",
    "presalePermit": "京房售证字(2024)18号;京房售证字(2024)17号",

    "pricePerM2": 47500,
    "pricePerM2Unit": "CNY/m²",
    "newPriceTitle": "住宅",
    "priceTrend": [
        { "month": "05月", "midPrice": 52000 },
        { "month": "06月", "midPrice": 51500 },
        "... 10 more"
    ],

    "areaRange": "127-224㎡",
    "jianzhuArea": "142178㎡",
    "zhandiArea": "45954.22",
    "houseTypeCount": 6,
    "houseTypes": [
        {
            "id": "847389",
            "name": "C1和御户型",
            "alias": "4室2厅2卫1厨",
            "area": "127.00",
            "orient": "南",
            "flagTitle": "在售",
            "defaultImage": "https://pic4.ajkimg.com/display/xinfang/..."
        },
        "... 5 more"
    ],

    "chanquan": "70年（住宅）",
    "tenureYears": 70,
    "parkingRatio": "1:1.2",
    "greenRatio": 30.0,
    "plotRatio": "住宅2",
    "propertyFee": "暂无",
    "fitmentType": "带装修",
    "loopLine": "五至六环",

    "developer": [],
    "propertyCompany": "中建壹品物业运营有限公司",
    "investor": "",
    "proxyAddress": "北京市大兴区新源大街兴创总部公园B5栋",

    "metroInfo": "",
    "metroLines": ["4大兴线号线义和庄－步行650m"],

    "defaultImage": "https://pic6.ajkimg.com/mat/...",
    "images": [
        "https://pic4.ajkimg.com/display/xinfang/68c2df1ed7c5387ef74bda43e221b742/600x450n.jpg",
        "https://pic4.ajkimg.com/display/xinfang/c42cd7355bf468da1e8f17594ef74ac3/600x450n.jpg",
        "... 8 more"
    ],
    "imageTotal": 46,

    "youdian": "由中建壹品与兴创两大国企联合开发；地铁4号线义和庄站约300米；紧邻念坛公园，尽享2500亩生态环境；商圈环绕：大兴龙湖天街、凯德Mall、西红门荟聚。",
    "gaishu": "项目由中建壹品与北京兴创联合开发，位于大兴新城核心区地段，受南城计划、机场临空经济区和雄安新区三重利好加持；...",
    "tags": ["车位充足", "装修交付", "轨交房", "厨卫全明", "南北通透"],
    "reviewCount": 1162,
    "groupBuy": {
        "id": "383227",
        "title": "总价530万起",
        "joinCount": 1096,
        "deadline": "2026-04-19 23:59:59",
        "description": "总价530万起"
    },

    "phoneDial": "400-091-9320 转 880175",
    "phone400Main": "400 091 9320",
    "phone400Ext": "880175",
    "phone400Dynamic": false,
    "phone400Status": 1,

    "scrapedAt": "2026-04-19T09:05:14Z"
}
```

### Advanced Usage

#### High-volume city sweep (500 developments in one run)

```json
{
    "city": "shanghai",
    "saleStatus": ["onsale"],
    "maxResults": 500
}
```

#### Premium residential in a specific district

```json
{
    "city": "beijing",
    "region": "haidian",
    "propertyType": "residential",
    "pricePerM2Min": 80000,
    "sort": "price_desc",
    "maxResults": 50
}
```

#### Opening-soon pipeline (for lead-gen on upcoming launches)

```json
{
    "city": "chengdu",
    "saleStatus": ["upcoming"],
    "sort": "newest",
    "maxResults": 100
}
```

#### Commercial real estate only

```json
{
    "city": "shenzhen",
    "propertyType": "commercial",
    "saleStatus": ["onsale", "upcoming"],
    "maxResults": 100
}
```

#### Bulk enrich from a known URL list

```json
{
    "startUrls": [
        "https://bj.fang.anjuke.com/loupan/523824.html",
        "https://sh.fang.anjuke.com/loupan/524704.html",
        "https://gz.fang.anjuke.com/loupan/470031.html",
        "https://sz.fang.anjuke.com/loupan/481219.html",
        "https://cd.fang.anjuke.com/loupan/412387.html"
    ]
}
```

### Pricing

**From $0.429 per development** — pay-per-event on the `loupan-scraped` event. Only successful rows with a dialable phone number are billed. Invalid URLs, dead listings, and rows without a phone number never charge. Your Apify subscription tier applies a volume discount automatically.

| Plan | Per development |
|---|---|
| Free | $0.499 |
| Starter | $0.479 |
| Scale | $0.449 |
| Business | $0.429 |

A one-time **Actor start** fee of **$0.05** per run applies on top (covers warmup). You'll see it as a separate line in the run cost.

**Free tier:** 5 developments and 5 runs lifetime per Apify account, no credit card required. After the cap, the run ends with a single upgrade notice (not charged).

#### Cut cost

- Narrow with `region` + `pricePerM2Min`/`pricePerM2Max` or `totalPriceMin`/`totalPriceMax` before the run starts — a Beijing/Haidian filter returns ~30 developments, a Beijing-wide sweep ~700
- Set `maxResults` to exactly the volume you need — the scraper stops as soon as it hits the cap
- For incremental lead-gen, run smaller sweeps weekly rather than one giant monthly run
- Upgrade to a Business subscription to drop per-development cost by ~14% on high-volume work

### FAQ

**What makes this different from sale-listing scrapers?**
The phone is permanent and dialable. Sale and rent actors expose broker phones through short-lived relay numbers that rotate within minutes, so dialing them the next day reaches dead lines. New-home developments publish a permanent 400-hotline routed to the developer's sales office — that's what we return.

**How fresh is the data?**
Every run hits Anjuke live. Price trend, group-buy deadlines, and sale status reflect what was on Anjuke at run time. There is no cache layer.

**Can I scrape more than 5,000 developments in one run?**
One run is hard-capped at 5,000. For larger catalogs, split across multiple runs (e.g. by `region` or `propertyType`).

**Which cities are supported?**
Top 25 Chinese cities covering tier-1 and tier-2 markets. For coverage of smaller cities, open an issue with the city name and we'll add it.

**What's the free tier?**
5 developments and 5 runs lifetime. No credit card. After that you choose a paid plan.

**Do I need a Chinese proxy?**
The actor defaults to Apify Residential CN and is tuned for that. You can change the proxy group under `proxyConfiguration`, but results may vary.

**What does `rowStatus` mean?**
`ok` = full row with phone, charged. `invalid` = URL didn't match the accepted shape. `unavailable` = listing no longer exists. `phone_unavailable` = listing exists but no phone (rare). `error` = transient failure while loading the development. Only `ok` rows are charged.

**Can I use the scraper for leads in compliance with Chinese regulations?**
The 400-hotline is the developer's published public sales number — legally equivalent to finding it on their website or a printed brochure. You must still comply with local telemarketing and data protection rules (PIPL, GDPR, CCPA) for any outreach.

**Can I combine filters?**
Yes. All filters stack. The only mutual exclusion is between the per-m² price (`pricePerM2Min`/`pricePerM2Max`) and total price (`totalPriceMin`/`totalPriceMax`) — pick one pair.

**Does the actor scrape new-home reviews and comments?**
Not currently included. `reviewCount` is returned as a popularity signal. If review content is a need, open an issue.

**What happens if a city has no developments matching my filters?**
The actor fails fast with a generic message and doesn't charge.

### Support

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

### Legal Compliance

Extracts publicly available data from Anjuke. Users must comply with Anjuke's terms of service, Chinese data-protection law (PIPL), and applicable regulations in their jurisdiction (GDPR, CCPA). The 400-hotline phone numbers are published sales contacts and may be used only for legitimate business outreach.

***

*Chinese new-home developer data with permanent sales-office phone numbers. 64 fields per development, 25 top cities, dial-ready leads.*

# Actor input Schema

## `city` (type: `string`):

City to search (城市).<br><br>Start typing to filter — each entry shows the Chinese name and pinyin. Leave empty only if you're using the <b>Loupan URLs</b> field further down.

## `region` (type: `string`):

Optional district filter, in pinyin. Common examples:<br>• <code>chaoyang</code> (朝阳) · <code>haidian</code> (海淀) · <code>daxing</code> (大兴) · <code>fengtai</code> (丰台) — Beijing<br>• <code>pudong</code> (浦东) · <code>minhang</code> (闵行) · <code>xuhui</code> (徐汇) — Shanghai<br><br>Leave empty to include all districts in the selected city.

## `pricePerM2Min` (type: `integer`):

Optional minimum per-m² price in CNY (元/m²), e.g. <code>30000</code>. Leave empty for no minimum.<br><br>⚠️ <b>Mutually exclusive with Total price</b> — use per-m² or total, not both.

## `pricePerM2Max` (type: `integer`):

Optional maximum per-m² price in CNY (元/m²), e.g. <code>60000</code>. Leave empty for no maximum.

## `totalPriceMin` (type: `integer`):

Optional minimum total price in <b>万元</b> (10,000 CNY), e.g. <code>500</code> = ¥5,000,000 total.<br><br>⚠️ <b>Mutually exclusive with Price per m²</b>.

## `totalPriceMax` (type: `integer`):

Optional maximum total price in <b>万元</b> (10,000 CNY), e.g. <code>1000</code> = ¥10,000,000 total.

## `rooms` (type: `array`):

Optional list of room counts to match. Select one or more. Leave empty to include all sizes.

## `propertyType` (type: `string`):

Optional property-type filter. Defaults to all types if omitted.

## `saleStatus` (type: `array`):

Optional list of statuses to include. Select one or more. Leave empty to include all.

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

Sort order for search results. <code>Default</code> uses Anjuke's own ranking (usually best for discovery).

## `maxResults` (type: `integer`):

Maximum number of developments to scrape in this run. Hard-capped at 5,000.<br><br>💡 <b>Free tier:</b> lifetime 5 rows + 5 runs per user. Upgrade to Apify paid plans for unlimited scraping.

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

Optional — only fill this if you're <b>skipping the City search</b> and want to pull specific developments by URL.<br><br><b>Accepted shape:</b> <code>https://{short}.fang.anjuke.com/loupan/{id}.html</code><br>e.g. <code>https://bj.fang.anjuke.com/loupan/523824.html</code> (Beijing), <code>https://sh.fang.anjuke.com/loupan/524704.html</code> (Shanghai).<br><br>Up to <b>1,000 URLs per run</b>. Duplicates are deduplicated. Invalid URLs produce stub rows with <code>rowStatus: "invalid"</code> and are not charged.

## `proxyConfiguration` (type: `object`):

Chinese residential proxies are recommended. Leave the defaults to use Apify Residential CN — that's what this actor is tuned for.

## Actor input object example

```json
{
  "city": "beijing",
  "sort": "default",
  "maxResults": 100,
  "startUrls": [],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "CN"
  }
}
```

# Actor output Schema

## `loupans` (type: `string`):

Link to the dataset containing all scraped new-home developments.

# 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 = {
    "city": "beijing",
    "maxResults": 100,
    "startUrls": [],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "CN"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/anjuke-new-home-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 = {
    "city": "beijing",
    "maxResults": 100,
    "startUrls": [],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "CN",
    },
}

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

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

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

```

## CLI example

```bash
echo '{
  "city": "beijing",
  "maxResults": 100,
  "startUrls": [],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "CN"
  }
}' |
apify call zen-studio/anjuke-new-home-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=zen-studio/anjuke-new-home-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Anjuke 新房 Scraper — 64 Fields + Sales Office Phones",
        "description": "Extract Chinese new-home (新房) developer data from Anjuke with permanent 400-hotline sales-office phones. 64 fields per development — pricing, floorplans, price trends, metro, tags. Dual-mode: city + filters or paste loupan URLs. 25 top cities. Free tier: 5 developments, 5 runs lifetime.",
        "version": "0.0",
        "x-build-id": "x1x9GcCeEdJSaKOib"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/zen-studio~anjuke-new-home-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-zen-studio-anjuke-new-home-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/zen-studio~anjuke-new-home-scraper/runs": {
            "post": {
                "operationId": "runs-sync-zen-studio-anjuke-new-home-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/zen-studio~anjuke-new-home-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-zen-studio-anjuke-new-home-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "city": {
                        "title": "City",
                        "enum": [
                            "beijing",
                            "shanghai",
                            "guangzhou",
                            "shenzhen",
                            "chengdu",
                            "nanjing",
                            "tianjin",
                            "hangzhou",
                            "suzhou",
                            "chongqing",
                            "dalian",
                            "wuhan",
                            "shenyang",
                            "xian",
                            "qingdao",
                            "jinan",
                            "foshan",
                            "changsha",
                            "ningbo",
                            "zhengzhou",
                            "hefei",
                            "xiamen",
                            "kunming",
                            "dongguan",
                            "wuxi"
                        ],
                        "type": "string",
                        "description": "City to search (城市).<br><br>Start typing to filter — each entry shows the Chinese name and pinyin. Leave empty only if you're using the <b>Loupan URLs</b> field further down."
                    },
                    "region": {
                        "title": "Region / 区域",
                        "type": "string",
                        "description": "Optional district filter, in pinyin. Common examples:<br>• <code>chaoyang</code> (朝阳) · <code>haidian</code> (海淀) · <code>daxing</code> (大兴) · <code>fengtai</code> (丰台) — Beijing<br>• <code>pudong</code> (浦东) · <code>minhang</code> (闵行) · <code>xuhui</code> (徐汇) — Shanghai<br><br>Leave empty to include all districts in the selected city."
                    },
                    "pricePerM2Min": {
                        "title": "Price per m² — min / 单价下限 (元/m²)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Optional minimum per-m² price in CNY (元/m²), e.g. <code>30000</code>. Leave empty for no minimum.<br><br>⚠️ <b>Mutually exclusive with Total price</b> — use per-m² or total, not both."
                    },
                    "pricePerM2Max": {
                        "title": "Price per m² — max / 单价上限 (元/m²)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Optional maximum per-m² price in CNY (元/m²), e.g. <code>60000</code>. Leave empty for no maximum."
                    },
                    "totalPriceMin": {
                        "title": "Total price — min / 总价下限 (万元)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Optional minimum total price in <b>万元</b> (10,000 CNY), e.g. <code>500</code> = ¥5,000,000 total.<br><br>⚠️ <b>Mutually exclusive with Price per m²</b>."
                    },
                    "totalPriceMax": {
                        "title": "Total price — max / 总价上限 (万元)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Optional maximum total price in <b>万元</b> (10,000 CNY), e.g. <code>1000</code> = ¥10,000,000 total."
                    },
                    "rooms": {
                        "title": "Rooms / 户型",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Optional list of room counts to match. Select one or more. Leave empty to include all sizes.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "1",
                                "2",
                                "3",
                                "4",
                                "5"
                            ],
                            "enumTitles": [
                                "1 bedroom (一室)",
                                "2 bedrooms (两室)",
                                "3 bedrooms (三室)",
                                "4 bedrooms (四室)",
                                "5+ bedrooms (五室+)"
                            ]
                        }
                    },
                    "propertyType": {
                        "title": "Property type / 物业类型",
                        "enum": [
                            "residential",
                            "villa",
                            "commercial",
                            "office",
                            "shop"
                        ],
                        "type": "string",
                        "description": "Optional property-type filter. Defaults to all types if omitted."
                    },
                    "saleStatus": {
                        "title": "Sale status / 销售状态",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Optional list of statuses to include. Select one or more. Leave empty to include all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "onsale",
                                "upcoming",
                                "soldout"
                            ],
                            "enumTitles": [
                                "🟢 On sale (在售)",
                                "🟡 Upcoming (待售)",
                                "🔴 Sold out (售罄)"
                            ]
                        }
                    },
                    "sort": {
                        "title": "Sort / 排序",
                        "enum": [
                            "default",
                            "price_asc",
                            "price_desc",
                            "newest"
                        ],
                        "type": "string",
                        "description": "Sort order for search results. <code>Default</code> uses Anjuke's own ranking (usually best for discovery).",
                        "default": "default"
                    },
                    "maxResults": {
                        "title": "Max results",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Maximum number of developments to scrape in this run. Hard-capped at 5,000.<br><br>💡 <b>Free tier:</b> lifetime 5 rows + 5 runs per user. Upgrade to Apify paid plans for unlimited scraping.",
                        "default": 100
                    },
                    "startUrls": {
                        "title": "Loupan URLs / 楼盘链接",
                        "type": "array",
                        "description": "Optional — only fill this if you're <b>skipping the City search</b> and want to pull specific developments by URL.<br><br><b>Accepted shape:</b> <code>https://{short}.fang.anjuke.com/loupan/{id}.html</code><br>e.g. <code>https://bj.fang.anjuke.com/loupan/523824.html</code> (Beijing), <code>https://sh.fang.anjuke.com/loupan/524704.html</code> (Shanghai).<br><br>Up to <b>1,000 URLs per run</b>. Duplicates are deduplicated. Invalid URLs produce stub rows with <code>rowStatus: \"invalid\"</code> and are not charged.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "proxyConfiguration": {
                        "title": "Proxy",
                        "type": "object",
                        "description": "Chinese residential proxies are recommended. Leave the defaults to use Apify Residential CN — that's what this actor is tuned for."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
