# 58.com Real Estate Scraper: China Sale, Rental & Landlord Data (`getascraper/58-classifieds-scraper`) Actor

Scrape 58.com, China's largest classifieds site, for property listings across 13 major cities: Beijing, Shanghai, Shenzhen, and more. Extract for-sale and rental prices, layouts, and compound details to Excel or JSON. Filter for direct landlord leads and skip broker intermediaries.

- **URL**: https://apify.com/getascraper/58-classifieds-scraper.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** Real estate, Lead generation
- **Features:** Limited permissions
- **Stats:** 9 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

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

## 🏠 58.com Real Estate Scraper: China Sale, Rental & Landlord Data

<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0;table-layout:fixed;margin-bottom:0">
<tr>
<td colspan="2" style="padding:14px 18px;background:#FBEAEA;border:none;border-top:3px solid #A61C1C;border-left:1px solid #F0C4C4;border-right:1px solid #F0C4C4;color:#1C1917;border-radius:10px 10px 0 0">
<span style="font-size:16px;font-weight:700;color:#1C1917">Two independent reads on China's property market.</span> <span style="font-size:15px;color:#57534E">58.com Scraper and Lianjia Scraper each track a different Chinese property portal, so you can cross-check coverage and pricing instead of relying on one source.</span>
</td>
</tr>
<tr>
<td colspan="2" style="padding:10px 14px;background:#A61C1C;border:none;border-left:1px solid #F0C4C4;border-right:1px solid #F0C4C4;color:#FFFFFF">
<span style="color:#FFFFFF;font-size:14px;font-weight:700;letter-spacing:0.5px">CHINA REAL ESTATE PORTALS</span>
<span style="color:#FFFFFF;font-size:13px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;Two independent Chinese property portals, cross-checked side by side.</span>
</td>
</tr>
<tr>
<td style="padding:10px 12px;border:none;border-left:1px solid #F0C4C4;border-bottom:1px solid #F0C4C4;vertical-align:top;width:50.0%;background:#FBEAEA;color:#1C1917">
<span style="overflow-wrap:break-word;word-break:break-word"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/jNDbFabbVxMhnQNb4-actor-dpxoaa5Q9WkJKmZ1g-4Q7otkGLPT-CompressJPEG.Online_img%28512x512%29_%2812%29.jpg" width="20" height="20" style="vertical-align:middle;border-radius:4px">&nbsp;<a href="https://apify.com/getascraper/58-classifieds-scraper" style="color:#A61C1C;text-decoration:none;font-weight:700;font-size:13px">58.com</a></span><br>
<span style="color:#A61C1C;font-size:11px;font-weight:700">&#10148; You are here</span>
</td>
<td style="padding:10px 12px;border:none;border-left:1px solid #F0C4C4;border-right:1px solid #F0C4C4;border-bottom:1px solid #F0C4C4;vertical-align:top;width:50.0%;background:#FFFFFF;color:#1C1917">
<span style="overflow-wrap:break-word;word-break:break-word"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/jNDbFabbVxMhnQNb4-actor-KfHwz3bRVVnA49ctD-hzssPZHPaq-CompressJPEG.Online_img%28512x512%29_%2814%29.jpg" width="20" height="20" style="vertical-align:middle;border-radius:4px">&nbsp;<a href="https://apify.com/getascraper/lianjia-real-estate-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Lianjia</a></span><br>
<span style="color:#57534E;font-size:11px">Resale listings across 12 Chinese cities with price-change tracking.</span>
</td>
</tr>
</table>
<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0;margin-top:0;margin-bottom:0">
<tr>
<td style="padding:24px 28px;background:#FBEAEA;border:1px solid #F0C4C4;border-top:none;color:#1C1917">
<span style="font-size:23px;font-weight:800;color:#1C1917;line-height:1.3">58.com property listings, structured for your spreadsheet.</span><br>
<span style="font-size:15px;color:#57534E;line-height:1.6">58.com is China's largest classifieds site. This Actor pulls for-sale and rental real estate listings from 13 major Chinese cities and returns clean, structured data instead of raw HTML, ready in seconds.</span>
</td>
</tr>
</table>
<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0;margin-top:0">
<tr>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #F0C4C4;vertical-align:top;border-top:none;color:#1C1917;border-radius:0 0 0 10px">
<span style="font-size:15px;font-weight:800;color:#7F1616">🏠 Sale and rental in one Actor</span><br>
<span style="font-size:12px;color:#57534E">Covers both for-sale (二手房) and rental (租房) categories without running two tools.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #F0C4C4;border-left:none;vertical-align:top;border-top:none;color:#1C1917">
<span style="font-size:15px;font-weight:800;color:#7F1616">🏙️ 13 major Chinese cities</span><br>
<span style="font-size:12px;color:#57534E">Beijing, Shanghai, Shenzhen, Guangzhou, and 9 more city subdomains, selectable by name.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #F0C4C4;border-left:none;vertical-align:top;border-top:none;color:#1C1917">
<span style="font-size:15px;font-weight:800;color:#7F1616">👤 Direct landlord filter</span><br>
<span style="font-size:12px;color:#57534E">Optionally keep only private-owner listings and skip broker intermediaries.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #F0C4C4;border-left:none;vertical-align:top;border-top:none;color:#1C1917;border-radius:0 0 10px 0">
<span style="font-size:15px;font-weight:800;color:#7F1616">💳 Pay only for results</span><br>
<span style="font-size:12px;color:#57534E">Billed per listing returned. Empty or blocked runs cost nothing.</span>
</td>
</tr>
</table>

**Get structured Chinese real estate listings (price, area, layout, compound, and contact type) ready for your spreadsheet in seconds.** Pull property titles, standardized CNY prices, room layouts, and district locations for 13 major Chinese cities.

***

### 👥 What can you do with it?

- **I am an international property investor** comparing resale prices across Beijing and Shanghai compounds to find undervalued listings.
- **I am a market researcher** tracking rental prices per square meter across Chinese tech hubs like Shenzhen, Guangzhou, and Hangzhou.
- **I am a lead-gen agency** sourcing direct landlord listings and contact details so my clients can skip broker intermediation.

***

### 🚀 How to use it

<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0">
<tr>
<td style="padding:16px 14px;width:33%;background:#FBEAEA;border:1px solid #F0C4C4;border-radius:10px 0 0 10px;vertical-align:top;color:#1C1917">
<span style="font-size:12px;font-weight:800;color:#A61C1C;letter-spacing:1px">STEP 1</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Choose your city and category</span><br>
<span style="font-size:12px;color:#57534E">Pick a city, for-sale or rental, plus an optional keyword.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#FBEAEA;border:1px solid #F0C4C4;border-left:none;vertical-align:top;color:#1C1917">
<span style="font-size:12px;font-weight:800;color:#A61C1C;letter-spacing:1px">STEP 2</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Run the Actor</span><br>
<span style="font-size:12px;color:#57534E">It fetches the live listing page and extracts structured fields.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#FBEAEA;border:1px solid #F0C4C4;border-left:none;border-radius:0 10px 10px 0;vertical-align:top;color:#1C1917">
<span style="font-size:12px;font-weight:800;color:#A61C1C;letter-spacing:1px">STEP 3</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Export your data</span><br>
<span style="font-size:12px;color:#57534E">Download the dataset as JSON, CSV, or Excel.</span>
</td>
</tr>
</table>

### ⚙️ Input

| Field | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| `city` | enum | Yes | Target city: Beijing (`bj`), Shanghai (`sh`), Shenzhen (`sz`), Guangzhou (`gz`), Hangzhou (`hz`), Chengdu (`cd`), Wuhan (`wh`), Nanjing (`nj`), Xi'an (`xa`), Suzhou (`su`), Chongqing (`cq`), Tianjin (`tj`), or Changsha (`cs`). |
| `category` | enum | Yes | `ershoufang` (for-sale / 二手房) or `chuzu` (rentals / 租房). |
| `keyword` | string | No | Optional search term, such as a compound name, district, or subway line, in Chinese. |
| `onlyLandlord` | boolean | No | If enabled, filters out brokers and agencies and keeps direct owner listings only. |
| `decryptNumbers` | boolean | No | Reserved for a future release. Prices and areas already return in plain, readable form. |
| `solveCaptcha` | boolean | No | Reserved for a future release. If 58.com blocks a request with a CAPTCHA, the Actor currently skips that page safely instead of returning blocked content. |
| `maxItems` | integer | No | Maximum number of listings to extract from the page. |
| `proxyConfiguration` | object | No | Proxy settings. Residential proxies are recommended for reliable access from outside mainland China. |

***

### 📦 Output

Each row is a single property listing from 58.com.

```json
{
  "id": "578414171",
  "category": "ershoufang",
  "url": "https://m.58.com/bj/ershoufang/578414171x.shtml",
  "title": "望京西园 经典三居室 南北通透",
  "scrapedAt": "2026-10-04T09:00:00.000Z",
  "priceTotal": 4800000,
  "priceRaw": "480万",
  "currency": "CNY",
  "areaSqm": 96.38,
  "rooms": 3,
  "halls": 2,
  "bathrooms": 1,
  "orientation": "南北",
  "communityName": "望京西园",
  "district": "朝阳",
  "businessArea": "望京",
  "address": "Beijing City, 朝阳 District, 望京, 望京西园",
  "contactType": "Landlord",
  "brokerName": "张先生",
  "brokerCompany": "",
  "captchaEncountered": false
}
```

#### Field Reference

| Field | Type | Description |
| :--- | :--- | :--- |
| `id` | string | Unique identifier of the listing. |
| `category` | string | `ershoufang` (for-sale) or `chuzu` (rental). |
| `url` | string | Direct link to the listing on 58.com. |
| `title` | string | Listing title as shown on 58.com. |
| `postedDate` | string | Timestamp recorded when the listing was scraped, not 58.com's original posting date. |
| `scrapedAt` | string | Timestamp when this row was collected. |
| `priceTotal` | number | Standardized price in CNY: total sale price, or monthly rent for rentals. |
| `priceUnit` | number | Price per square meter in CNY, when 58.com publishes it on the listing card. |
| `priceRaw` | string | Price exactly as shown on 58.com (e.g. `480万` or `3200元/月`). |
| `currency` | string | Always `CNY`. |
| `areaSqm` | number | Floor area in square meters. |
| `rooms` | integer | Number of bedrooms. |
| `halls` | integer | Number of living/dining rooms. |
| `bathrooms` | integer | Number of bathrooms. Inferred from the listing text when not explicitly stated. |
| `floorLevel` | string | Floor level label. Not yet distinguished per listing in this version. |
| `buildYear` | string | Building completion year. Not yet distinguished per listing in this version. |
| `fitment` / `fitmentEn` | string | Interior finish level, in Chinese and English. Not yet distinguished per listing in this version. |
| `orientation` | string | Facing direction (e.g. `南北` for south-north). |
| `communityName` | string | Name of the residential compound. |
| `district` | string | City district. |
| `businessArea` | string | Local business or neighborhood area. |
| `address` | string | Assembled city, district, and compound address. |
| `latitude` / `longitude` | number | Approximate city-level coordinates. Not yet precise per listing in this version. |
| `contactType` | string | `Broker` or `Landlord`. |
| `brokerName` | string | Name of the broker or listing contact, when shown. |
| `brokerCompany` | string | Agency name, when the listing is broker-managed. |
| `captchaEncountered` | boolean | True if 58.com served a CAPTCHA or block page for this request. |

***

### 💰 Pricing & Cost

Pricing is pay-per-result and billed only for listings successfully saved to your dataset. Empty runs and CAPTCHA-blocked pages cost nothing.

- Rates are tiered by your Apify plan: higher plans get a lower cost per listing.
- No fixed monthly subscriptions or hidden maintenance fees.
- See the Pricing tab on this Actor's Store page for the exact current rate on your plan.

***

### ⭐ Enjoying 58.com Scraper?

<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0">
<tr>
<td style="padding:20px 24px 14px;background:#FBEAEA;border:1px solid #FBEAEA;border-left:5px solid #A61C1C;border-radius:10px 10px 0 0;color:#1C1917">
<span style="font-size:20px;letter-spacing:4px">⭐ ⭐ ⭐ ⭐ ⭐</span><br>
<span style="font-size:17px;font-weight:800;color:#1C1917">Structured CNY prices and direct landlord contacts from 58.com, without parsing raw HTML yourself.</span><br>
<span style="font-size:14px;color:#57534E">A 5-star rating takes 10 seconds and helps other property investors and China market researchers find it. Your feedback also tells us what to build next.</span>
</td>
</tr>
<tr>
<td style="padding:0;background:#A61C1C;border:1px solid #A61C1C;border-left:5px solid #A61C1C;border-top:none;border-radius:0 0 10px 10px;text-align:center;color:#FFFFFF">
<a href="https://apify.com/getascraper/58-classifieds-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>

***

### 💡 Tips & Best Practices

- **Use a keyword for focused results.** Since each run reads the current listing page for your chosen city and category, a keyword (compound name, district, or subway line) narrows results to what matters for your search.
- **Filter to direct landlords when sourcing leads.** Enable `onlyLandlord` to skip brokers and agencies and keep private-owner listings only.
- **Use residential proxies from outside mainland China.** 58.com can restrict traffic from outside China. The default proxy configuration uses Apify's residential proxy group for reliable access.
- **Re-run on a schedule to track price changes.** Since listings refresh frequently on 58.com, scheduling repeat runs for the same city, category, and keyword lets you spot new listings and price moves over time.

***

### ❓ FAQ

##### Does it get blocked by 58.com?

The Actor uses Apify's residential proxies by default to reduce blocking. If 58.com still serves a CAPTCHA or block page for a request, the Actor detects it, skips that page, and flags it in the output (`captchaEncountered: true`) instead of returning blocked content.

##### Does it extract private phone numbers?

No. 58.com protects landlord and broker phone numbers behind click-walls and SMS verification. The Actor returns seller names, compound names, and listing details instead.

##### How fresh is the data?

Each run fetches the current listing page directly from 58.com at run time, so results reflect what is live on the site at that moment for your chosen city, category, and keyword.

##### Are all categories supported?

The Actor covers both major 58.com real estate categories: `ershoufang` (for-sale / 二手房) and `chuzu` (rentals / 租房). Other 58.com classifieds categories (jobs, used cars, electronics) are not covered.

***

### 🔑 Target SEO Keywords

- 58.com scraper
- scrape 58.com
- China real estate scraper
- Chinese property data
- Beijing rental scraper
- Shanghai second-hand home data

***

### 🛡️ Disclaimers & Support

- **Disclaimer:** This Actor retrieves publicly available classified property listings on 58.com. Make sure your usage complies with 58.com's terms of service and applicable laws.
- **Support:** Open an issue from the Actor page in the Apify Console for bug reports or feature requests.

### 🔗 Other actors

- [Lianjia Scraper](https://apify.com/getascraper/lianjia-real-estate-scraper) ↗ - extracts resale property listings, prices, and community details across China.
- [Etagi Real Estate Scraper](https://apify.com/getascraper/etagi-property-scraper) ↗ - collects property listings and pricing from Etagi in Russia.
- [Yandex Realty Scraper](https://apify.com/getascraper/yandex-realty-scraper) ↗ - extracts property listings and prices from Yandex Realty in Russia.
- [Property24 Scraper](https://apify.com/getascraper/property24-scraper) ↗ - pulls property listings and agent details across nine African markets.
- [CommercialRealEstate.com.au Scraper](https://apify.com/getascraper/commercialrealestate-au-scraper) ↗ - collects commercial property prices and agent details in Australia.

# Actor input Schema

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

Select the target city.

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

Select the vertical category to scrape.

## `keyword` (type: `string`):

Optional keyword to search for specific districts, compound names, or subways.

## `onlyLandlord` (type: `boolean`):

If enabled, we automatically filter out brokers and agencies to extract landlord-listed properties only.

## `decryptNumbers` (type: `boolean`):

If enabled, decodes obfuscated numeric prices and area sizes.

## `solveCaptcha` (type: `boolean`):

If enabled, automatically solves sliding puzzle checks locally with template matching.

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

The maximum number of listings to extract.

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

Proxy settings. Premium rotating residential proxies are recommended.

## Actor input object example

```json
{
  "city": "bj",
  "category": "ershoufang",
  "keyword": "望京",
  "onlyLandlord": false,
  "decryptNumbers": true,
  "solveCaptcha": true,
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 = {
    "city": "bj",
    "category": "ershoufang",
    "keyword": "望京",
    "onlyLandlord": false,
    "decryptNumbers": true,
    "solveCaptcha": true,
    "maxItems": 100,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/58-classifieds-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": "bj",
    "category": "ershoufang",
    "keyword": "望京",
    "onlyLandlord": False,
    "decryptNumbers": True,
    "solveCaptcha": True,
    "maxItems": 100,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/58-classifieds-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 '{
  "city": "bj",
  "category": "ershoufang",
  "keyword": "望京",
  "onlyLandlord": false,
  "decryptNumbers": true,
  "solveCaptcha": true,
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call getascraper/58-classifieds-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/58-classifieds-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/dpxoaa5Q9WkJKmZ1g/builds/xwTtiTpBWKe3kS7je/openapi.json