Beike & Lianjia Property Scraper — China Real Estate Data 🏘️

🎉 The only scraper on Apify for Beike & Lianjia (贝壳找房 / 链家) — China's #1 real-estate platform

City listings, deep listing details, and neighborhood market data (avg price/㎡, on-sale counts, geo) — clean datasets, no account, no API key.

---

📋 Overview

Need structured data from China's largest real-estate platform? Beike & Lianjia Property Scraper pulls resale-housing listings, deep per-property details, and community-level market data into clean datasets — built for China property researchers, real-estate analysts, proptech builders, and cross-border investors.

Why professionals choose us:

• ✅ Only Beike/Lianjia scraper on Apify: Zero competition for China's #1 real-estate platform (贝壳找房 / 链家, KE Holdings).
• ⚡ Three scrapers in one: City listings, deep listing detail, and community market data — pick one per run.
• 🎯 Community comps no one else exposes: Average price/㎡, on-sale listing counts, build year, and geo coordinates per neighborhood.
• 💰 Pay only for successful rows: Transparent per-result pricing, generous free tier, no credit card to test.
• 💎 Real public listing URLs: Every detail row links straight to the live m.ke.com listing page — verifiable and shareable.
• ✨ No account, no API key: Clean camelCase datasets out of the box, export to JSON / CSV / Excel.

---

✨ Features

• 🏘️ Resale Housing List: Scrape any Chinese city's resale-housing listings — total price, price/㎡, community, cover image, and tags (20 rows per page).
• 🏠 Resale Housing Detail: Deep per-listing extraction — floor, area, bedrooms, orientation, year built, decoration, elevator, usage, ownership, and the listing agent.
• 📍 Community List: Neighborhood-level market data — average unit price, on-sale listing count, building type, build year, and latitude/longitude.
• 🌏 12 major cities built in: Beijing, Shanghai, Guangzhou, Shenzhen, Hangzhou, Chengdu, and more — or type any Beike city ID.
• 🔗 Live listing URLs: Each row carries the public m.ke.com link.
• 🧹 Clean structured output: Curated camelCase fields with the raw upstream data spread alongside.
• 📄 Built-in pagination: Set max pages; the scraper walks the result set automatically.
• 📊 HTML run report: Every run saves a summary report with row counts, success rate, and duration.

---

🎬 Quick Start

Pick an operation, choose a city, and run. Start with Resale Housing List to pull a city's listings, then drill into any houseCode with Resale Housing Detail.

curl -X POST "https://api.apify.com/v2/acts/sian.agency~beike-property-scraper/runs?token=YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"operation": "resaleHousingList", "cityId": "110000", "maxPages": 2}'

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose your operation

Pick resaleHousingList, resaleHousingDetail, or communityList.

Step 2: Set the city

Select a city from the dropdown (e.g. Beijing 110000, Shanghai 310000) or type any Beike city ID. For Resale Housing Detail, also paste a houseCode.

Step 3: Run

Hit Start and collect your dataset. Export to JSON, CSV, or Excel.

That's it! In under a minute, you'll have:

• A clean dataset of China resale-housing listings or communities
• Total price, price/㎡, area, and community for every row
• Live public listing URLs you can open or share

---

📥 Input Configuration

Field	Type	Required	Description
operation	string	Yes	resaleHousingList, resaleHousingDetail, or communityList
cityId	string	Yes	City to scrape — pick from the list or type any Beike city ID (e.g. 110000 Beijing)
houseCode	string	For Detail	Listing ID (from any list row's houseCode)
condition	string	No	Advanced raw filter string (region / price band / layout)
maxPages	integer	No	Max pages for paginated operations (20 rows/page). Default 5, range 1–50

Example — list listings:

{
  "operation": "resaleHousingList",
  "cityId": "310000",
  "maxPages": 3
}

Example — deep listing detail:

{
  "operation": "resaleHousingDetail",
  "cityId": "110000",
  "houseCode": "101137699747"
}

Example — community market data:

{
  "operation": "communityList",
  "cityId": "110000",
  "maxPages": 5
}

---

📤 Output

Results are saved to the Apify dataset with 40+ fields including:

Field	Type	Description
houseCode	string	Beike listing ID
listingTitle	string	Listing title
communityName	string	Community / neighborhood name
price	number	Total price (CNY)
unitPrice	number	Price per ㎡ (CNY)
area	number	Floor area (㎡)
bedroomNum	number	Bedrooms
orientation	string	Orientation (e.g. 西南)
yearBuilt	string	Year built
decoration	string	Decoration level
ownership	string	Ownership type
agentName	string	Listing agent
avgUnitPrice	number	Community average price/㎡ (Community List)
onSaleCount	number	Listings on sale in community
lat / lng	number	Community geo coordinates
listingUrl	string	Public m.ke.com listing URL

Example row (Resale Housing Detail):

{
  "_operation": "resaleHousingDetail",
  "houseCode": "101137699747",
  "listingTitle": "凯旋城 3室1厅 西南",
  "communityName": "凯旋城",
  "price": 11200000,
  "unitPrice": 77498,
  "area": 144.52,
  "bedroomNum": 3,
  "hallNum": 1,
  "orientation": "西南",
  "floorState": "中楼层/23层",
  "yearBuilt": "2004年建成",
  "decoration": "精装",
  "elevator": "有",
  "ownership": "商品房",
  "agentName": "申怀倩",
  "listingUrl": "https://m.ke.com/bj/ershoufang/101137699747.html",
  "currency": "CNY",
  "status": "success"
}

---

💼 Use Cases & Examples

1. China Property Market Research

For analysts mapping China's housing markets.

Input: Resale Housing List + Community List for a target city. Output: Listing prices, price/㎡, and neighborhood averages. Use: Build city-level and neighborhood-level price maps across China's largest metros.

2. Resale-Housing Price Tracking

For data teams monitoring price movement.

Input: Schedule a daily Resale Housing List run per city. Output: Daily snapshots of total and per-㎡ prices. Use: Track trends and valuations on China's #1 real-estate platform over time.

3. Neighborhood / Community Comps

For valuation and proptech builders.

Input: Community List for a city. Output: Average unit price, on-sale counts, build year, and geo coordinates per community. Use: A ready-made comps dataset for automated valuation models and mapping.

4. Real-Estate Lead Generation

For brokerage, mortgage, and relocation teams.

Input: Resale Housing Detail across target listings. Output: Listing agents and full property context. Use: Build prospect and outreach lists tied to live inventory.

5. Cross-Border Investment Analysis

For investors comparing global markets.

Input: China listings alongside Western property data. Output: Price/㎡, inventory depth, and yield inputs in one pipeline. Use: Compare China resale housing against US, UK, and MENA markets side by side.

---

🔗 Integration Examples

JavaScript/Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/beike-property-scraper').call({
  operation: 'resaleHousingList',
  cityId: '110000',
  maxPages: 2
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/beike-property-scraper').call(
    run_input={'operation': 'communityList', 'cityId': '110000', 'maxPages': 3}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~beike-property-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"operation": "resaleHousingDetail", "cityId": "110000", "houseCode": "101137699747"}'

Automation Workflows (N8N / Zapier / Make)

1. Trigger: Schedule or webhook
2. HTTP Request: Call the actor API
3. Process: Handle the JSON dataset
4. Action: Save to a sheet, database, or BI tool

---

📊 Performance & Pricing

FREE Tier (Try It Now)

• Full feature access, same data quality
• No credit card required
• Perfect for testing and small projects

PAID Tier (Production Ready)

• Unlimited rows per run
• Pay-per-result: only charged for successful rows
• Deep pagination for large markets

💰 Transparent per-result pricing — list and community rows are priced for bulk research; deep detail is priced per property.

🔗 View current pricing

---

❓ Frequently Asked Questions

Q: Which cities are supported? A: 12 major cities are built into the dropdown (Beijing, Shanghai, Guangzhou, Shenzhen, Hangzhou, Chengdu, Nanjing, Wuhan, Xi'an, Tianjin, Chongqing, Shenyang). You can also type any Beike city ID to scrape other cities.

Q: How do I get a houseCode for the Detail operation? A: Run Resale Housing List first — every row has a houseCode field. Paste it into the Detail operation.

Q: How many rows can I get per run? A: Each paginated operation returns 20 rows per page; set maxPages up to 50. Detail returns one property per run.

Q: What output formats are available? A: JSON, CSV, and Excel — export directly from the Apify dataset.

Q: Is the data public? A: Yes — this actor only collects publicly listed real-estate data. See the legal section below.

Q: What currency are prices in? A: Chinese yuan (CNY). Total price and price/㎡ are exposed both as numbers and display strings.

---

🐛 Troubleshooting

No rows returned

• Verify the cityId is a valid Beike city ID (try a built-in one like 110000).
• For Detail, confirm the houseCode came from a recent list run (listings can be delisted).

Empty Detail result

• The listing may have been removed. Pull a fresh houseCode from Resale Housing List and retry.

Fewer pages than expected

• The market may have fewer results than maxPages × 20. The scraper stops when the data source signals no more results.

Run looks slow

• China data sources can be rate-limited; the scraper retries transient errors automatically with backoff.

---

⚠️ Trademark Disclaimer

This is an independent scraping tool. It is not affiliated with, endorsed by, or sponsored by Beike (贝壳找房), Lianjia (链家), KE Holdings Inc., or any of their subsidiaries. The Beike®, Lianjia®, and 贝壳找房® names appear under nominative fair use to describe the public data this tool collects. All trademarks belong to their respective owners.

---

⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the legality of web scraping.

---

🤝 Support

Join our active support community

• For issues or questions, open an issue in the actor's Issues tab
• Check SIÁN Agency Store for more automation tools
• 📧 apify@sian-agency.online

---

Built by SIÁN Agency | More Tools