{ "openapi": "3.0.1", "info": { "title": "Fang 房天下 New-Home Scraper: China 楼盘 Prices, Sales & Developers", "description": "Scrape 房天下 (Fang) 新房 new-home 楼盘 projects across 97 Chinese cities: price per sqm, total price, sales status, layouts, developer, opening dates, sales progress and coordinates. Filter by district, price, type and bedrooms, or track price changes. From $3 per 1,000 projects.", "version": "0.1", "x-build-id": "Nx2e86RqIU79sch7A" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~fang-new-property-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-fang-new-property-listings-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/getascraper~fang-new-property-listings-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-fang-new-property-listings-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/getascraper~fang-new-property-listings-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-fang-new-property-listings-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": { "cities": { "title": "Cities", "type": "array", "description": "Pick one or more Chinese cities. Each city is searched separately and the results are combined. Ignored when you paste search URLs below.", "items": { "type": "string", "enum": [ "bj", "sh", "gz", "sz", "wuhan", "cq", "cs", "xian", "nb", "taiyuan", "qd", "tj", "hz", "sy", "cd", "nanjing", "suzhou", "jn", "km", "wuxi", "zh", "nn", "zz", "dg", "hf", "gy", "bt", "bd", "bh", "changde", "cz", "chuzhou", "changchun", "dl", "fangchenggang", "fs", "fz", "ganzhou", "guilin", "hrb", "hn", "hs", "nm", "huangshi", "huizhou", "jl", "jining", "jx", "jm", "jh", "jiujiang", "ks", "lz", "lf", "leshan", "lyg", "linyi", "liuzhou", "luzhou", "ly", "meizhou", "mianyang", "nc", "nanchong", "nt", "qhd", "qingyuan", "qingyang", "qz", "sanya", "st", "sx", "sjz", "tz", "taizhou", "ts", "weihai", "wf", "wz", "xj", "wuhu", "xn", "xm", "xz", "yt", "yancheng", "yz", "yc", "yinchuan", "yueyang", "hbzy", "zj", "zhangzhou", "zhenjiang", "zs", "zhoushan", "zb" ], "enumTitles": [ "北京 (bj)", "上海 (sh)", "广州 (gz)", "深圳 (sz)", "武汉 (wuhan)", "重庆 (cq)", "长沙 (cs)", "西安 (xian)", "宁波 (nb)", "太原 (taiyuan)", "青岛 (qd)", "天津 (tj)", "杭州 (hz)", "沈阳 (sy)", "成都 (cd)", "南京 (nanjing)", "苏州 (suzhou)", "济南 (jn)", "昆明 (km)", "无锡 (wuxi)", "珠海 (zh)", "南宁 (nn)", "郑州 (zz)", "东莞 (dg)", "合肥 (hf)", "贵阳 (gy)", "包头 (bt)", "保定 (bd)", "北海 (bh)", "常德 (changde)", "常州 (cz)", "滁州 (chuzhou)", "长春 (changchun)", "大连 (dl)", "防城港 (fangchenggang)", "佛山 (fs)", "福州 (fz)", "赣州 (ganzhou)", "桂林 (guilin)", "哈尔滨 (hrb)", "海南 (hn)", "衡水 (hs)", "呼和浩特 (nm)", "黄石 (huangshi)", "惠州 (huizhou)", "吉林 (jl)", "济宁 (jining)", "嘉兴 (jx)", "江门 (jm)", "金华 (jh)", "九江 (jiujiang)", "昆山 (ks)", "兰州 (lz)", "廊坊 (lf)", "乐山 (leshan)", "连云港 (lyg)", "临沂 (linyi)", "柳州 (liuzhou)", "泸州 (luzhou)", "洛阳 (ly)", "梅州 (meizhou)", "绵阳 (mianyang)", "南昌 (nc)", "南充 (nanchong)", "南通 (nt)", "秦皇岛 (qhd)", "清远 (qingyuan)", "庆阳 (qingyang)", "泉州 (qz)", "三亚 (sanya)", "汕头 (st)", "绍兴 (sx)", "石家庄 (sjz)", "台州 (tz)", "泰州 (taizhou)", "唐山 (ts)", "威海 (weihai)", "潍坊 (wf)", "温州 (wz)", "乌鲁木齐 (xj)", "芜湖 (wuhu)", "西宁 (xn)", "厦门 (xm)", "徐州 (xz)", "烟台 (yt)", "盐城 (yancheng)", "扬州 (yz)", "宜昌 (yc)", "银川 (yinchuan)", "岳阳 (yueyang)", "枣阳 (hbzy)", "湛江 (zj)", "漳州 (zhangzhou)", "镇江 (zhenjiang)", "中山 (zs)", "舟山 (zhoushan)", "淄博 (zb)" ] }, "default": [ "bj" ] }, "districts": { "title": "Districts", "type": "array", "description": "Optional district names inside the chosen cities, for example 朝阳, 海淀 or Pudong style pinyin codes. Names are matched against the city page. Each district is searched on its own.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Fang search URLs", "type": "array", "description": "Optional new-property search pages from newhouse.fang.com (for example a page you filtered in your browser). When set, these are scraped instead of the cities above.", "items": { "type": "object", "properties": { "url": { "type": "string", "title": "URL", "description": "A Fang new-property search page." } }, "required": [ "url" ] }, "default": [] }, "unitPriceMin": { "title": "Minimum unit price (CNY per sqm)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only projects with a published price per square metre at or above this value." }, "unitPriceMax": { "title": "Maximum unit price (CNY per sqm)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only projects with a published price per square metre at or below this value." }, "propertyType": { "title": "Property type", "enum": [ "any", "residential", "villa", "office", "shop", "commercial" ], "type": "string", "description": "Kind of property to include.", "default": "any" }, "saleStatus": { "title": "Sales status", "enum": [ "any", "onSale", "upcoming", "soldOut" ], "type": "string", "description": "Whether the project is selling now, about to sell, or already sold out.", "default": "any" }, "layouts": { "title": "Bedrooms", "type": "array", "description": "Keep projects that offer at least one of these bedroom counts. 5 means five bedrooms or more.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 bedroom", "2 bedrooms", "3 bedrooms", "4 bedrooms", "5+ bedrooms" ] }, "default": [] }, "areaMin": { "title": "Minimum home size (sqm)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Keep projects whose unit sizes reach at least this area." }, "areaMax": { "title": "Maximum home size (sqm)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Keep projects that offer units no larger than this area." }, "nameKeyword": { "title": "Project name contains", "type": "string", "description": "Only projects whose name contains this text, for example 保利 or a developer brand shown in the project name." }, "featureTags": { "title": "Feature tags", "type": "array", "description": "Keep projects that carry any of these labels, for example 地铁沿线, 装修交付, 低总价, 品牌地产.", "default": [], "items": { "type": "string" } }, "developerKeyword": { "title": "Developer contains", "type": "string", "description": "Only projects whose developer company name contains this text. Turns on project details automatically, so each project costs extra page loads." }, "openingFrom": { "title": "Opening date from", "type": "string", "description": "Only projects opening for sale on or after this date. Turns on project details automatically." }, "openingTo": { "title": "Opening date to", "type": "string", "description": "Only projects opening for sale on or before this date. Turns on project details automatically." }, "sort": { "title": "Sort order", "enum": [ "default", "priceAsc", "priceDesc", "reviews", "openingDate" ], "type": "string", "description": "How Fang orders the results before the limits are applied.", "default": "default" }, "includeProjectDetails": { "title": "Add project details", "type": "boolean", "description": "Adds developer, opening and handover dates, decoration, land use term, plot ratio, greening, parking, property company and fee, and presale permit. One extra page load per project.", "default": false }, "includeSalesAndLayouts": { "title": "Add sales progress, layouts and coordinates", "type": "boolean", "description": "Adds units permitted, signed and available with sell-through, main layouts with size and price, latitude and longitude, ratings, and district price context. One extra page load per project.", "default": false }, "monitorMode": { "title": "Monitoring", "enum": [ "off", "changes" ], "type": "string", "description": "Choose \"Track changes\" to compare this run with the previous run of the same scope and label each project as new, price down, price up, status changed or removed.", "default": "off" }, "monitorScope": { "title": "Monitoring scope name", "type": "string", "description": "A short name for this search. Runs that share a name share a saved snapshot. Leave empty to use an automatic name built from your cities and filters." }, "includeUnchanged": { "title": "Include unchanged projects", "type": "boolean", "description": "In monitoring mode, also return projects that did not change. Off keeps only new and changed projects.", "default": false }, "maxItems": { "title": "Maximum projects", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many projects have been returned in total.", "default": 10 }, "maxPages": { "title": "Maximum result pages per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Each Fang result page holds 20 projects. Raise it together with Maximum projects to collect more.", "default": 1 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Connection used to reach Fang. The default connects directly and switches to an alternative route if the site refuses.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }