Anjuke 安居客
China's largest property portal: resale homes, rentals, new-home projects, residential communities and monthly price history, city by city.
/anjuke/v1/cities2 creditsEvery city anjuke.com serves (737 measured), with pinyin, short alias, hot-city flag and the 5 cities whose only anjuke host is the new-home site.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Optional filter on name, pinyin or alias (contains). |
/anjuke/v1/city_filters2 creditsThe city's own search vocabulary: districts with their areas (ids, slugs, coordinates), metro lines with stations, price / size buckets, room counts, use types, orientations, property types.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| city | required | — | City: pinyin (shanghai), short alias (sh) or Chinese name (上海). The 'cities' action lists all 737. |
/anjuke/v1/sale_search3 creditsResale homes (二手房) for sale in a city, with every filter the site offers: district, area, metro line / station, total price range (万元), size range, rooms, building age, fitment, floor, use type, orientation, property type, features, community, keyword, and sort. Up to 60 listings per page; the site serves at most 1,850 listings per filter set.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| city | required | — | City: pinyin (shanghai), short alias (sh) or Chinese name (上海). The 'cities' action lists all 737. |
| district | optional | — | District (区): Chinese name (浦东 / 浦东区), slug (pudong) or id from city_filters. |
| area | optional | — | Area / business circle (板块, 商圈) inside the city: Chinese name, slug or id from city_filters. |
| metro_line | optional | — | Metro line: name (2号线) or id from city_filters. |
| metro_station | optional | — | Metro station: name or id (give metro_line too when the name repeats). |
| price_min | optional | — | Minimum total price in 万元 (10,000 CNY). |
| price_max | optional | — | Maximum total price in 万元 (10,000 CNY). |
| area_min | optional | — | Minimum floor area, m². |
| area_max | optional | — | Maximum floor area, m². |
| rooms | optional | — | Bedrooms: one or more of 1-6 (6 = 五室以上). |
| house_age | optional | under_2 · 2_5 · 5_10 · over_10 | Building age in years. |
| fitment | optional | rough · simple · fine · luxury | Fitment: rough 毛坯, simple 普通装修, fine 精装修, luxury 豪华装修. |
| floor | optional | low · middle · high | Floor: low (≤5), middle (6-12), high (13+). |
| use_type | optional | — | Use type name or id from city_filters.use_types (普通住宅, 公寓, 别墅, 老公房 …). |
| orientation | optional | — | Orientation name or id from city_filters.orientations. |
| property_type | optional | — | Property type name or id from city_filters.property_types. |
| features | optional | — | One or more of: near_metro (近地铁), urgent_sale (房东急售). |
| community_id | optional | — | Only listings in this community (小区) id — the community's own resale list. |
| keyword | optional | — | Free text the site matches against community / area / district names. |
| sort = default | optional | default · price_asc · price_desc · area_desc · area_asc | default, price_asc (rows without a price come first, as on the site), price_desc, area_desc, area_asc. |
| page = 1 | optional | 1–200 | Page number, 1-based. |
| page_size = 60 | optional | 1–60 | Listings per page, 1-60. |
/anjuke/v1/sale_detail1 creditOne resale listing: price (total + per m²), layout, size, floor, orientation, fitment, year, use type, description, photos, floor plans, down payment and monthly payment, verification code, community (address, coordinates, metro, average price) and the listing agent (name, company, store).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| listing_id | required | — | Listing id from sale_search (S-prefix and full URLs accepted). |
| city | required | — | City of the listing (pinyin, alias or Chinese name) — the site looks a listing up inside its city. |
/anjuke/v1/suggest1 creditThe site's own autocomplete: communities matching a few characters, with district, address, aliases and current average price.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| city | required | — | City: pinyin (shanghai), short alias (sh) or Chinese name (上海). The 'cities' action lists all 737. |
| keyword | required | — | Characters to complete (Chinese or pinyin). |
/anjuke/v1/community_search2 creditscommunities (小区) in a city with average listing price, listings for sale / rent, households, property company and fee, green ratio and the site's scores. Filter by district, area, keyword; sort by price or building year. Up to 50 per page; the site serves at most 3,500 communities per filter set.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| city | required | — | City: pinyin (shanghai), short alias (sh) or Chinese name (上海). The 'cities' action lists all 737. |
| district | optional | — | District (区): Chinese name (浦东 / 浦东区), slug (pudong) or id from city_filters. |
| area | optional | — | Area / business circle (板块, 商圈) inside the city: Chinese name, slug or id from city_filters. |
| keyword | optional | — | Community name text. |
| sort = default | optional | default · price_asc · price_desc · built_oldest · built_newest | default (site popularity), price_asc, price_desc, built_oldest, built_newest. |
| page = 1 | optional | 1–200 | Page number, 1-based. |
| page_size = 25 | optional | 1–50 | Communities per page, 1-50 (25 = the site's own page). |
/anjuke/v1/community_detail2 creditsOne community page: developer, property company and fee, plot and green ratio, households, parking and fee, completion year, land-use period, average price, listings counts, scores, the site's written evaluation, photos, sample listings, brokers and resident comments.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| city | required | — | City: pinyin (shanghai), short alias (sh) or Chinese name (上海). The 'cities' action lists all 737. |
| community_id | required | — | Community id (from community_search, suggest or a listing). |
/anjuke/v1/rent_search2 creditsRental listings (租房) in a city: district, area, monthly rent range, rooms, whole / shared, agent / owner. 30 per page by default (up to 60); the site serves at most 3,480 rentals per filter set.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| city | required | — | City: pinyin (shanghai), short alias (sh) or Chinese name (上海). The 'cities' action lists all 737. |
| district | optional | — | District (区): Chinese name (浦东 / 浦东区), slug (pudong) or id from city_filters. |
| area | optional | — | Area / business circle (板块, 商圈) inside the city: Chinese name, slug or id from city_filters. |
| rent_min | optional | — | Minimum monthly rent, CNY. |
| rent_max | optional | — | Maximum monthly rent, CNY. |
| rooms | optional | 1–6 | Bedrooms (1-6). |
| rent_type | optional | whole · shared | whole 整租 or shared 合租. |
| source | optional | agent · owner | agent-listed or owner-listed (个人房源). |
| page = 1 | optional | 1–200 | Page number, 1-based. |
| page_size = 30 | optional | 1–60 | Listings per page, 1-60. |
/anjuke/v1/rent_detail2 creditsOne rental listing: rent, payment terms (押一付三 …), agency and service fee, layout, size, floor, orientation, fitment, amenities, description, metro distance, community, coordinates, photos and the listing agent.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| city | required | — | City: pinyin (shanghai), short alias (sh) or Chinese name (上海). The 'cities' action lists all 737. |
| rental_id | required | — | Rental id (rent_search id). |
/anjuke/v1/new_home_search2 creditsNew-home projects (新房 / 楼盘): sale status, price per m², Anjuke's reference price, size range, layouts, tags, metro, sales hotline. Filter by district, status, rooms, size, property type, fitment, features; sort by price or opening date.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| city | required | — | City: pinyin (shanghai), short alias (sh) or Chinese name (上海). The 'cities' action lists all 737. |
| district | optional | — | District (区): Chinese name (浦东 / 浦东区), slug (pudong) or id from city_filters. |
| status | optional | on_sale · pending · sold_out · tail · new_permit · registering · registration_soon · subscribing · subscription_soon · lottery_soon · for_rent | on_sale 在售, pending 待售, sold_out 售罄, tail 尾盘, new_permit 最新取证, registering 登记中, registration_soon 即将登记, subscribing 认购中, subscription_soon 即将认购, lottery_soon 即将摇号, for_rent 在租. |
| rooms | optional | — | Bedrooms: one or more of 1-5. |
| size | optional | under_70 · 70_90 · 90_120 · 120_140 · 140_160 · 160_200 · over_200 | Unit size bucket, m². |
| property_type | optional | residential · villa · commercial_office · shop · office | residential 住宅, villa 别墅, commercial_office 商办, shop 商铺, office 写字楼. |
| fitment | optional | rough · simple · decorated | rough 毛坯, simple 简装修, decorated 带装修. |
| opening | optional | this_month · next_month · next_3_months · last_month · opened | Opening date: this_month, next_month, next_3_months, last_month, opened. |
| delivery | optional | ready · within_1_month · within_3_months · within_6_months | Delivery: ready 现房, within_1_month, within_3_months, within_6_months. |
| features | optional | — | Any of: brand_developer, near_metro, parking, near_school, state_owned, popular, vr (a project matching ANY is returned). |
| sort = default | optional | default · price_asc · price_desc · opening_desc | default, price_asc, price_desc, opening_desc. |
| page = 1 | optional | 1–200 | Page number, 1-based. |
| page_size = 20 | optional | 1–50 | Projects per page, 1-50. |
/anjuke/v1/new_home_detail3 creditsOne new-home project page: prices (reference and total from), size range, opening and delivery dates, address, tags, rankings, sales hotline, layouts with prices, buildings (units, floors, households), sales advisers, photos.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| city | required | — | City: pinyin (shanghai), short alias (sh) or Chinese name (上海). The 'cities' action lists all 737. |
| project_id | required | — | Project id (new_home_search id). |
/anjuke/v1/new_home_specs3 creditsThe project's full specification sheet (楼盘详情): developer, former names, property type, sale status, permits, plot ratio, green ratio, households, property company and fee, parking, rights term, coordinates — every row the site publishes, grouped as on the page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| city | required | — | City: pinyin (shanghai), short alias (sh) or Chinese name (上海). The 'cities' action lists all 737. |
| project_id | required | — | Project id. |
/anjuke/v1/new_home_reviews1 creditBuyer reviews of a new-home project: the total review count and the reviews the project page embeds (at most 2 measured on 22 projects; author, text, date, likes, replies). A project id that does not exist answers like a project with no reviews (total 0).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| city | required | — | City: pinyin (shanghai), short alias (sh) or Chinese name (上海). The 'cities' action lists all 737. |
| project_id | required | — | Project id. |
/anjuke/v1/price_trend2 creditsThe site's own average resale price (元/m²) history for a city, a district, an area or one community, month by month as anjuke.com publishes it on its price page (the latest months of the current year and Aug-Dec of each past year back to 2010 for cities).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| city | required | — | City: pinyin (shanghai), short alias (sh) or Chinese name (上海). The 'cities' action lists all 737. |
| district | optional | — | District (区): Chinese name (浦东 / 浦东区), slug (pudong) or id from city_filters. |
| area | optional | — | Area / business circle (板块, 商圈) inside the city: Chinese name, slug or id from city_filters. |
| community_id | optional | — | Community id for a single community's history. |
curl -X POST https://api.reefapi.com/anjuke/v1/cities \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"苏州"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.