Anjuke APIbeijing.anjuke.com ↗
Access Beijing rental listings, house price index, community search, and agent data from Anjuke via 4 structured API endpoints.
What is the Anjuke API?
The Beijing Anjuke API exposes 4 endpoints covering rental property listings, housing price trend data, community autocomplete search, and agent profiles from beijing.anjuke.com. The search_rental_listings endpoint alone returns up to 60 listings per page, each with price, specs, community name, address, and a direct listing URL. Price index data includes daily, weekly, and monthly history arrays alongside year-over-year change percentages.
curl -X GET 'https://api.parse.bot/scraper/cb9bb724-0512-4ccb-aef4-2615cefb5873/search_rental_listings?page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Search rental property listings in Beijing. Returns one page of up to 60 listings, each with id, title, specs (rooms/area/floor), community name, address, tags, price (with unit, e.g. '2500元/月') and listing URL. The optional district filter narrows results to one district by its pinyin path segment; page selects the result page and defaults to 1. Each call walks the site's own navigation (homepage, then the rental list) before reading the requested page, so a call costs two to three round trips. When the site presents its visitor-verification gate for the current network route the call returns a blocked envelope and is retried automatically rather than returning partial data.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number, 1-based; each page holds up to 60 listings. |
| district | string | District filter as pinyin path segment (e.g. 'chaoyang', 'haidian', 'changping'). Omit to return listings across all Beijing districts. |
{
"type": "object",
"fields": {
"page": "string page number",
"rentals": "array of rental listing objects with id, title, specs, community, address, tags, price, url"
},
"sample": {
"data": {
"page": "1",
"rentals": [
{
"id": "4495126106858504",
"url": "https://bj.zu.anjuke.com/fangyuan/4495126106858504",
"tags": [
"合租",
"朝南",
"8/13/18号线"
],
"price": "1900元/月",
"specs": "3室1厅|10平米|高层(共6层)",
"title": "8号线育知路地铁 骊龙园精装朝南落地三窗大主卧",
"address": "骊龙园昌平-回龙观-育知西路",
"community": "骊龙园"
}
]
},
"status": "success"
}
}About the Anjuke API
Rental Listings
The search_rental_listings endpoint returns paginated rental properties across Beijing. Each listing object includes an id, title, specs (rooms, area, floor), community, address, tags, price (formatted as a string like '2500元/月'), and url. You can narrow results to a specific district by passing the district parameter as a pinyin slug — for example 'chaoyang', 'haidian', or 'changping'. Pagination is 1-based via the page parameter, with up to 60 listings per page.
House Price Index
get_beijing_house_price_index takes no inputs and returns a data object structured around priceInfo (current average price per square meter, monthly and yearly change percentages), priceTrend arrays (daily, weekly, and monthly history), xinfangPriceInfo (new housing metrics), and evaluateInfo. The status field returns '0' on success. This endpoint covers the whole Beijing market and does not break down by district.
Community Search and Agents
search_listings_by_community accepts a Chinese-character query string and returns matching communities, sub-areas, and subway stations. Each result carries id, name, type (1=district area, 2=sub-area, 3=subway station, 4=community), areaId, areaName, price (average price per sqm), and address. The search_agents endpoint returns a list of agent objects, each with name, company, tags (specialty labels), and url (profile link). Neither endpoint accepts filter parameters at this time.
The Anjuke API is a managed, monitored endpoint for beijing.anjuke.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when beijing.anjuke.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official beijing.anjuke.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track Beijing rental market prices over time using the monthly price history from
get_beijing_house_price_index - Build a district-level rental search tool using the
districtparameter insearch_rental_listings - Populate an autocomplete field for community or subway station names using
search_listings_by_community - Aggregate average price-per-sqm data by community type using the
typeandpricefields from community search results - Compile a directory of Beijing real estate agents with their company affiliations and specialty tags from
search_agents - Monitor year-over-year and month-over-month price changes in Beijing residential property via
priceInfofields
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Anjuke offer an official developer API?+
What does the house price index endpoint return, and does it break down by district?+
get_beijing_house_price_index endpoint returns city-wide data only: current average price per square meter, monthly and yearly change percentages, and historical price arrays (daily, weekly, monthly) in the priceTrend field. District-level breakdowns are not covered by this endpoint. You can fork the API on Parse and revise it to add a district-scoped price index endpoint.Can I retrieve second-hand (existing home) sale listings, not just rentals?+
search_rental_listings and community-level pricing via search_listings_by_community. Second-hand home sale listings are not exposed as a dedicated endpoint. You can fork the API on Parse and revise it to add a second-hand listing search endpoint.What do the `type` values in community search results mean?+
type field in search_listings_by_community results distinguishes four kinds of matches: 1 is a district area, 2 is a sub-area, 3 is a subway station, and 4 is a specific residential community. The price field on each result reflects the average price per square meter for that area or community.Does the `search_agents` endpoint support filtering by district or specialty?+
search_agents returns a general list of agents with name, company, tags, and url fields. Filtering by district, specialty, or other criteria is not currently supported. You can fork the API on Parse and revise it to add filter parameters to the agent search endpoint.